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

קולקציות מוצרים מאפשרות לכם להגדיר קבוצות של מוצרים לשימוש בפורמטים עשירים, כמו תמונות לקניית מוצרים ישירה. כל אחד קולקציה יכולה לכלול עד 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"
    }
  ]
}