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

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

تشمل المزايا الإضافية لبيانات المنتجات المنسّقة ما يلي:

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

يشرح هذا الدليل كيفية استخدام 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": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"

وصف المنتج

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

نموذج طلب

  "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"
}