Atena
Analytikos
Caixa de papelão sobre uma superfície clara, representando um produto de e-commerce

Dados estruturados para produto: Product, Offer e Review

NAVEGAÇÃO RÁPIDA

Mais lidas

Carregando posts...

Quando alguém procura um produto no Google, a página da sua loja compete com dezenas de outras que dizem quase a mesma coisa. O que muda a leitura do buscador é a clareza dos dados: preço, disponibilidade, avaliações, frete e devolução. Os dados estruturados em formato JSON-LD (JavaScript Object Notation for Linked Data) entregam essas informações em um bloco legível por máquina, sem depender de interpretação do layout.

Este guia mostra, passo a passo, como marcar Product, Offer e Review do jeito que a documentação do Google pede. Você vai ver quais propriedades são obrigatórias, como escrever preço e moeda, onde ficam avaliações, frete e devolução, como validar e quais erros mais derrubam a elegibilidade a resultados enriquecidos.

As três experiências do Google com dados de produto

A documentação de dados estruturados de Product separa o que o Google pode exibir em três grupos. Entender a diferença evita marcar a página errada com o tipo errado.

ExperiênciaPara que serveQuando usar
Snippets de produtoMostrar nota, preço e disponibilidade em páginas sobre um produtoPáginas em que o usuário não compra direto, como análises editoriais e comparativos
Listagens de comercianteExibir produto com preço, frete, devolução e mais detalhesPáginas de produto em que o cliente pode comprar da sua loja
VariantesAgrupar tamanhos, cores e outras opções do mesmo produtoProdutos com variações, em ambos os casos acima
Tabela: Analytikos, com base na documentação do Google Search Central

Uma regra prática: se a página permite comprar, trate-a como listagem de comerciante. A documentação informa que atender às propriedades obrigatórias de listagens também torna a página elegível a snippets. E vale lembrar que o markup na página, combinado com o feed no Merchant Center, aumenta a chance de elegibilidade, já que os dois se complementam.

Para visualizar a diferença, a documentação do Google traz ilustrações de cada formato. À esquerda, o snippet de produto, com nota, número de avaliações, preço e estoque logo abaixo do resultado; ao centro, o carrossel de produtos populares; à direita, o painel de informações do Shopping, que reúne ofertas de várias lojas com preço e frete. As duas últimas são exemplos de listagens de comerciante. Os rótulos das ilustrações estão em inglês, como no original.

Imagens: Google. Fonte: Google Search Central, dados estruturados de produto

Passo 1: as propriedades mínimas de Product e Offer

Para listagens de comerciante, a página oficial exige, em Product, name, image e offers. Em Offer, são obrigatórios price (número maior que zero) e priceCurrency, com a moeda em código ISO 4217, como BRL. Note que o tipo precisa ser Offer, não AggregateOffer, porque o comerciante deve ser o vendedor.

TipoObrigatóriasRecomendadas
Product (listagem)name, image, offersaggregateRating, brand, description, color, category, gtin, review
Offer (listagem)price, priceCurrencyavailability, itemCondition, url, shippingDetails, hasMerchantReturnPolicy, priceValidUntil
Product (snippet)name e pelo menos um entre review, aggregateRating ou offersOs demais campos acima, conforme o caso
Offer (snippet)priceavailability, priceCurrency, priceValidUntil
Tabela: Analytikos, com base na documentação de listagens de comerciante e de snippets de produto

Para o código de barras, use a propriedade gtin com a variação certa (gtin8, gtin12, gtin13 ou gtin14), só com dígitos. Ele ajuda o Google a reconhecer o produto, e o post sobre a atualização dos dados estruturados com o gtin12 traz o contexto da mudança.

O diagrama abaixo mostra como esses tipos se encaixam em uma página de produto que vende: o Product é o tronco, o Offer guarda o preço e as condições de compra, e as avaliações ficam penduradas no próprio Product.

Imagem: Analytikos, com base na documentação de listagens de comerciante e na de variantes de produto do Google

Passo 2: como escrever preço, moeda e disponibilidade

A maior parte dos erros de markup nasce no formato do valor, não no conceito. O vocabulário do schema.org para Offer define as regras de escrita. Veja as mais importantes para o varejo brasileiro:

  • price: apenas dígitos de 0 a 9 e ponto como separador decimal. Escreva 399.90, nunca “R$ 399,90”.
  • priceCurrency: código ISO 4217, como BRL. O símbolo R$ não vale.
  • availability: um único valor, como InStock, OutOfStock, PreOrder ou BackOrder, com ou sem o prefixo da URL do schema.org.
  • priceValidUntil: data no futuro, em formato ISO 8601. A documentação de snippets avisa que uma data no passado pode impedir a exibição.
  • Preço riscado: use UnitPriceSpecification com priceType StrikethroughPrice e sempre inclua o preço atual junto.

Um detalhe de conta: se offers.price e priceSpecification coexistirem, vale offers.price. Por isso, evite duplicar o preço em dois lugares com valores diferentes. Um exemplo simples: produto de R$ 399,90 com desconto de 10%. O preço atual é 399,90 × 0,90 = 359,91. O markup deve trazer price 359.91 e, se quiser mostrar o preço anterior, o riscado de 399.90 na estrutura própria.

Exemplo completo de JSON-LD para produto

O bloco abaixo reúne Product, Offer, avaliações, frete e devolução. Ele é ilustrativo: troque cada valor pelos dados reais da sua página e inclua apenas avaliações que existam e estejam visíveis para o usuário. O exemplo segue as propriedades das documentações citadas neste guia e o formato do schema.org.

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Tênis de corrida Veloz 2",
  "image": [
    "https://www.exemplo.com.br/img/veloz2-1x1.jpg",
    "https://www.exemplo.com.br/img/veloz2-4x3.jpg",
    "https://www.exemplo.com.br/img/veloz2-16x9.jpg"
  ],
  "description": "Tênis de corrida leve com amortecimento reativo.",
  "sku": "VLZ2-42-AZ",
  "gtin13": "7891234567895",
  "brand": { "@type": "Brand", "name": "Marca Exemplo" },
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": 4.6,
    "bestRating": 5,
    "reviewCount": 128
  },
  "review": [{
    "@type": "Review",
    "author": { "@type": "Person", "name": "Nome do cliente" },
    "datePublished": "2026-10-02",
    "reviewRating": { "@type": "Rating", "ratingValue": 5, "bestRating": 5 },
    "reviewBody": "Texto real da avaliação, visível na página."
  }],
  "offers": {
    "@type": "Offer",
    "url": "https://www.exemplo.com.br/tenis-veloz-2?tam=42&cor=azul",
    "price": 399.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" }
    },
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "BR",
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow",
      "merchantReturnDays": 7,
      "returnFees": "https://schema.org/FreeReturn"
    }
  }
}
</script>

Dois lembretes sobre o exemplo. Primeiro, a documentação recomenda deixar frete e devolução no nível da organização, e usar o nível da oferta só para sobrescrever; o exemplo traz ambos na oferta para facilitar a leitura. Segundo, se existir configuração de frete ou devolução no Merchant Center ou no Search Console, ela tem precedência sobre o markup de produto, conforme as páginas oficiais de política de devolução e de política de frete.

Conheça a Athena, by Analytikos: GA4, loja e mídia em um só painel. Testar 30 dias grátis

Passo 3: Review e AggregateRating sem violar as regras

Nota e avaliações são o elemento que mais chama atenção no resultado, e também o mais vigiado. A documentação de review snippets pede, para Review, author (com nome válido), reviewRating.ratingValue e itemReviewed, este último dispensado quando a avaliação está aninhada em Product. Para AggregateRating, são necessários ratingValue e pelo menos um entre ratingCount e reviewCount.

  • A escala padrão é de 1 a 5, com ponto decimal (4.4, não 4,4).
  • As avaliações marcadas precisam estar visíveis na página.
  • Não é permitido agregar avaliações de outros sites.
  • As notas devem vir de usuários, não de editores que criam ou compilam notas.
  • Avaliações falsas ou incentivadas sem divulgação são proibidas e podem gerar ação manual.
  • Para LocalBusiness e Organization, avaliações controladas pela própria entidade, inclusive por widget de terceiros, tornam a página inelegível a estrelas.

A última regra trata de empresas, e não de produtos. Se a sua loja usa um widget próprio de avaliações em páginas de Product, a documentação lida não diz com todas as letras que a restrição se aplica igual; trate como risco e teste. Para o contexto das regras sobre notas incentivadas, veja o post sobre reviews falsas no schema de avaliações.

Passo 4: variantes, frete e devolução

Produtos com tamanho ou cor usam ProductGroup, conforme a documentação de variantes. O grupo exige name, e cada variante precisa de sku ou gtin único, ligado ao grupo por inProductGroupWithID ou isVariantOf. Cada variante deve ter URL própria, com imagem, preço e disponibilidade corretos. A propriedade variesBy descreve o que varia (cor, tamanho, material e outros).

Em devolução, a opção mais simples exige applicableCountry e returnPolicyCategory, com merchantReturnDays quando a janela é finita. Em frete, o nível da oferta usa OfferShippingDetails, com valor, destino e prazo. O ponto de atenção é a consistência: o que está no markup precisa bater com o que a página mostra e com o que a loja pratica.

Passo 5: onde implantar e como validar

Prefira que o markup de Product esteja no HTML inicial da página. A documentação de listagens avisa que o markup gerado por JavaScript pode ser rastreado com menos frequência e confiabilidade. Em plataformas como a Shopify, o filtro structured_data do Liquid gera Product, ou ProductGroup quando há variantes, com nome, imagem, descrição, marca e oferta, de acordo com a documentação para desenvolvedores. O exemplo oficial não traz avaliações, então verifique no tema real o que é gerado e o que vem de apps. Para as particularidades de cada plataforma, veja os guias de SEO para Shopify, VTEX e WooCommerce.

  1. Rode a página no teste de resultados multimídia do Google e na Inspeção de URL do Search Console, que a documentação de políticas gerais recomenda.
  2. Compare, campo a campo, o preço e a disponibilidade do markup com o que aparece na tela.
  3. Confira se há mais de um bloco Product na mesma página (tema, plugin e app de avaliações).
  4. Acompanhe os relatórios de rich results no Search Console depois de publicar.
  5. Repita o teste sempre que mudar o tema, o plugin de SEO ou o app de avaliações.

Um alerta que a própria documentação faz: markup válido não garante exibição. E, para a busca com IA, o Google diz que não há requisitos adicionais nem schema especial para aparecer em AI Overviews ou no Modo IA, de acordo com a página sobre recursos de IA na Busca. O markup continua útil porque deixa os dados consistentes, mas não é um atalho.

Erros comuns em dados estruturados de produto

A tabela de cada grupo mostra o erro, por que ele distorce o resultado e como corrigir. As regras vêm da documentação do Google e do Merchant Center; a frequência real em lojas brasileiras não foi medida.

Erros de valor e de formato

ErroPor que distorceComo corrigir
Preço com vírgula ou “R$”O valor deixa de ser lido como número e a oferta fica inválidaUsar 399.90 em price e BRL em priceCurrency
Preço do markup diferente do da páginaViola a regra de que o markup deve refletir o que o cliente vê e gera divergência com o Merchant CenterGerar o preço do markup a partir da mesma fonte que renderiza a página
Availability sem sincronia com o estoqueMostra produto disponível quando não está, o que prejudica a confiançaAtualizar o valor junto com o estoque e usar um único valor da lista oficial
priceValidUntil no passadoPode impedir a exibição do snippetRemover a propriedade ou renovar a data automaticamente
Tabela: Analytikos, com base na documentação do Google e do schema.org

Erros de estrutura e de conteúdo

ErroPor que distorceComo corrigir
Página sem offers, só com nameA listagem exige offers; no snippet, offers sem avaliação gera avisoIncluir Offer com price e priceCurrency
AggregateOffer em página de comerciante ou em variantesA listagem exige Offer, e variantes não aceitam AggregateOfferUsar Offer por variante dentro de ProductGroup
Marcação em conteúdo ocultoA política diz para não marcar o que o usuário não vêMarcar apenas o que está visível
Markup duplicado por tema, plugin e appPode gerar dados conflitantes (a duplicidade em si não consta como regra da documentação lida)Auditar e manter uma única fonte por tipo
Variantes sem sku ou gtin únicosO Google não consegue distinguir as variantesDefinir sku ou gtin por variante e URL própria
Tabela: Analytikos, com base na documentação do Google

Erros de avaliações e de interpretação

ErroPor que distorceComo corrigir
Review sem authorAuthor é obrigatório, com nome válidoIncluir nome da pessoa ou da organização
AggregateRating sem contagem ou com vírgulaFalta ratingCount ou reviewCount e o decimal fica inválidoInformar a contagem e usar ponto decimal
Marcar só algumas avaliações visíveis, ou agregar avaliações de outros sitesContraria as diretrizes e pode levar a ação manualMarcar todas as avaliações visíveis, só de usuários do seu site
Esperar que o schema garanta rich result ou citação por IAMarkup válido não garante exibição, e a IA não exige schema especialTratar o markup como base de consistência, não como atalho
Tabela: Analytikos, com base na documentação do Google

Checklist de dados estruturados de produto

  • Product com name, image e offers em toda página de compra.
  • Offer com price em formato numérico e priceCurrency em BRL.
  • Availability com um único valor oficial, sincronizado com o estoque.
  • gtin, marca e sku preenchidos quando existirem.
  • Avaliações visíveis, de usuários, com author e contagem.
  • Frete e devolução no nível da organização, com exceções na oferta.
  • Variantes em ProductGroup, com URL própria.
  • Teste no Rich Results Test e na Inspeção de URL após cada mudança.
  • Uma única fonte de markup por página.

Perguntas frequentes

Qual a diferença entre snippet de produto e listagem de comerciante?

O snippet vale para páginas em que o usuário não compra direto, como análises. A listagem de comerciante vale para páginas de compra e exige Product com name, image e offers, e Offer com price e priceCurrency.

Como escrever o preço no JSON-LD?

Apenas com dígitos e ponto decimal, como 399.90, sem R$ e sem vírgula. A moeda vai em priceCurrency, com o código BRL.

Preciso de avaliações para ter dados estruturados de produto?

Não para listagens de comerciante. Para snippets de produto, é preciso pelo menos um entre review, aggregateRating ou offers. Se houver avaliações, elas precisam estar visíveis na página.

Posso marcar avaliações de outros sites na minha página?

Não. A documentação proíbe agregar avaliações de outros sites e exige que as notas venham de usuários, não de editores.

Dados estruturados ajudam a aparecer em respostas de IA?

O Google diz que não há requisitos adicionais nem schema especial para os recursos de IA. O markup mantém os dados consistentes, mas não é um atalho.

Como testar se o markup está correto?

Use o teste de resultados multimídia do Google e a Inspeção de URL do Search Console, compare o markup com o que aparece na página e acompanhe os relatórios de rich results.

Frete e devolução ficam no produto ou na organização?

A documentação recomenda o nível da organização, e o nível da oferta serve para sobrescrever. Configurações no Merchant Center ou no Search Console têm precedência sobre o markup.

Conteúdos Relacionados

Compartilhar esse post
Facebook
WhatsApp
LinkedIn
Leia também:

Mais lidas

Carregando posts...

Conteúdos Relacionados:

Receba conteúdos exclusivos e novidades

SEO, GEO, GA4, CRM e IA aplicados a e-commerce, direto no seu e-mail.

Analytikos

Estratégia e resultados baseados em dados. SEO, GEO, CRM e IA para e-commerce, de Itajaí (SC) para o Brasil.

© 2026 Analytikos. Todos os direitos reservados.
Rolar para cima