קולקציות של מוצרים

קולקציות של מוצרים מאפשרות להגדיר קבוצות של מוצרים לשימוש בפורמטים עשירים, כמו תמונות לקניית מוצרים ישירה. כל קולקציה יכולה לכלול עד 100 מוצרים. אפשר ליצור אוסף באמצעות Google Merchant Center או Content API.

במדריך הזה מוסבר איך להשתמש בקולקציות של מוצרים דרך Content API, כולל דוגמאות ליצירת קולקציה לתמונות לקניית מוצרים ישירה ולבדיקת הסטטוס של קולקציה.

שימוש בקולקציות מוצרים

‫Content API כולל שני שירותים לניהול קולקציות של מוצרים:

  • ‫collections: מאפשרת לקבל, לפרט, להוסיף ולמחוק אוספי מוצרים.

  • ‫collectionstatuses: מאפשר לקבל ולרשום את הסטטוס של אוספים כדי לגלות אם יש באוסף בעיות שעשויות לגרום לכך שהאוסף לא יהיה תקף ליעד, כמו מודעות שופינג.

דוגמה: יצירת קולקציה לתמונות לקניית מוצרים ישירה

תמונות לקניית מוצרים ישירה הן תמונות באיכות גבוהה שמציגות מוצר אחד או יותר עם הערות, והן מוגדרות באמצעות קולקציות. כדי להשתמש בתמונות לקניית מוצרים ישירה, צריך לציין ערכים בשדות imageLink ו-featuredProduct, בנוסף לשדות שנדרשים לכל הקולקציות. מידע נוסף על שדות חובה מופיע במאמרי העזרה של Content API.

כדי להשתמש בתמונות לקניית מוצרים ישירה, צריך ליצור קולקציית מוצרים ולהשתמש בשדה imageLink כדי לציין תמונה שמכילה עד עשרה מוצרים. מומלץ להשתמש בתמונות ריבועיות (עם יחס גובה-רוחב של 1:1).

בנוסף, צריך לציין את המוצרים שמוצגים בתמונה באמצעות השדה featuredProduct, כולל הקואורדינטות של המוצרים בתמונה באמצעות השדות x ו-y. השדות האלה נדרשים רק לקולקציות שמשמשות ליצירת תמונות לקניית מוצרים ישירה. הערכים x ו-y צריכים להיות בין 0 ל-1, כולל.

כל קולקציה יכולה לכלול עד 100 מוצרים. עם זאת, בתמונות לקניית מוצרים ישירה מומלץ לציין קואורדינטות של עד 10 מוצרים לכל תמונה, כדי לוודא שיש מספיק מקום בתמונה להצגת היתרונות המרכזיים של המוצרים. הערך בשדה offerId שהוא חלק מאובייקט featuredProduct חייב להיות זהה לערך offerId במשאב products, שהוא שונה מהערך id במשאב products.

בנוסף לשדות imageLink ו-featuredProduct, שהם שדות חובה בתמונות לקניית מוצרים ישירה, אפשר לציין גם כותרת לקולקציה באמצעות השדה האופציונלי headline. מומלץ לכלול כותרת כדי לספק ללקוחות פרטים נוספים על האוסף.

כדי ליצור אוסף חדש של תמונות לקניית מוצרים ישירה, שולחים בקשת POST לנקודת הקצה collections.insert באמצעות כתובת ה-URL וגוף הבקשה הבאים:

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

דוגמה: בדיקת הסטטוס של אוסף

כדי לגלות אם יש באוסף שיצרתם למעלה בעיות שימנעו את הצגת המודעות באוסף, שולחים בקשת GET לנקודת הקצה collectionsstatuses.get באמצעות כתובת ה-URL הבאה, וכוללים את id של האוסף שרוצים לאחזר את הסטטוס שלו. לא צריך לספק תוכן בקשה.

https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID

דוגמה לתגובה עם סטטוס האוסף

{
  "id": "exampleCollection",
  "creationDate": "2020-09-22T00:26:51Z",
  "lastUpdateDate": "2020-09-22T00:26:51Z",
  "collectionLevelIssues": [
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "link",
      "description": "Invalid URL [link]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    },
    {
      "code": "invalid_url",
      "servability": "unaffected",
      "resolution": "merchant_action",
      "attributeName": "imageLink",
      "description": "Invalid URL [imageLink]",
      "detail": "Use a complete URL that starts with http:// or https:// and
          links to a valid destination such as an image or a landing page",
      "documentation": "https://support.google.com/merchants/answer/7052112"
    }
  ]
}