ניהול תוויות CSS

שירותי השוואת מחירים (CSS) יכולים להציג ב-Google מודעות שופינג בשם מוכרים, במדינות שבהן התוכנית של שירותי CSS זמינה. ‫Content API מאפשר לדומיינים של CSS ולקבוצות CSS לארגן את החשבונות המשויכים שלהם באמצעות תוויות. בדומיינים של שירותי CSS אפשר לרשום, לתייג ולסנן את חשבונות Merchant Center שמשויכים לדומיין. קבוצות CSS יכולות להוסיף תוויות לדומיינים של CSS שמשויכים לקבוצה ולפרט אותם. שירותי Content API האלה מספקים מקבילות תוכנתיות לחלק מהתכונות שזמינות ב-Comparison Shopping Service Center.

מידע נוסף על שירותי השוואת מחירים זמין כאן. מידע על עבודה עם תוויות ב-CSS Center זמין במאמר שימוש בתוויות חשבון ב-Comparison Shopping Service Center.

סוגי חשבונות CSS

פלטפורמות CSS משתמשות בשלושה סוגים של חשבונות:

  • קבוצות CSS הן חשבונות ברמה העליונה שיכולים להכיל דומיין CSS אחד או יותר.
  • דומיינים של שירותי CSS הם החשבונות של שירותי ה-CSS עצמם, שמציגים מודעות שופינג בשם המוכרים. כל דומיין CSS יכול להשתייך רק לקבוצת CSS אחת.
  • חשבונות Merchant Center הם החשבונות של המוכרים שדומיינים של שירותי CSS מפרסמים עבורם מודעות שופינג. אפשר לשייך שירותי CSS לכמה סוגים שונים של חשבונות Merchant Center, כולל חשבונות מרובי לקוחות (MCA) וחשבונות מוכרים פרטיים. כל חשבון Merchant Center יכול להיות משויך רק לדומיין CSS אחד. מידע נוסף על סוגים שונים של חשבונות Merchant Center זמין במאמר סוגי חשבונות ב-Comparison Shopping Service Center.

סוגי תוויות CSS

יש שני סוגים של תוויות בשירותי CSS:

  • תוויות ידניות נוצרות ומוקצות לחשבונות Merchant Center על ידי דומיינים של CSS, ולדומיינים של CSS על ידי קבוצות CSS.
  • תוויות אוטומטיות נוצרות ומוקצות באופן אוטומטי לחשבונות Merchant Center על ידי CSS Center. תוויות אוטומטיות זמינות לסוגים שונים של מדדים ברמת החשבון, ויכולות לעזור לכם לזהות חשבונות חשובים ופעילות משמעותית בחשבון.

מידע נוסף על סוגי תוויות, כולל תוויות אוטומטיות זמינות, זמין במאמר בנושא שימוש בתוויות חשבון ב-Comparison Shopping Service Center.

פונקציות ונקודות קצה של Content API לשירותי השוואת מחירים

‫Content API מציע את נקודות הקצה הבאות לשירותי CSS:

כשמתקשרים לנקודות קצה של accounts כדומיין CSS, חשוב לשים לב לדרישות הבאות:

  • בדומיינים של שירותי CSS צריך לציין את cssId במקום merchantId.
  • בדומיינים של שירותי CSS צריך לציין פרמטר של שאילתה view=CSS.
  • בדומיינים של CSS צריך לספק את מזהה חשבון Merchant Center המשויך בתור הערך של התג accountId.

דוגמה: יצירת תווית

אפשר להשתמש בשיטה accounts.labels.create כדי ליצור תווית חדשה. אפשר להחיל תוויות על דומיינים של CSS ועל חשבונות Merchant Center. עם זאת, התוויות של סוגי החשבונות השונים הן נפרדות ואי אפשר להשתמש בהן לסירוגין. כדי ליצור תווית ברמת הדומיין שאפשר להחיל על חשבונות Merchant Center שמשויכים לדומיין, צריך להשתמש במספר הדומיין ב-CSS כ-accountId כשיוצרים את התווית. כדי ליצור תווית ברמת הקבוצה שאפשר להחיל על דומיינים של CSS שמשויכים לקבוצה, צריך להשתמש במזהה קבוצת ה-CSS בתור accountId כשיוצרים את התווית.

בדוגמה הבאה מוסבר איך ליצור תווית ברמת הדומיין של חשבונות מפתח, שאפשר להחיל אותה על חשבונות Merchant Center שמשויכים לדומיין. כדי ליצור את התווית, שולחים בקשת POST באמצעות כתובת ה-URL וגוף הבקשה הבאים:

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels
{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

דוגמה: איך מוסיפים תווית לחשבון Merchant Center

אפשר להשתמש בשיטה accounts.updatelabels כדי להקצות תוויות לחשבון Merchant Center שמשויך לדומיין CSS. בדוגמה הבאה מוצג אופן השימוש בתווית key-accounts שנוצרה בדוגמה הקודמת כדי לסמן אחד מהחשבונות החשובים ביותר שלכם ב-Merchant Center.

כדי להחיל את התווית, שולחים בקשת POST באמצעות כתובת ה-URL וגוף הבקשה הבאים:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
 "labelIds": [123] // ‘key-accounts’
}

דוגמה: שימוש בתוויות לסינון חשבונות Merchant Center

אחרי שיוצרים תוויות ומחילים אותן על חשבונות Merchant Center שמשויכים לדומיין CSS, אפשר להשתמש בשיטה accounts.list ולהעביר את פרמטר השאילתה של התווית בבקשה כדי לקבל בחזרה רק את החשבונות עם התווית הזו. בדוגמה הבאה מוסבר איך לסנן את חשבונות Merchant Center שמשויכים לדומיין CSS, באמצעות התוויות id (123) של התווית key-accounts שנוצרה בדוגמה יצירת תווית. כדי לאחזר את החשבונות, שולחים בקשת GET באמצעות כתובת ה-URL הבאה:

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

לא צריך גוף בקשה.

דוגמה: איך מחילים תווית על דומיין CSS

אפשר גם להשתמש בשיטה csses.updatelabels כדי להקצות תוויות לדומיין CSS שמשויך לקבוצת CSS. בדוגמה הבאה מוסבר איך להחיל תווית ברמת הקבוצה key-domains שנוצרה באמצעות השיטה accounts.labels.create על אחד מהחשבונות החשובים ביותר שלכם בדומיין CSS. חשוב לזכור שהתוויות של דומיינים של CSS ושל חשבונות Merchant Center הן נפרדות. תוויות ברמת הקבוצה צריכות להיווצר באמצעות מזהה קבוצת CSS בתור accountId.

כדי להחיל את התווית, שולחים בקשת POST באמצעות כתובת ה-URL וגוף הבקשה הבאים:

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
 "labelIds": [456] // ‘key-domains’
}