Neste artigo, detalhamos os requisitos e o formato de cada atributo aceito no Manufacturer Center. Alguns atributos são obrigatórios, enquanto outros são recomendados ou opcionais. A falha em fornecer valores para os atributos obrigatórios impedirá que esse item específico seja processado corretamente no upload do seu feed. O não fornecimento de atributos recomendados ou opcionais resultará em dados do produto incompletos no nosso sistema, mas não causará falha no feed.
Ao longo deste artigo, você verá os termos "item" e "produto". Observe que usamos o termo "item" para descrever uma única variante de um produto. Os itens são parecidos com produtos, mas pressupomos que os produtos podem ter diversas variações. Essas variações, ou "variantes do produto", podem ter cores, tamanhos ou estilos diferentes. Em outras palavras, um item refere-se a uma única variação de um produto. Cada entrada do arquivo de dados do produto deve refletir um único item ou variante do produto.
Lembre-se de que apenas atributos em inglês devem ser enviados no seu feed, o que será mostrado entre os colchetes abaixo. As descrições e/ou traduções dos valores são apenas para fins ilustrativos.
Se você fornecer muitos valores para atributos repetidos (como descrição do recurso), poderemos mostrar apenas os primeiros valores.
Veja alguns exemplos:
Observação: os valores informados por você poderão ser exibidos aos clientes. Portanto, forneça valores que eles consigam entender.
Informações básicas
Os atributos a seguir contêm informações básicas sobre os itens.
Para ver as informações completas sobre o atributo, inclusive as práticas recomendadas, selecione o link em cada tabela.
Atributo | Formato | Resumo dos requisitos mínimos |
---|---|---|
Código [id] |
Obrigatório para todos os itens Exemplo Sintaxe/tipo Valor/campo repetido Texto (TSV) |
Depois que o item tiver sido enviado, o atributo de código |
GTIN [gtin] |
Obrigatório para todos os itens Sintaxe Valor/campo repetido Texto (TSV) XML (feeds) |
|
MPN [mpn] |
Recomendado para todos os itens Sintaxe/tipo Texto (TSV) XML (feeds) |
|
Título [title] |
Obrigatório para todos os itens Título do item Sintaxe/tipo Texto (caracteres Unicode) Limite de caracteres recomendado: 80 a 140 Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Siga nossas diretrizes editoriais com atenção. Por exemplo, não inclua nenhum texto promocional e não use LETRAS MAIÚSCULAS. Em variantes de produto, você precisa incluir o nome exibido para o consumidor de todas elas, inclusive as diferenças de título. Por exemplo, se o "Smartphone Android Google Nexus 5 32 GB - Desbloqueado - CDMA" estiver disponível em vermelho e preto, você precisa enviar os seguintes títulos como dois itens diferentes:
|
Obrigatório para todos os itens Nome da marca de um produto Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Nome do produto [product_name] |
Opcional Nome canônico do produto Sintaxe/tipo Texto (caracteres Unicode) Limite de caracteres recomendado: 80 a 140 Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
|
Linha de produtos [product_line] |
Recomendado para todos os itens Nome de um grupo de produtos relacionados Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
|
Tipo de produto [product_type] |
Opcional Tipo ou categoria do produto Sintaxe/tipo Texto (caracteres Unicode), com o símbolo ">" para hierarquias separadas Valor/campo repetido Sim. Número máximo recomendado de 10 por produto Texto (TSV)
XML (feeds)
|
|
Características do produto [product_highlight] |
Opcional Características do produto Sintaxe/tipo Texto (caracteres Unicode) Limite de caracteres: de 1 a 150 caracteres por característica Recomendado: somente ASCII Valor/campo repetido Sim, recomendado (4 a 6) Mínimo de 2, máximo de 100 Texto (TSV)
XML (feeds)
|
Informações importantes
Atributo | Formato |
---|---|
Descrição [description] |
Obrigatório Sintaxe/tipo Texto (caracteres Unicode) Somente ASCII Intervalo contagem de caracteres recomendado: 500 a 1.000 Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
descrição de recursos [feature_description] |
Recomendado Texto (caracteres Unicode) e imagens Subatributos Valor/campo repetido Texto (TSV)
XML (feeds)
|
Link da imagem [image_link] |
Obrigatório Os formatos de imagem aceitos são (por ordem de preferência): WEBP (.webp), JPEG (.jpg/.jpeg), PNG (.png), GIF não animado (.gif) e BMP (.bmp). As extensões de arquivo dessas imagens precisam corresponder ao formato delas. Os protocolos de URL aceitos são " Os URLs precisam ser rastreáveis e não podem ser protegidos por senha. Os user agents "googlebot" e "googlebot-image" precisam ser autorizados a acessar o diretório com seu arquivo. Saiba mais sobre como configurar seu arquivo robots.txt. URL de uma imagem do item Sintaxe/tipo URL (Precisa começar com Valor/campo repetido Não Texto (TSV)
XML (feeds)
Os formatos de imagem aceitos são (por ordem de preferência): WEBP (.webp), JPEG (.jpg/.jpeg), PNG (.png), GIF não animado (.gif) e BMP (.bmp). As extensões de arquivo dessas imagens precisam corresponder ao formato delas. Os protocolos de URL aceitos são " |
Link da imagem adicional [additional_image_link] |
Recomendado para itens com várias imagens Outros URLs de imagens do item Sintaxe/tipo URL (Precisa começar com Valor/campo repetido Sim. Número máximo recomendado de 10 por produto Texto (TSV)
XML (feeds)
|
Link de vídeo [video_link] |
Opcional URL para um vídeo do item Sintaxe/tipo URL do YouTube (precisa começar com Valor/campo repetido Sim. Número máximo recomendado de 10 por produto Texto (TSV)
XML (feeds)
|
URL da página do produto [product_page_url] |
Opcional URL da página de detalhes do produto do fabricante Sintaxe/tipo URL do YouTube (precisa começar com Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Data de divulgação [disclosure_date] |
Opcional Data em que o item foi anunciado publicamente Sintaxe/tipo Data Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Conteúdo avançado do produto [rich_product_content] |
Opcional Descrições de produtos e mídia avançadas com recursos especiais. Sintaxe/tipo Valor/campo repetido Não Texto (TSV) Observação: será necessário codificar todo o campo entre aspas duplas e substituí-las dentro do campo usando duas aspas duplas. Os exportadores de CSV/TSV geralmente cuidam disso para você.
XML (feeds) Observação: é necessário codificar como CDATA em um arquivo XML.
|
Data de lançamento [release_date] |
Opcional Data em que o item ficou disponível para compra Sintaxe/tipo Data Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Preço de varejo sugerido [suggested_retail_price] |
Opcional Preço de varejo sugerido pelo fabricante Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Detalhes do produto [product_detail] |
Opcional Detalhes e especificações adicionais Sintaxe/tipo Texto (caracteres Unicode) Contagem de caracteres Nome da seção: máximo recomendado de 140 Nome do atributo: máximo recomendado de 140 Valor do atributo: máximo de 1.000 Subatributos Nome da seção Nome do atributo Valor do atributo Valor/campo repetido Sim Texto (TSV)
XML (feeds)
|
Link do modelo 3D [virtual_model_link] |
Opcional Modelo 3D do produto. Quando disponível, inclua o destino das experiências em 3D. Sintaxe/tipo URL (precisa começar com "http://" ou "https://") Contagem de caracteres Até 2.000 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Recomendado para produtos disponibilizados em países com dados válidos que diferem dos países configurados no feed associado a eles. Tipo de sintaxe Contagem de caracteres 2 Valor/campo repetido Sim, até 100 Texto (TSV) Exemplo de vários países: XML (feeds)
Exemplo de vários países: |
Informações de variantes
Definimos variantes como um grupo de itens parecidos, que apenas se diferenciam em atributos como cor [color]
ou estilo [style]
. Enviar variantes de item ajuda o Google a melhorar a experiência do cliente ao agrupar corretamente seus produtos em anúncios e listagens nos Serviços do Google.
Como enviar os dados das variantes
- Comece enviando um item para cada variante.
- Por exemplo, se você oferecer um modelo específico de smartphone em quatro cores (preto, branco, prata e vermelho) e três capacidades de armazenamento (8 GB, 16 GB e 32 GB), precisará enviar 12 variantes de itens (preto 8 GB, preto 16 GB, preto 32 GB, branco 8 GB, branco 16 GB etc.).
- Inclui atributos de código
[id]
exclusivos para cada variante de item, assim como você faria para todos os outros itens nos seus dados do produto. - Para identificar itens como variantes de outros produtos, é preciso agrupar todos juntos com um atributo de código do grupo de itens
[item_group_id]
. Cada item do grupo precisa ter o mesmo código do grupo de itens. Como regra geral, se um cliente puder escolher entre diferentes cores, estampas, tamanhos, estilos etc. na página de destino dos seus produtos, identifique-os como itens separados, mas com o mesmo código do grupo de itens. - Inclua atributos variantes no título para indicar o que torna cada variante única. Um valor para cor
[color]
e/ou especificações técnicas do produto[product_detail]
precisa ser enviado para diferenciar os itens.
Ao elaborar um título [title]
para itens variantes, inclua o nome comum a todas as variantes do produto, bem como os atributos variantes que tornam o produto único.
Exemplo:
- Smartphone Android Google Nexus 5 - 32 GB - Preto - Desbloqueado - GSM
- Smartphone Android Google Nexus 5 - 16 GB - Branco - AT&T
Atributo | Formato | Resumo dos requisitos mínimos |
---|---|---|
Opcional: recomendado para itens com diversas variantes. Identifica as variantes de um produto/estilo Sintaxe/tipo Somente ASCII Máximo de 50 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Use um valor exclusivo para cada grupo de variantes. Use a SKU principal sempre que possível. Mantenha o mesmo valor ao atualizar seus dados do produto. Utilize apenas caracteres Unicode válidos. Use um código de grupo de itens Se seus produtos diferem por elementos de design que não são representados pelos atributos acima, não use o código do grupo de itens Inclua os mesmos atributos de cada produto no grupo de itens. Por exemplo, se um produto varia em tamanho |
|
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o aroma. Recomendado para todos os produtos em que o aroma é um atributo importante e característico. O aroma específico de um produto Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o sabor. Recomendado para todos os produtos em que o sabor é um atributo importante e característico. O sabor específico de um produto Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o formato. Recomendado para todos os produtos em que o formato é um atributo importante e característico. Formato de mídia de um produto Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (Feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com a capacidade. Recomendado para todos os produtos em que a capacidade é um atributo importante e característico. A capacidade de armazenamento de memória fixa de um dispositivo eletrônico Sintaxe/tipo Número inteiro + unidade de medida Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Três valores são aceitos:
|
|
Recomendado para todos os produtos em um grupo de itens que variam de acordo com o gênero e todos em que esse atributo é uma informação importante e característica. Gênero do item Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Três valores são aceitos:
Envie valores em inglês apenas para esse atributo. Se você enviar valores traduzidos, seu produto será exibido sem essas informações ou será reprovado. |
|
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com a idade. Obrigatório para todos os itens de vestuário. Recomendado para todos os produtos em que a idade é um atributo importante e característico. Idade-alvo do item Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
Cinco valores são aceitos:
Envie valores em inglês apenas para esse atributo. Se você enviar valores traduzidos, seu produto será exibido sem essas informações ou será reprovado. |
|
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o tamanho. Obrigatório para todos os itens de vestuário nas categorias de produtos "Vestuário e acessórios > Roupas" e "Vestuário e acessórios > Sapatos" e subcategorias. Recomendado para todos os produtos em que o tamanho é um atributo importante e característico. Tamanho do produto Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido
Texto (TSV) XL XML (feeds)
|
||
Apenas itens de vestuário: Obrigatório para produtos em um grupo de itens que variam de acordo com o tamanho. Obrigatório para todos os itens de vestuário nas categorias e subcategorias de produtos "Vestuário e acessórios" > "Roupas". Tipo de tamanho do item Sintaxe/tipo String (caracteres Unicode. Recomendado: somente ASCII) Valor/campo repetido Sim (máximo de dois valores) Texto (TSV)
XML (feeds)
|
Há seis valores aceitos. É possível fornecer dois valores (por exemplo: grande [big] e alto [tall] ou petite e gestante [maternity]).
Envie valores em inglês apenas para esse atributo. Se você enviar valores traduzidos, seu produto será exibido sem essas informações ou será reprovado. |
|
Recomendado para itens de vestuário Sistema de tamanhos de um item Sintaxe/tipo Texto (caracteres Unicode) Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
11 valores são aceitos:
OBSERVAÇÃO: quando o atributo não é especificado para um item, usamos automaticamente os valores padrão para o país de destino onde você está vendendo o item. |
|
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com a cor. Obrigatório para todos os itens de vestuário. Recomendado para todos os produtos em que a cor é um atributo importante e característico. Cor do item Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o tema. Recomendado para todos os produtos em que o tema é um atributo importante e característico. Descrição do estilo temático, imagem e aparência de um item Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com a estampa. Recomendado para todos os produtos em que a estampa é um atributo importante e característico. Estampa/desenho do item Sintaxe/tipo Texto (caracteres Unicode) Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o material. Recomendado para todos os produtos em que o material é um atributo importante e característico. Material do item Sintaxe/tipo Texto (caracteres Unicode) Máximo de 200 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|
||
Obrigatório para todos os produtos em um grupo de itens que variam de acordo com a quantidade. Recomendado para todos os produtos em que a quantidade é um atributo importante e característico. A quantidade de unidades dentro da embalagem de um determinado tamanho Sintaxe/tipo Número inteiro + unidade de medida Máximo de 100 caracteres Valor/campo repetido Não Texto (TSV)
XML (feeds)
|