נתוני מוצרים עשירים לדפי תיאור של מוצרים

אנחנו רוצים להציג את גרסת הבטא של Merchant API. זוהי הגרסה החדשה של Content API for Shopping, של העתיד.

כדי ללמוד איך Merchant API יכול לשפר את השילוב ואיך אתם יכולים לעזור לעצב את העתיד אפשר לקרוא את המאמר הודעה על גרסת הבטא של Merchant API.

דף תיאור מוצר מספק לקונים מידע על התכונות והיתרונות של המוצר שלכם לפני שהם משלימים את הרכישה ב'קונים ב-Google'. כדי ליצור דפי תיאור מפורטים של מוצרים, אפשר להעלות נתוני מוצרים עשירים באמצעות Content API for Shopping. נתוני מוצר עשירים כוללים מידע על התכונות והיתרונות של המוצר, על וריאציות שלו ועל תמונות שלו.

יתרונות נוספים של נתוני מוצרים עשירים כוללים:

• לשפר את גילוי המוצרים על ידי מתן תיאורים מפורטים יותר של המוצר כדי לעזור ללקוחות למצוא מוצרים שעונים על הצרכים שלהם
• חיזוק האמון של הלקוחות על ידי מתן פרטי מוצר מדויקים שמאפשרים לקבל החלטות מושכלות בנוגע לרכישה
• שיפור ההמרות על ידי הצגה ברורה יותר של הערך של המוצר ללקוחות

במדריך הזה מוסבר איך להשתמש ב-Content API כדי להעלות נתוני מוצרים עשירים כשיוצרים מוצרים באמצעות השיטה products.insert. בקטעים הבאים מופיעים גופי בקשות חלקיים שמכילים את המאפיינים של המשאב products שמרכיבים נתוני מוצרים עשירים. לבקשה מלאה של JSON, ראו דוגמה: העלאת נתוני מוצרים עשירים באמצעות products.insert.

הערה: לקבלת מידע נוסף על דפי תיאור מפורטים של מוצרים, כולל הסבר על הוספת נתוני מוצרים עשירים ב-Merchant Center, קראו את המאמר איך יוצרים דפי תיאור מפורטים של מוצרים ב'קונים ב-Google'.

מאפיינים של מזהי מוצרים

המאפיין id של המוצר, שנקרא גם REST ID, הוא מזהה ייחודי שנגזר מהערכים שסיפקתם במאפיינים channel, contentLanauge, feedLabel ו-offerId. לדוגמה, online:en:US:1111111111. כדי להציג נתוני מוצרים מפורטים, כדאי לכלול ערכים לכל המאפיינים של מזהי המוצרים:

• channel: "אונליין" או "מקומי"
• contentLanguage: קוד שפה בן שתי אותיות, כגון 'en' או 'fr'
• feedLabel: קוד שפה בן שתי אותיות, כגון "US" או "FR"
• offerId: מחרוזת מזהה ייחודי שסופקה על ידי המוכר

בקשה לדוגמה

"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"

כותרת המוצר

כדאי לציין במאפיין title את הפרטים החשובים על המוצר, כמו מידע על מותג, מגדר, מידה וצבע, וכך לעזור ללקוחות להבין במהירות אם הם מחפשים את המוצר הנכון. הנחיות ודרישות נוספות לגבי שם הפריט מופיעות במאמר שם הפריט: הגדרה.

בקשה לדוגמה

"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"

תיאור המוצר

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

הערה: Google עשויה לעצב את תיאורי המוצרים על סמך התאמות למספר ה-GTIN הייחודי של המוצר.

בקשה לדוגמה

"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."

תמונות מוצר

כדי לשפר את דפי תיאור המוצרים, מומלץ לספק תמונות של המוצרים באמצעות המאפיינים imageLink ו-additionalImageLinks. מומלץ לספק מספר תמונות באיכות גבוהה שמציגות את המוצר מזוויות שונות ובהקשרים שונים. הנחיות ודרישות נוספות בנוגע לתמונות מוצרים זמינות במאמר image_link: הגדרה.

בקשה לדוגמה

"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
    "https://example.com/gallery/500/image2.jpg",
    "https://example.com/gallery/500/image3.jpg",
    "https://example.com/gallery/500/image4.jpg",
    "https://example.com/gallery/500/image5.jpg"
  ]

וריאציות של המוצר

אפשר להשתמש במאפיין itemGroupId כדי להגדיר קבוצות מוצרים לווריאציות של מוצרים דומים. הנחיות לקיבוץ מוצרים ולזמנים מפורטים, וגם דרישות ושיטות מומלצות, זמינות במאמר item_group_id: Definition.

בקשה לדוגמה

"itemGroupId": "pixels"

מידע חשוב על המוצר

בקטע 'המיטב של המוצר' בדף תיאור המוצר מופיעה רשימה קצרה עם תבליטים של פרטי המוצר, ליד התמונה הראשית של המוצר. המאפיין productHighlights משמש כדי לספק רשימה של פריטים בקטע של תכונות בולטות. מומלץ לספק לפחות חמש תכונות בולטות. הנחיות ודרישות נוספות לגבי תכונות בולטות זמינות במאמר product_highlights: הגדרה.

הערה: Google עשויה לשנות את התוכן בקטע של התכונות הבולטות של המוצר בהתאם להתאמות למספר ה-GTIN הייחודי של המוצר.

בקשה לדוגמה

"productHighlights": [
    "6GB RAM lets you enjoy multitasking conveniently",
    "Touch screen feature offers user friendly interface",
    "Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
  ]

פרטי המוצר

בקטע של פרטי המוצר בדף תיאור המוצר מוצג מידע נוסף על המוצר מתחת לתמונת המוצר (הפריסה עשויה להיות שונה בין דפים למחשב ולנייד). המאפיין productDetails משמש כדי לספק רשימה של אובייקטים בפרטי המוצרים, כשכל אחד מהם כולל את המאפיינים sectionName, attributeName ו-attributeValue. מומלץ לספק לפחות שישה פרטים על המוצר. הנחיות ודרישות נוספות בנוגע לפרטי המוצר זמינות במאמר product_detail: הגדרה.

הערה: פרטי המוצר שאתם מספקים צריכים להתאים לפרטים שמופיעים ב-GTIN של המוצרים.

בקשה לדוגמה

  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ]

מזהי מוצר ייחודיים (GTIN, מותג, קוד MPN)

Google משתמשת במזהי מוצרים ייחודיים כדי לזהות מוצרים. מומלץ מאוד לספק ערך של GTIN לכל אחד מהמוצרים. אם לא תספקו מספר GTIN, עליכם לספק ערכים גם ל-brand וגם ל-MPN כדי שנוכל לזהות את המוצר. מידע נוסף על סוגי מזהים זמין במאמר מידע על מזהי מוצר ייחודיים (UPI).

הערה: מזהי Google משמשים גם כדי להתאים מוצרים לנתוני ביקורות, אם הם זמינים. מידע נוסף על שליחת נתוני ביקורות זמין במאמר אפשרויות לשליחת דירוגי מוצרים.

בקשה לדוגמה

"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"

דוגמה: העלאת נתוני מוצר עשירים באמצעות products.insert

דוגמת ה-JSON הבאה מציגה דוגמה לבקשה לקריאה של products.insert להעלאת נתוני מוצרים עשירים.

אזהרה: כברירת מחדל, ביצוע קריאות ל-products.insert כדי לעדכן מוצרים קיימים יחליף את כל נתוני המוצרים בשדות שצוינו בגוף הבקשה. למידע נוסף על עדכון מוצרים בלי להחליף נתוני מוצרים קיימים, ראו פידים משלימים.

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

{
  "channel": "online",
  "contentLanguage": "en",
  "offerId": "pixel4",
  "targetCountry": "US",
  "feedLabel": "US",
  "title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
  "description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
  "imageLink": "https://example.com/gallery/500/image1.jpg",
  "additionalImageLinks": [
    "https://example.com/gallery/500/image2.jpg",
    "https://example.com/gallery/500/image3.jpg",
    "https://example.com/gallery/500/image4.jpg",
    "https://example.com/gallery/500/image5.jpg"
  ],
  "brand": "Google",
  "googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
  "gtin": "842776114952",
  "mpn": "GA01188-US",
  "price": {
    "currency": "USD",
    "value": "549.99"
  },
  "salePrice": {
    "currency": "USD",
    "value": "549.99"
  },
  "productHighlights": [
    "6GB RAM lets you enjoy multitasking conveniently",
    "Touch screen feature offers user friendly interface",
    "Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
  ],
  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ],
  "availability": "in stock",
  "condition": "new",
  "includedDestinations": [
    "Shopping Actions"
  ],
  "excludedDestinations": [
    "Shopping Ads"
  ],
  "sellOnGoogleQuantity": 100,
  "shippingLabel": "US_Test"
}