Dados estruturados de produto: o schema que o Google e os agentes de IA leem

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Garrafa Térmica Inox Marca X 500 ml",
  "image": [
    "https://www.sualoja.com.br/fotos/garrafa-1x1.jpg",
    "https://www.sualoja.com.br/fotos/garrafa-4x3.jpg",
    "https://www.sualoja.com.br/fotos/garrafa-16x9.jpg"
  ],
  "description": "Garrafa de aço inox com parede dupla, 500 ml.",
  "sku": "GT-500-AZ",
  "gtin13": "7890000000000",
  "brand": { "@type": "Brand", "name": "Marca X" },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "4.7",
    "reviewCount": "38"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://www.sualoja.com.br/garrafa-termica-inox-500",
    "price": "89.90",
    "priceCurrency": "BRL",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition",
    "shippingDetails": {
      "@type": "OfferShippingDetails",
      "shippingRate": { "@type": "MonetaryAmount", "value": "19.90", "currency": "BRL" },
      "shippingDestination": { "@type": "DefinedRegion", "addressCountry": "BR" },
      "deliveryTime": {
        "@type": "ShippingDeliveryTime",
        "handlingTime": { "@type": "QuantitativeValue", "minValue": 0, "maxValue": 1, "unitCode": "DAY" },
        "transitTime": { "@type": "QuantitativeValue", "minValue": 2, "maxValue": 6, "unitCode": "DAY" }
      }
    }
  }
}

O GTIN do exemplo é um valor de demonstração. Os formatos aceitos para o código de barras e a forma de levar esse dado do ERP para a loja estão no artigo sobre integração de ERP e marketplace.

Variações, frete e devolução

Produto com várias cores e tamanhos usa a classe ProductGroup, com as propriedades hasVariant (as variantes), variesBy (o que muda entre elas, como cor e tamanho) e productGroupID (o código do grupo). A documentação de variantes de produto cobre os dois desenhos de loja: todas as variantes numa página só ou uma página por variante. Marca e avaliações comuns ficam no grupo, sem repetir em cada item.

Frete e devolução merecem o mesmo cuidado do preço. Para a devolução, o Google aceita categorias como janela com prazo definido (MerchantReturnFiniteReturnWindow, que exige o número de dias) e indica quem paga o frete de retorno. No Brasil, a compra feita pela internet dá ao consumidor 7 dias para desistir, contados da assinatura ou do recebimento, pelo artigo 49 do Código de Defesa do Consumidor; o parágrafo único do mesmo artigo manda devolver de imediato, com correção, os valores pagos a qualquer título durante esse prazo, e o artigo 5º do Decreto 7.962/2013 obriga a loja a informar com clareza como exercer o arrependimento. Antes de marcar que o frete de retorno fica com o cliente, confirme com a assessoria jurídica se isso vale para o arrependimento. A política marcada precisa bater com a publicada, e o modelo de texto está no artigo sobre política de troca e devolução.

Como validar e acompanhar?

1. Teste de pesquisa aprimorada: a ferramenta do Google mostra quais resultados aprimorados a página pode gerar e aponta erros críticos e avisos.
2. Validador de Schema Markup: o validator.schema.org confere a marcação de forma genérica, inclusive tipos que o Google não usa.
3. Inspeção de URL: no Search Console, mostra o HTML que o Google recebeu. O Google prefere a marcação no HTML inicial: gerada por JavaScript, ela pode reduzir a quantidade e a qualidade dos rastreamentos do Shopping; se for o caso, confirme ali que o bloco aparece.
4. Relatórios do Search Console: depois da publicação, os relatórios de listagens do comerciante e de snippets de produto contam páginas válidas e com erro.

Duas ressalvas do Google evitam frustração. A marcação correta habilita, mas não garante, a exibição do resultado aprimorado. E problemas nas diretrizes de dados estruturados, como marcar conteúdo que o visitante não vê, podem gerar uma ação manual que tira a página dos resultados aprimorados — sem mudar, segundo o Google, a classificação dela na busca comum.

O Google também recomenda combinar a marcação com um feed no Merchant Center: com as duas fontes, a loja amplia a elegibilidade para as experiências de compra e o Google consegue conferir os dados de um lado com o outro.

O que os assistentes de IA fazem com esses dados?

O Google é explícito para os próprios recursos de IA: a marcação precisa corresponder ao texto visível, e as informações do Merchant Center e do Perfil da Empresa devem estar atualizadas. Os dados de produto também alimentam o Google Imagens e o Google Lens, usados em buscas por foto. Outros assistentes nem sempre documentam se leem o JSON-LD; o texto visível é o que qualquer leitor da página, pessoa ou robô, encontra. Por isso o dado importante — medida, voltagem, compatibilidade, prazo — deve estar no texto e no código, igual nos dois. Como o consumidor usa a IA para comparar produtos antes de comprar está no artigo sobre IA na decisão de compra. Para medir se a loja é citada pelos assistentes, há um teste repetível em GEO e AEO.

Erros comuns que tiram a loja da vitrine

• Preço desatualizado: a promoção acabou na página, mas o bloco continua com o valor antigo.
• Estoque errado: produto esgotado marcado como InStock.
• Avaliação que não está na página: nota copiada de marketplace ou de outro site. As regras para pedir e exibir avaliações estão no artigo sobre avaliações de clientes.
• Dois blocos de produto conflitantes: o tema e um aplicativo gerando marcações diferentes para a mesma página.
• GTIN inventado ou em formato de URL: o Google só aceita o código numérico.
• AggregateOffer na página de venda: serve para snippet, não para listagem do comerciante.

Dados estruturados não consertam página bloqueada ou canonical errada; esses problemas vêm antes e estão no artigo sobre SEO técnico. A ordem de trabalho entre categoria e produto está em SEO para e-commerce.

Onde os dados estruturados entram no trabalho de SEO como um todo — técnico, conteúdo e reputação — está em o que é SEO.