داده های غنی محصول برای صفحات توضیحات محصول

یک صفحه توضیحات محصول (PDP) به خریداران قبل از تکمیل خرید خود با خرید در گوگل، در مورد ویژگی‌ها و مزایای محصول شما آموزش می‌دهد. شما می‌توانید با آپلود داده‌های غنی محصول از طریق API محتوا برای خرید، PDP های غنی ایجاد کنید. داده‌های غنی محصول شامل اطلاعاتی در مورد ویژگی‌ها و مزایای محصول، انواع محصول و تصاویر محصول است.

مزایای دیگر داده‌های غنی محصول عبارتند از:

  • بهبود کشف محصول با ارائه توضیحات دقیق‌تر محصول برای کمک به مشتریان در یافتن محصولاتی که نیازهایشان را برآورده می‌کنند
  • افزایش اعتماد مشتری با ارائه اطلاعات دقیق محصول که امکان تصمیم‌گیری مطمئن برای خرید را فراهم می‌کند
  • کمک به بهبود تبدیل با انتقال واضح‌تر ارزش یک محصول به مشتریان

این راهنما نحوه استفاده از API محتوا برای آپلود داده‌های غنی محصول هنگام ایجاد محصولات با استفاده از روش products.insert را توضیح می‌دهد. بخش‌های زیر بدنه‌های درخواست جزئی حاوی ویژگی‌های منبع products را که داده‌های غنی محصول را تشکیل می‌دهند، ارائه می‌دهند. برای یک درخواست کامل JSON، به مثال: آپلود داده‌های غنی محصول با استفاده از products.insert مراجعه کنید.

ویژگی‌های شناسه محصول

ویژگی id یک محصول که با نام REST ID نیز شناخته می‌شود، یک شناسه منحصر به فرد است که از مقادیری که شما برای ویژگی‌های channel ، contentLanauge ، feedLabel و offerId ارائه می‌دهید، مشتق می‌شود. برای مثال، online:en:US:1111111111 . برای داده‌های غنی محصول، مقادیری را برای همه ویژگی‌های ID محصول وارد کنید:

  • 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: Definition مراجعه کنید.

درخواست نمونه

"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: 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: Definition مراجعه کنید.

درخواست نمونه

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

شناسه‌های منحصر به فرد محصول (GTIN، برند، MPN)

گوگل از شناسه‌های منحصر به فرد محصول برای شناسایی محصولات استفاده می‌کند. ما اکیداً توصیه می‌کنیم برای هر یک از محصولات خود یک مقدار 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"
}