Uma página de descrição do produto (PDP) mostra aos compradores os recursos e benefícios do produto antes de concluírem a compra com o Comprar com o Google. Para criar PDPs detalhadas, faça upload de dados avançados do produto usando a API Content for Shopping. Os dados avançados do produto incluem informações sobre os recursos, benefícios, variantes e imagens do produto.
Outros benefícios dos dados avançados de produtos incluem:
- Melhorar a descoberta de produtos com descrições mais detalhadas para ajudar os clientes a encontrar itens que atendam às necessidades deles
- Aumentar a confiança do cliente, fornecendo informações precisas do produto que permitem tomar decisões de compra confiantes.
- Ajudar a melhorar a conversão transmitindo mais claramente o valor de um produto para os clientes
Neste guia, explicamos como usar a API Content para fazer upload de dados avançados do produto ao criar produtos usando o método products.insert
. As
seções abaixo fornecem corpos de solicitações parciais contendo os atributos
do 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 do produto usando products.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 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
Inserir 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 procurando o item 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 item de maneiras que as especificações e as imagens
não conseguem. 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;
Para melhorar as páginas de descrição do produto, forneça imagens dele com os
atributos imageLink
e additionalImageLinks
. Recomendamos fornecer
várias imagens de alta qualidade que mostrem o produto de diferentes ângulos e em
diferentes contextos. Para diretrizes e requisitos adicionais para 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 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 destaques do produto em uma página de descrição do produto mostra uma breve lista com marcadores de detalhes do produto 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
mais 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 ser diferente
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 incluindo os atributos sectionName
,
attributeName
e attributeValue
. Recomendamos fornecer pelo menos
seis detalhes do produto. Para conferir outras 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 identificar os itens. Recomendamos que você forneça um valor de GTIN para cada um dos seus produtos. Se você não fornecer um GTIN, forneça os valores de brand e MPN para que possamos identificar seu produto. Para mais informações sobre os tipos de identificadores, consulte Sobre 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 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"
}