بيانات المنتج المنسّقة في صفحات وصف المنتجات

تقدّم صفحة وصف المنتج معلومات للمتسوّقين عن ميزات منتجك. ومزاياه قبل إكمال عملية الشراء باستخدام ميزة "الشراء على Google". يمكنك إنشاء صفحة وصف تتضمّن معلومات وافية عن طريق تحميل بيانات وافية عن المنتج عبر Content API التسوّق: تشمل بيانات المنتج الوافية معلومات حول ميزات المنتج. ومزاياها وخياراتها وصورها.

تشمل المزايا الإضافية لبيانات المنتج الغنية بصريًا ما يلي:

  • تحسين إمكانية العثور على المنتجات من خلال تقديم أوصاف أكثر تفصيلاً عن المنتجات لمساعدة العملاء في العثور على المنتجات التي تلبي احتياجاتهم
  • زيادة ثقة العملاء من خلال توفير معلومات دقيقة عن المنتجات تتيح اتخاذ قرارات شراء مدروسة
  • المساعدة في تحسين الإحالات الناجحة من خلال التعبير بشكل أكثر وضوحًا قيمة المنتج إلى العملاء

يوضّح هذا الدليل كيفية استخدام Content API لتحميل بيانات وافية عن المنتج في الحالات التي إنشاء المنتجات باستخدام products.insert. تشير رسالة الأشكال البيانية توفّر الأقسام التالية نصوص طلبات جزئية تحتوي على السمات لمرجع products التي تشكّل بيانات غنية عن المنتج للحصول على طلب JSON كامل، يمكنك الاطّلاع على مثال: تحميل بيانات وافية عن المنتجات باستخدام products.insert

سمات معرّف المنتج

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: التعريف.

نموذج طلب

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

وصف المنتج

يمكن أن يساعدك تقديم وصف وافٍ عن المنتج من خلال السمة description تعريف العملاء بالمنتج بطرق تتيح للمواصفات والصور لا يستطيع ذلك. للحصول على إرشادات ومتطلبات إضافية لأوصاف المنتجات، راجع description (الوصف): التعريف.

نموذج طلب

"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 (معرّف_مجموعة_السلع): التعريف.

نموذج طلب

"itemGroupId": "pixels"

لمحة عن المنتج

يعرض قسم "لمحة عن المنتج" في صفحة وصف المنتج وصفًا قائمة نقطية بتفاصيل المنتج بجانب صورة المنتج الرئيسي يمكنك استخدام سمة productHighlights لتقديم قائمة بسلع المنتج الإشعارات المهمة. ننصحك بتقديم ما لا يقل عن خمسة لمحات عن المنتج. بالنسبة الإرشادات والمتطلبات الإضافية لللمحة عن المنتج، راجع product_highlights: التعريف

نموذج طلب

"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. نوصي بتقديم ما لا يقل عن ستة تفاصيل للمنتج. للاطّلاع على إرشادات ومتطلبات إضافية للمنتج التفاصيل، راجع تعريف_المنتج.

نموذج طلب

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

المعرّفات الفريدة للمنتجات (رقم GTIN والعلامة التجارية ورقم القطعة المحدّد من الشركة المصنّعة)

تستخدم Google معرّفات المنتجات الفريدة لتحديد المنتجات. نحن نشدد بشدة الذين ينصحون بتقديم GTIN قيمة لكل منتج من منتجاتك. في حال عدم تقديم رقم GTIN، يجب تقديمه القيم لكل من brand MPN كي نتمكّن من تحديد منتجك. لمزيد من المعلومات حول أنواع المعرّفات، يُرجى مراجعة لمحة عن معرّفات المنتجات الفريدة

نموذج طلب

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

مثال: تحميل بيانات غنية عن المنتج باستخدام السمة products.insert

يعرض نموذج JSON التالي مثالاً على طلب الحصول على 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"
}