Подробные данные о продукте на страницах описания продукта

Страница описания товара (PDP) знакомит покупателей с особенностями и преимуществами вашего товара до того, как они совершат покупку через «Купить через Google». Вы можете создавать подробные PDP, загружая подробные данные о товаре через Content API для покупок. Подробные данные о товаре включают информацию о его характеристиках и преимуществах, вариантах товара и изображениях.

Дополнительные преимущества расширенных данных о продуктах включают:

  • Улучшение поиска продуктов за счет предоставления более подробных описаний продуктов, чтобы помочь клиентам найти продукты, соответствующие их потребностям
  • Повышение доверия клиентов за счет предоставления точной информации о продукте, позволяющей принимать уверенные решения о покупке
  • Помощь в улучшении конверсии за счет более четкого донесения ценности продукта до клиентов

В этом руководстве объясняется, как использовать Content 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: Definition .

Образец запроса

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

Описание продукта

Подробное описание товара, предоставляемое через атрибут description , может помочь покупателям лучше понять товар, чем спецификации и изображения. Дополнительные рекомендации и требования к описаниям товаров см. в разделе «description: Definition» .

Образец запроса

"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: Определение .

Образец запроса

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

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