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

تقدّم صفحة وصف المنتج معلومات للمتسوّقين عن ميزات منتجك ومزاياه لكي يطّلعوا عليها قبل إكمال عملية الشراء باستخدام ميزة "الشراء على 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: رمز اللغة المكوّن من حرفَين، مثل "ar" أو "en"
  • feedLabel: رمز اللغة المكوّن من حرفَين، مثل "US" أو "FR"
  • ‫offerId: سلسلة معرّف فريد يقدّمها التاجر

مثال على الطلب

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

عنوان المنتج

يساعد وضع تفاصيل المنتج الرئيسية، مثل المعلومات المتعلقة بالعلامة التجارية والجنس والمقاس واللون، في السمة title العملاء في تحديد ما إذا كانوا يتصفّحون المنتج المناسب بسرعة. للاطّلاع على إرشادات ومتطلبات إضافية بشأن عناوين المنتجات، يُرجى الاطّلاع على title: Definition.

مثال على الطلب

"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: Definition.

مثال على الطلب

"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، يجب تقديم قيم لكل من السمتَين العلامة التجارية و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"
}