Uma página de descrição do produto (PDP) mostra aos compradores os recursos e os benefícios do produto antes que eles concluam a compra no Comprar com o Google. É possível criar PDPs detalhadas fazendo upload de dados avançados do produto usando a API Content for Shopping. Esses dados incluem informações sobre os recursos e benefícios, variantes e imagens do produto.
Outros benefícios de dados avançados de produto incluem:
- Melhorar a descoberta de produtos fornecendo descrições mais detalhadas para ajudar os clientes a encontrar produtos que atendam às necessidades deles
- Aumentar a confiança do cliente, fornecendo informações precisas sobre o produto que permitem decisões de compra seguras
- Ajudam a melhorar a conversão transmitindo mais claramente o valor de um produto aos clientes.
Neste guia, explicamos como usar a API Content para fazer upload de dados avançados ao
criar itens usando o método
products.insert
. 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 produtos. Para uma solicitação JSON completa, consulte
Exemplo: como fazer upload de dados avançados de produto usando product.insert.
Atributos do ID do produto
O atributo id
de um produto, também conhecido como REST ID
, é um identificador exclusivo derivado
dos valores fornecidos para os atributos channel
, contentLanauge
,
feedLabel
e offerId
. Por exemplo,
online:en:US:1111111111
. Para dados avançados do produto, inclua valores para todos os atributos de ID do produto:
channel
: "on-line" ou "local"contentLanguage
: o código de idioma de duas letras, como "en" ou "fr".feedLabel
: o código de idioma de duas letras, como "US" ou "FR"offerId
: uma string identificadora exclusiva 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
analisando o produto certo. Para mais diretrizes e requisitos para
títulos de produtos, consulte
Título: 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
a informar os clientes sobre o produto de maneiras que especificações e imagens
não podem. Para ver mais diretrizes e requisitos para descrições do produto, 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 as páginas de descrição do produto fornecendo imagens com os
atributos imageLink
e additionalImageLinks
. Recomendamos fornecer
várias imagens de alta qualidade, mostrando o produto de diferentes ângulos e em
contextos diferentes. Para ver mais diretrizes e requisitos para imagens do produto, consulte image_link: 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 do produto
É possível usar o atributo itemGroupId
para definir grupos de produtos para variantes de
produtos semelhantes. Para conferir diretrizes sobre como e quando agrupar produtos, além de requisitos e práticas recomendadas, consulte item_group_id: 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 mostra uma breve lista com marcadores de detalhes ao lado da imagem principal. Use o atributo
productHighlights
para fornecer uma lista de itens para a seção de destaques
do produto. Recomendamos fornecer pelo menos cinco características do produto. Para
outras diretrizes e requisitos para características do produto, consulte
product_highlights: 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 mostra mais
informações abaixo da imagem do produto. O layout pode variar entre
as páginas para computadores e dispositivos móveis. Use o atributo productDetails
para fornecer uma lista
de objetos de detalhes do produto, cada um deles incluindo um atributo sectionName
,
attributeName
e attributeValue
. Recomendamos fornecer pelo menos
seis detalhes do produto. Para mais diretrizes e requisitos de detalhes do produto, consulte product_detail: 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 identificá-los. É altamente recomendável fornecer um valor de 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 tipos de identificadores, consulte Sobre identificadores exclusivos de produto.
Exemplo de solicitação
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
Exemplo: fazer upload de dados avançados do produto com products.insert
O exemplo JSON a seguir mostra um exemplo de solicitação para uma chamada products.insert
para fazer 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"
}