Como escrever valores de product_detail e product_highlight que o Google aceita, com linhas de feed de exemplo

O atributo product_detail do Google aceita até 100 entradas por produto, cada uma com 1 a 150 caracteres, e o product_highlight exige no mínimo 2 e recomenda de 4 a 6 afirmações curtas de benefício por item, segundo as especificações oficiais do Google para product detail e product highlight. Ambos são opcionais, então a maioria dos feeds os ignora ou cola uma tabela de especificações que o Merchant Center sinaliza como mal formatada.

O Google afirma que o product_detail ajuda os produtos a aparecerem em superfícies de IA, como o AI Mode, e em maio de 2026 acrescentou mais atributos conversacionais seguindo a mesma ideia.

Esta referência é para gestores de feed e agências que enviam dados de produtos ao Google Merchant Center. Ao final, você saberá escrever os dois atributos em TSV e XML, escapar os caracteres que os quebram, evitar conteúdo proibido e pontuar uma linha antes de enviá-la.

Para que servem product_detail e product_highlight

Os dois atributos parecem semelhantes e muitas vezes são preenchidos a partir da mesma fonte, mas o Google dá a cada um uma função diferente. O product_detail traz especificações técnicas e verificáveis que não são cobertas por outro atributo: conteúdo da embalagem, conectividade, ingredientes, requisitos de energia, acabamento, aroma e fatos semelhantes. O product_highlight traz benefícios de venda curtos, escritos como frases simples.

Nosso teste rápido: se a linha cabe em uma tabela de especificações com um rótulo e um valor, é um product_detail. Se soa como uma frase que um vendedor de loja diria, é um product_highlight. A especificação de highlight do Google faz a mesma divisão e pede que você não repita um no outro.

A especificação em resumo

Estes são os limites como o Google os publica hoje. O Google não lista nenhuma propriedade schema.org para o product_detail, então ele não é captado a partir da sua marcação de dados estruturados; precisa estar no feed.

Fontes: Central de Ajuda do Google Merchant Center, Product detail [product_detail] e Product highlight [product_highlight].

Como escrever product_detail em TSV, XML e na Merchant API

O formato é onde a maioria das linhas falha. Cada detalhe é composto por três valores unidos por dois sinais de dois-pontos, na ordem nome da seção, nome do atributo e valor do atributo. O Google é explícito: em feeds de texto, todo detalhe deve ter dois sinais de dois-pontos, e informar um número de subatributos diferente do declarado no cabeçalho gera um problema de formato de subatributo inválido em "Requer atenção".

Cabeçalho TSV e uma única célula

Declare os subatributos no cabeçalho da coluna, entre parênteses e separados por dois-pontos. Depois de nomeados no cabeçalho, os valores podem seguir na ordem que você declarou. Sem a declaração, o Google presume seção, nome, valor.

product_detail(section_name:attribute_name:attribute_value)

Uma célula com três detalhes fica assim:

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W

Se um detalhe não tem seção, mantenha o dois-pontos inicial e deixe o primeiro campo vazio:

:What's in the box?:"Machine,Measuring spoon,User manual"

Escapando dois-pontos, vírgulas e aspas

As regras de atributos entre aspas do Google se aplicam a atributos de grupo como este:

• Envolva em aspas duplas retas qualquer valor de subatributo que contenha vírgula ou dois-pontos. Coloque entre aspas o valor individual, não o grupo inteiro.
• Escreva uma aspa dupla literal como duas aspas duplas. O exemplo do próprio Google é "APS-C max. 12""" para um valor que termina com o símbolo de polegada.
• Não use escape com barra invertida. O Google lê a barra invertida como um caractere literal.
• Campos entre aspas não são compatíveis com fontes de dados do Google Sheets. Em fontes de arquivo já existentes, os campos entre aspas precisam ser ativados na configuração da fonte de dados.

XML

No XML, cada detalhe é um elemento próprio com três filhos, então não é preciso escapar dois-pontos nem vírgulas:

<g:product_detail><g:section_name>Materials</g:section_name><g:attribute_name>Body</g:attribute_name><g:attribute_value>Stainless steel, BPA-free plastic</g:attribute_value></g:product_detail>

Para categorias com muitas especificações, o XML é o formato mais seguro, porque vírgulas e dois-pontos naturais deixam de ser um risco de parsing.

Merchant API

Pela Merchant API, cada detalhe é um objeto ProductDetail com os campos sectionName, attributeName e attributeValue, conforme a referência do cliente da API.

Como escrever product_highlight

Os highlights são mais simples: uma string por highlight. Em um feed de texto, separe os highlights com vírgulas e coloque entre aspas duplas qualquer highlight que contenha vírgula ou dois-pontos. No XML, dê a cada highlight seu próprio elemento <g:product_highlight>.

"Brews up to 4 cups in one cycle","Foam sensor stops brewing before the pot overflows","Switches off automatically after brewing","Stainless steel body wipes clean"

Mantenha cada um em um único benefício. O Google pede linguagem profissional e gramaticalmente correta, sem ênfase em caixa alta, sem símbolos e sem termos promocionais.

Conteúdo que o Google não permite em nenhum dos atributos

Erros de formatação geram erros visíveis. Erros de conteúdo são mais silenciosos: uma linha pode ser aceita e ainda assim violar a política. Esta tabela reúne as proibições das duas especificações.

O Google acrescenta mais uma regra fácil de passar despercebida: se você envia arquivos document_link que já contêm a mesma informação, deixe-a fora desses atributos e permita que o Google a extraia dos documentos.

Exemplo prático: uma tabela de especificações transformada em linhas aceitas

Abaixo está uma linha típica de uma loja que exporta as especificações dos produtos como um único campo de texto livre. O produto é uma cafeteira elétrica de café turco; a loja vende na Turquia e, em inglês, para mercados do Golfo.

Antes

product_detail: Brand: Acme, Power: 1000W, Material: Stainless Steel, Plastic, FREE SHIPPING, best turkish coffee maker cheap

Cinco problemas em uma célula. Os separadores estão misturados, então a quantidade de dois-pontos não corresponde ao cabeçalho. "Stainless Steel, Plastic" está sem aspas, então a vírgula divide o detalhe. A marca duplica o atributo brand. "FREE SHIPPING" é texto de frete em maiúsculas. O último fragmento é uma sequência de palavras-chave.

Depois, feed em inglês

General:Brew type:Turkish coffee,General:Capacity:4 cups,Power:Rated power:1000 W,Materials:Body:"Stainless steel, BPA-free plastic",Safety:Automatic shut-off:Yes,:What's in the box?:"Machine,Measuring spoon,User manual"

A marca foi para o atributo próprio, o frete foi para shipping, as palavras-chave foram removidas, os valores estão em formato de frase, como o Google recomenda, e todo valor com vírgula está entre aspas. "Automatic shut-off: Yes" permanece porque o fabricante confirma; um campo que sua plataforma preenche por padrão com "No" não permaneceria.

Depois, feed em turco

O Google pede que nomes de seção, nomes de atributo e valores sejam localizados em cada feed de idioma, então o feed em turco recebe uma linha própria, em vez da versão em inglês:

Genel:Demleme türü:Türk kahvesi,Genel:Kapasite:4 fincan,Güç:Nominal güç:1000 W,Malzeme:Gövde:"Paslanmaz çelik, BPA içermeyen plastik",:Kutu içeriği:"Makine,Ölçü kaşığı,Kullanım kılavuzu"

Dois pontos regionais para equipes fora da Turquia. Primeiro, mantenha as letras turcas. A recomendação de ASCII do Google é uma preferência, não um requisito, e a especificação de highlight permite explicitamente letras acentuadas; transliterar "Paslanmaz çelik" para "Paslanmaz celik" produz um erro de grafia, o que entra em conflito com as orientações de gramática e ortografia do Google. Segundo, se uma regra converte esses valores para minúsculas ou para formato de frase, ela precisa de tratamento de caixa sensível à localidade, para que "İ" e "I" não virem as letras erradas, um problema que abordamos em nosso guia de caixa em títulos em turco.

Como construir os valores a partir do seu catálogo

Preenchemos esses atributos em quatro etapas, nesta ordem.

1. Mapeie primeiro as fontes estruturadas. Liste todas as especificações que sua plataforma já armazena como pares de rótulo e valor, como uma aba de especificações, um metafield ou um atributo de ERP. Cada par vira um product_detail, com o grupo de origem como section_name. Use uma camada de feed, como feed rules ou um feed suplementar, para que o catálogo de origem permaneça intacto e a saída para o Google possa diferir da de outros canais.
2. Remova tudo o que pertence a outro atributo. Elimine as linhas de marca, cor, tamanho, material, preço e frete se já estiverem em seus atributos dedicados. Depois, elimine qualquer detalhe cujo texto já apareça no título ou na descrição.
3. Escreva os highlights à mão ou com rascunhos de IA revisados. Os highlights são onde o enriquecimento por IA mais ajuda e mais falha. Um modelo escreverá sem hesitar "Ideal gift for coffee lovers", que é promocional, ou inventará um recurso que o produto não tem. Gere rascunhos apenas a partir de especificações confirmadas e revise-os com a tabela de proibições acima.
4. Valide tamanho e sintaxe antes de exportar. Verifique se cada detalhe e cada highlight tem 150 caracteres ou menos, se cada detalhe tem exatamente dois dois-pontos sem aspas e se a contagem de highlights por produto é de pelo menos 2.

Uma rubrica de pontuação para aplicar antes de enviar

Pontue uma amostra de 20 linhas por categoria. Cada verificação é aprovada (1) ou reprovada (0), para um máximo de 10 por linha. Consideramos 9 ou 10 como pronto, 7 ou 8 como corrigir e depois enviar, e qualquer valor menor como sinal de que os dados de origem precisam de trabalho antes que valha a pena enviar esses atributos.

Onde este guia tem limitações

Não sabemos o quanto esses atributos influenciam o ranqueamento ou a taxa de cliques. O Google diz que o product_detail ajuda os produtos a aparecerem em buscas relevantes, inclusive no AI Mode, mas não publica nenhum número, e não vimos um estudo público controlado. Encare com desconfiança percentuais de fornecedores até que venham acompanhados de um método.

Esta é uma referência para o Google. A especificação de feed de produtos da OpenAI não tem um campo genérico de chave-valor para especificações nem um campo de highlights; ela usa campos planos como material, dimensions e weight, além de uma descrição de 5.000 caracteres. Se você também envia esse feed, suas especificações precisam ser mapeadas para esses campos ou para a descrição. Não verificamos equivalentes da Meta ou do TikTok para este guia.

O guia também deixa de fora os atributos conversacionais mais recentes, como question_and_answer e document_link, além da regra acima sobre sobreposição. Vários fornecedores de feed, incluindo a Channable e a Productsup, publicaram guias de mapeamento para eles antes de nós, e vale a pena lê-los se você precisa desse conjunto agora.

Por fim, se o seu catálogo não tem especificações estruturadas, este método não consegue criá-las, e rascunhos de IA sem uma fonte confirmada são exatamente o que a regra do Google de "enviar apenas valores confirmados" existe para impedir.

Perguntas frequentes

O product_detail é obrigatório no Google Merchant Center?

Não. O Google o lista como opcional para todos os produtos. Vale adicioná-lo quando você tem especificações verificadas que nenhum outro atributo cobre, porque o Google diz que ele ajuda os produtos a aparecerem em buscas relevantes, inclusive no AI Mode.

Quantos product highlights devo enviar?

O Google exige no mínimo 2, permite até 100 e recomenda de 4 a 6 por produto. Cada highlight pode ter até 150 caracteres.

Por que o Merchant Center diz que meu product_detail tem formato de subatributo inválido?

O número de subatributos em um valor não corresponde ao cabeçalho, geralmente porque falta um dois-pontos em um detalhe ou porque uma vírgula ou um dois-pontos sem aspas dentro de um valor o dividiu. Coloque entre aspas qualquer valor que contenha esses caracteres e mantenha dois dois-pontos por detalhe.

Devo usar caracteres turcos em um feed em turco?

Sim. O Google aceita Unicode e recomenda ASCII apenas como preferência, enquanto sua orientação para highlights permite letras acentuadas e pede ortografia correta. Remover as letras turcas cria palavras com erros de grafia.

A IA pode escrever meus product highlights?

Ela pode redigir rascunhos, mas somente a partir de especificações que você confirmou, e todo rascunho deve ser verificado quanto a termos promocionais, comparações e recursos inventados. O Google proíbe os dois primeiros nos highlights, e um recurso inventado é simplesmente um dado de produto falso.

O Google Sheets aceita valores de product_detail entre aspas?

Não. A orientação do Google sobre atributos entre aspas diz que campos entre aspas não são compatíveis com fontes de dados do Google Sheets, então valores de especificações com vírgulas ou dois-pontos são mais bem enviados por um arquivo TSV, XML ou pela Merchant API.

Verifique seu feed antes de adicionar esses atributos

Esses atributos só ajudam se os campos em que se baseiam estiverem limpos. Passe seu feed pela ferramenta gratuita de auditoria de feed de produtos para ver problemas de completude, qualidade e técnicos por produto antes de começar a escrever detalhes e highlights.