Uma página de descrição do produto (PDP) mostra aos compradores os recursos e benefícios do produto antes de concluir a compra com o Comprar no Google. É possível criar páginas de detalhes do produto (PDPs) avançadas ao fazer upload de dados de produtos avançados pela API Content for Shopping. Os dados detalhados do produto incluem informações sobre os recursos e benefícios, variantes e imagens do item.
Outros benefícios dos dados avançados de produtos incluem:
- Melhorar a descoberta de produtos fornecendo descrições mais detalhadas para ajudar os clientes a encontrar o que precisam
- Aumentar a confiança do cliente fornecendo informações precisas sobre o produto que permitem decisões de compra confiantes
- Ajudar a melhorar a conversão transmitindo de forma mais clara o valor de um produto aos clientes
Este guia explica como usar a API Content para fazer upload de dados avançados de produtos ao
criar itens usando o método
products.insert. As seções a seguir fornecem corpos de solicitação parciais que contêm os atributos do recurso products que compõem os dados avançados de produtos. Para uma solicitação JSON completa, consulte
Exemplo: fazer upload de dados avançados de produtos usando products.insert.
Atributos de 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 de produtos, inclua valores para todos os atributos de ID do produto:
channel: "online" 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 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 detalhes importantes do produto, como informações sobre marca, gênero, tamanho e cor, no atributo title ajuda os clientes a determinar rapidamente se estão olhando o produto certo. Para mais diretrizes e requisitos de
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 educar os clientes sobre o item de maneiras que especificações e imagens não conseguem. Para mais diretrizes e requisitos sobre descrições de produtos, consulte
description: Definition.
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 dos produtos fornecendo imagens usando os atributos imageLink e additionalImageLinks. Recomendamos fornecer várias imagens de alta qualidade mostrando o produto de diferentes ângulos e em contextos diferentes. Para mais diretrizes e requisitos sobre imagens de produtos, 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 de produtos
Use o atributo itemGroupId para definir grupos de produtos para variantes de itens semelhantes. Para orientações 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 destaques na página de descrição de um produto mostra uma lista curta com marcadores dos 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 que você forneça pelo menos cinco destaques. Para mais diretrizes e requisitos sobre características do produto, consulte product_highlights: Definition.
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 informações adicionais abaixo da imagem do item. O layout pode variar entre páginas para computadores e dispositivos móveis. Use o atributo productDetails para fornecer uma lista de objetos de detalhes do produto, cada um dos quais inclui um atributo sectionName, attributeName e attributeValue. Recomendamos fornecer pelo menos seis detalhes do produto. Para mais diretrizes e requisitos sobre detalhes do produto, consulte product_detail: Definition.
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 para identificar produtos. Recomendamos fornecer um valor de GTIN para cada um dos seus produtos. Se você não fornecer um GTIN, informe valores para marca 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: fazer upload de dados avançados de produtos com products.insert
O exemplo de JSON a seguir mostra uma solicitação de uma chamada products.insert
para fazer upload de dados avançados de produtos.
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"
}