Uma página de descrição do produto (PDP) mostra aos compradores os recursos do seu produto e benefícios antes de concluir a compra com o Comprar com o Google. Você pode criar PDPs detalhadas enviando dados do produto com a API Content para Compras. Os dados avançados do produto incluem informações sobre os recursos do produto e benefícios, variantes do produto e imagens do produto.
Outros benefícios dos dados avançados de produtos incluem:
- Melhorar a descoberta de produtos fornecendo descrições mais detalhadas dos produtos para ajudar os clientes a encontrar produtos que atendam às necessidades deles
- Aumentar a confiança do cliente fornecendo informações precisas sobre os produtos possibilita decisões de compra seguras
- Ajudar a melhorar a conversão transmitindo o valor de um produto com mais clareza para clientes
Este guia explica como usar a API Content para fazer o upload de dados avançados de produtos ao
criando produtos usando
método products.insert. A
as seções a seguir fornecem corpos de solicitação parciais contendo os atributos
para o recurso products
que compõem dados avançados de produto. Para uma solicitação JSON completa, consulte
Exemplo: fazer upload de dados avançados do produto com products.insert.
Atributos do ID do produto
O id de um produto
também conhecido como REST ID, é um identificador exclusivo derivado
dos valores fornecidos para channel, contentLanauge,
feedLabel e offerId. Por exemplo:
online:en:US:1111111111: Para dados de produto avançados, inclua valores para todos os
atributos de ID do produto:
channel: "on-line" ou "local"contentLanguage: o código de idioma com duas letras, como "en" ou "fr"feedLabel: o código de idioma com duas letras, como "US". ou "FR"offerId: uma string de identificador exclusivo fornecida pelo comerciante.
Exemplo de solicitação
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
Título do produto
Colocar os principais detalhes do produto, como informações sobre marca, gênero, tamanho e
cor, no atributo title, ajuda os clientes a determinar rapidamente se
estão procurando o produto certo. Para diretrizes e requisitos adicionais
títulos de produtos, consulte
title: Definição.
Exemplo de solicitação
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
Descrição do produto
Uma descrição detalhada do produto, fornecida pelo atributo description, pode ajudar
educar os clientes sobre o produto de forma que as especificações e imagens
não pode. Para diretrizes e requisitos adicionais para descrições de produtos, consulte
description: definição.
Exemplo de solicitação
"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."
imagens do produto;
Melhore suas páginas de descrição fornecendo imagens de produtos por meio do
atributos imageLink e additionalImageLinks. Recomendamos fornecer
várias imagens de alta qualidade que mostram o produto de diferentes ângulos e
contextos diferentes. Para mais diretrizes e requisitos de produtos
imagens, consulte
image_link [link_da_imagem]: definição.
Exemplo de solicitação
"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"
]
Variantes de produtos
É possível usar o atributo itemGroupId para definir grupos de produtos para variantes de
produtos similares. Para orientações sobre como e quando agrupar produtos, além de
e práticas recomendadas, consulte
item_group_id [código_do_grupo_de_itens]: definição.
Exemplo de solicitação
"itemGroupId": "pixels"
Características do produto
A seção de características do produto em uma página de descrição do produto mostra
lista com marcadores de detalhes do produto ao lado da imagem principal. Use o
Atributo productHighlights para fornecer uma lista de itens ao produto
na seção de destaques. Recomendamos fornecer pelo menos cinco características do produto. Para
diretrizes e requisitos adicionais para características do produto, consulte
product_highlights [características_do_produto]: definição.
Exemplo de solicitação
"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"
]
Detalhes do produto
A seção de detalhes do produto em uma página de descrição do produto mostra
informações do produto abaixo da imagem do produto (o layout pode ser diferente entre
para computadores e dispositivos móveis). Use o atributo productDetails para fornecer uma lista
objetos de detalhes do produto, cada um incluindo um sectionName,
attributeName e attributeValue. Recomendamos fornecer pelo menos
seis detalhes do produto. Para mais diretrizes e requisitos de produtos
detalhes, consulte
product_detail [informações_técnicas_do_produto]: definição.
Exemplo de solicitação
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
Identificadores exclusivos de produto (GTIN, marca, MPN)
O Google usa identificadores exclusivos de produto para identificar os itens. Nós fortemente é recomendável fornecer um GTIN para cada um dos seus produtos. Se você não fornecer um GTIN, precisará fornecer valores para brand e MPN para que possamos identificar seu produto. Para mais informações sobre os tipos de identificadores, consulte Sobre os identificadores exclusivos de produto
Exemplo de solicitação
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Exemplo: faça upload de dados avançados do produto com products.insert
O exemplo de JSON a seguir mostra um exemplo de solicitação para um products.insert
chamada para o upload de dados avançados do produto.
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"
}