Dados estruturados de Product: o passo a passo para auditar o JSON-LD no Search Console

Dados estruturados de Product: o passo a passo para auditar o JSON-LD no Search Console

Nota da redação: este artigo descreve comportamentos específicos de interface do Search Console (segmentação dos relatórios de Melhorias, latência de atualização do relatório agregado) e do Rich Results Test (indicação de quais propriedades foram lidas) com base na experiência prática do autor. Essas afirmações não estão documentadas na fonte oficial consultada, que trata apenas do conceito de dados estruturados de Product, e podem variar ou mudar sem aviso. O conteúdo conceitual sobre schema (snippets vs. merchant listings, sobreposição entre eles, bloco Organization e uso de dados do feed) foi conferido e confere com a documentação oficial do Google.

A documentação de dados estruturados de Product do Google lista os campos que decidem se uma página de produto aparece em resultados ricos e no Shopping, mas boa parte dos e-commerces brasileiros ainda publica JSON-LD incompleto. Veja como auditar, corrigir e revalidar isso no Search Console.

A documentação oficial do Google Search Central sobre dados estruturados de Product (atualizada em 10 de dezembro de 2025) separa dois caminhos de marcação: snippets de produto, para páginas que não vendem diretamente, e dados do comerciante (merchant listing), para quem vende. Os dois se sobrepõem: preencher os atributos do comerciante costuma qualificar a página também para snippets. Na prática, isso significa que quem só marca o básico (name, image, preço) está deixando elegibilidade na mesa, tanto no card de Shopping quanto nas experiências de busca que leem a mesma fonte estruturada.

O problema não é novidade de schema: é descuido de manutenção. Catálogo cresce, campo de review some num redesign, feed do Merchant Center diverge do JSON-LD da página, e ninguém percebe até o produto cair do card de compras. Este passo a passo é o caminho que eu seguiria para encontrar e fechar esses buracos usando só o Search Console e as próprias ferramentas do Google.

O que é mínimo e o que é bônus

A página introdutória da documentação não fecha uma lista única de "campos mínimos" por marcação; essa granularidade vive nas páginas de requisitos específicos de cada tipo, que não fazem parte da fonte consultada aqui. Na prática de implementação, porém, o resumo abaixo reflete a recomendação comum de mercado para o que costuma travar elegibilidade e o que é enriquecimento opcional:

Shipping (shippingDetails), queda de preço e prós/contras (positiveNotes/negativeNotes dentro de review) são enhancements: eles melhoram a aparência do resultado, mas sua ausência não derruba a elegibilidade básica. Confundir os dois tipos de campo é o erro mais comum que eu vejo em auditoria de e-commerce↳E-commerce21 conteúdosECBR Club: novo espaço para devs se conectarem ao ecossistema de e-commerceDev (Back & Front) · mai 2025TOTVS anuncia joint venture com VTEXMarketing Tech · mai 2019Jovens da Brasilândia recebem formação gratuita em tecnologiaGestão Dev & TI · jul 2025Ver tudo em Marketing Tech →.

Passo 1: comece pelo relatório que o Google já te dá

No Search Console, abra os relatórios de Melhorias referentes a snippet de produto e a anúncios de comerciantes. Na minha experiência de auditoria, esse tipo de relatório tende a segmentar os itens por status e por tipo de problema, o que ajuda a localizar mais rápido as URLs afetadas; vale conferir diretamente no painel como a categorização aparece no seu caso, já que esse comportamento específico não está documentado na página de Product structured data consultada aqui.

Esse relatório é agregado e pode levar dias para refletir uma correção recente, mas é o ponto de partida mais barato: ele costuma segmentar o problema por tipo de campo faltante, sem você precisar varrer o catálogo inteiro manualmente.

Passo 2: confira o JSON-LD linha por linha

Para cada padrão de URL encontrado no passo 1, rode o Rich Results Test (search.google.com/test/rich-results) com a URL real da página. Na minha experiência, a ferramenta costuma indicar quais propriedades do @type: Product foram lidas e quais ficaram de fora, o que ajuda a localizar o campo problemático, embora esse comportamento específico não esteja descrito na documentação oficial consultada aqui.

Um bloco de Product completo para dados do comerciante costuma se parecer com isto:

{
 "@context": "https://schema.org/",
 "@type": "Product",
 "name": "Tênis Trail Runner X",
 "image": "https://exemplo.com.br/img/tenis-x.jpg",
 "description": "Tênis de corrida para trilha, solado em EVA.",
 "sku": "TRX-42-PT",
 "brand": { "@type": "Brand", "name": "Marca Exemplo" },
 "offers": {
 "@type": "Offer",
 "price": "399.90",
 "priceCurrency": "BRL",
 "availability": "https://schema.org/InStock",
 "priceValidUntil": "2026-12-31",
 "shippingDetails": {
 "@type": "OfferShippingDetails",
 "shippingRate": { "@type": "MonetaryAmount", "value": "0", "currency": "BRL" }
 }
 },
 "aggregateRating": {
 "@type": "AggregateRating",
 "ratingValue": "4.6",
 "reviewCount": "128"
 }
}

Se o teste apontar que aggregateRating ou offers.priceCurrency não foi lido, o problema geralmente é sintático: vírgula faltando, @type errado dentro do objeto aninhado, ou o script application/ld+json indo para uma página diferente da testada (comum em templates com cache agressivo).

Passo 3: não esqueça o schema de Organization

Política de devolução e programa de fidelidade não ficam dentro do Product: eles vivem num bloco Organization à parte, com hasMerchantReturnPolicy e, quando aplicável, um MemberProgram. Página de produto perfeita sem esse bloco continua sem o selo de devolução no card de Shopping. Vale auditar o template de rodapé ou de header onde esse JSON-LD costuma ficar centralizado, porque ele é fácil de esquecer quando a equipe só olha a página de produto.

Passo 4: corrija, publique e peça nova indexação

Depois de ajustar o JSON-LD:

1. Suba a correção para produção.
2. Rode o Rich Results Test de novo na URL já publicada para confirmar que todos os campos aparecem como válidos.
3. Use a ferramenta de Inspeção de URL no Search Console para verificar o status da página e, se o recurso estiver disponível na sua conta, solicite uma nova indexação na tentativa de acelerar o recrawl daquela página específica.
4. Se o e-commerce também usa feed do Merchant Center, confira se price e availability do feed batem com o JSON-LD da página: segundo a documentação, o Google pode usar dados de preço do feed quando eles estiverem ausentes no schema, então manter as duas fontes alinhadas ajuda a evitar inconsistências que prejudiquem a qualidade dos dados exibidos.

O que pode dar errado

Em resumo: a correção no código raramente é o ponto que falha; o atraso está no que vem depois dela. Alguns tropeços recorrentes:

• A página tem noindex ou está bloqueada em robots.txt: nenhum dado estruturado é lido, não importa quão correto esteja o JSON-LD.
• O CDN ou o cache de página serve a versão antiga por horas depois do deploy, então o Rich Results Test parece falhar mesmo com o código já certo.
• O relatório agregado do Search Console demora para atualizar: a validação pontual por URL é mais confiável no curto prazo do que esperar o painel geral mudar de número.
• Catálogos grandes corrigem o template, mas produtos antigos gerados por snapshot estático continuam servindo o JSON-LD velho até o próximo build.

Como medir se funcionou

O sinal mais direto é o próprio relatório de Melhorias voltando a contar aquele item como válido, não mais como erro. Para o efeito em tráfego, compare no relatório de Performance do Search Console os cliques e impressões daquele grupo de URLs nas semanas antes e depois da correção.

Vale uma ressalva: a documentação do Google não cita por nome as visões gerais de IA↳Inteligência artificial440 conteúdosUX e IA: Transformando Experiências Digitais com Inteligência ArtificialProduto & UX · jan 2025MCP: O que é e por que você vai ouvir falar disso em breve?AI · jul 2025IA generativa e a urgência de reconstruir nossa relação com a verdadeAI · jun 2025Ver tudo em AI → como consumidoras diretas desse schema. Mas como essas superfícies e o Shopping tendem a se apoiar nos mesmos sinais de conteúdo estruturado da página, é razoável supor, na minha leitura, que um JSON-LD de Product completo ajuda a página a ser lida com mais confiança por qualquer camada que sintetize resultado, generativa ou não. Isso é inferência, não garantia documentada pela fonte.

Fonte 1: Google Search Central — Product structured data (https://developers.google.com/search/docs/appearance/structured-data/product)

Intro to Product Structured Data on Google | Google Search Central | Documentation | Google for Developers

Skip to main content

Search Central

English

Deutsch

Español

Español – América Latina

Français

Indonesia

Italiano

Polski

Português – Brasil

Tiếng Việt

Türkçe

Русский

العربيّة

हिंदी

ภาษาไทย

中文 – 简体

中文 – 繁體

日本語

한국어

Sign in

Documentation

Search Console

Home

Send feedback

Introduction to Product structured data

When you add structured data to your product pages, your product information can appear in richer ways in Google Search results (including Google Images and Google Lens ). For example, users can see price, availability, review ratings, shipping information, and more right in search results.

Deciding which markup to use

There are two main classes of product structured data. Follow the requirements for the type that best suits your use case:

Product snippets : For product pages where people can't directly purchase the product. This markup has more options for specifying review information, like pros and cons on an editorial product review page.

Merchant listings : For pages where customers can purchase products from you. This markup has more options for specifying detailed product information, like apparel sizing , shipping details , and return policy information.

Note that there is some overlap between the two product features. In general, adding the required product information properties for merchant listings means that your product pages can also be eligible for product snippets. Both features have their own enhancements, so be sure to review both when deciding which markup makes sense in the context of your site (the more properties you can add, the more enhancements your page can be eligible for).

In addition to structured data for the individual products that you sell, we also recommend you add structured data defining the policies of your ecommerce business, nested under Organization markup:

Merchant return policy : Specify the return policy (or policies) for your business.

Loyalty Program : Specify the loyalty program that you offer.

How shopping experiences can appear on Google Search

Here's how shopping experiences can appear in Google Search results. This list is not exhaustive—Google Search is constantly exploring new and better ways to help people find what they're looking for, and the experiences may change over time.

Product snippet

A text result that includes additional product information such as ratings, review information, price, and availability

Popular products

Visually rich presentation of products for sale

Shopping knowledge panel

Detailed product information with a list of sellers (using details such as product identifiers)

Google Images

Annotated images of products available for sale

Result enhancements

Search result enhancements are shown at the discretion of each experience, and may change over time. For this reason, it is recommended to provide as much rich product information as available, without concern for the exact experiences that will use it. Here are some examples of how product rich results may be enhanced:

Ratings : Enhance the appearance of your search result by providing customer reviews and ratings .

Pros and Cons : Identify pros and cons in your product review description so they can be highlighted in search results.

Shipping : Share shipping costs , especially free shipping, so shoppers understand the total cost.

Availability : Provide availability data to help customers know when you have a product in stock.

Price drop : Price drops are computed by Google by observing price changes for the product over time. Price drops are not guaranteed to be shown.

Returns : Share return information , such as your return policy, fees involved in returns, and how many days customers have to return a product.

Providing product data to Google Search

To provide rich product data to Google Search you can add Product structured data to your web pages, upload data feeds with Google Merchant Center and opt into free listings within the Merchant Center console, or both. The Search Central documentation focuses on structured data on web pages.

Providing both structured data on web pages and a Merchant Center feed maximizes your eligibility to experiences and helps Google correctly understand and verify your data. Some experiences combine data from structured data and Google Merchant Center feeds if both are available. For example, product snippets may use pricing data from your merchant feed if it's not present in the structured data on the page. The Google Merchant Center feed documentation includes additional recommendations and requirements for feed attributes.

In addition to Google Search, learn more about eligibility to the Google Shopping tab by reading the data and eligibility requirements in Google Merchant Center .

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java↳Java42 conteúdosNovidades do Java 26 (para desenvolvedores)Dev (Back & Front) · mar 2026Visual Studio Code para Java: o guia completo (dicas, configuração e extensões)Dev (Back & Front) · out 2025Quarkus: Modernizando a linguagem Java para a era da nuvemDev (Back & Front) · nov 2020Ver tudo em Dev (Back & Front) → is a registered trademark of Oracle↳Oracle22 conteúdosOracle lança Java 26 para aumentar produtividade de desenvolvedoresDev (Back & Front) · mar 2026Oracle oferece o primeiro cluster de computação em nuvem em escala ZettaDevSecOps · jan 2025Oracle abre inscrições para o ONE, programa gratuito de formação em tecnologia e inteligência artificialData · dez 2024Ver tudo em Data → and/or its affiliates.

Last updated 2025-12-10 UTC.

Fonte: Google Search Central — Product structured data