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

تقدّم صفحة وصف المنتج معلومات للمتسوّقين عن ميزات منتجك ومزاياه قبل إكمال عملية الشراء باستخدام ميزة "الشراء على 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: التعريف.

نموذج طلب

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