Teste de Dados Estruturados: Como Depurar Erros de Schema nas Ferramentas do Google

As Ferramentas Não São Infalíveis

Pela minha experiência, JSON-LD perfeitamente válido passa no Rich Results Test e depois falha em gerar rich results por semanas. Por quê? Porque a ferramenta de teste valida a sintaxe, não o contexto.

Veja como depurar schema de verdade.

Etapa 1: Comece pelo Validador do Schema.org

Antes de tocar nas ferramentas do Google, cole seu JSON-LD no validador do Schema.org. Ele detecta problemas estruturais que as ferramentas do Google deixam passar. Especificamente: hierarquias de @type ausentes, aninhamento incorreto de propriedades e incompatibilidades de enum.

No mês passado, encontrei um cliente usando @type: "Product" com brand como uma string em vez de brand: { @type: "Brand", name: "..." }. O Rich Results Test passou. O validador do Schema.org sinalizou imediatamente.

Etapa 2: O Rich Results Test É para Pré-visualização, Não para Validação

A própria documentação do Google diz que esta ferramenta "mostra quais rich results podem ser gerados". Observe a palavra "podem". Isso não significa que eles serão gerados.

O detalhe: Se sua página passa no Rich Results Test, mas você não vê rich results no relatório de Performance do Search Console depois de duas semanas, verifique:

• A página está realmente indexada? (use a Ferramenta de Inspeção de URL)
• A página precisa de dateModified para o schema de Article? (85% dos rich results de Article ignorados que depuramos não têm data)
• A página está competindo com outro tipo de rich result? (breadcrumb + product podem entrar em conflito)

Etapa 3: O Relatório de Rich Results do Search Console

Esta é a sua fonte da verdade. As mensagens de erro são enigmáticas, mas mapeiam diretamente para a especificação do schema.org.

Avisos comuns decodificados:

• "Missing field 'image'" no schema de Article — seu objeto image está malformado. Ele precisa de @type: "ImageObject" com url, não apenas uma URL em string.
• "Missing field 'price'" no schema de Product — verifique se há espaços em branco na propriedade de preço do seu offers. Um espaço antes de "99.99" vai falhar. Sim, realmente.
• "Invalid value for 'review'" — seu reviewRating está sem o bestRating. Se você definir uma avaliação de 5, o Google precisa saber a escala.

Etapa 4: A Ferramenta de Inspeção de URL

Esta é a única ferramenta que mostra o que o Google realmente analisou. Execute a URL, clique em "Ver página rastreada" e olhe a aba de dados estruturados. Se estiver diferente do que você vê no Rich Results Test, o Googlebot ainda não rastreou novamente. Solicite a indexação e aguarde 24 horas.

Etapa 5: Schema Markup Validator (Extensão do Chrome)

Para depuração rápida enquanto você navega, a extensão Schema Markup Validator destaca todo o schema de uma página. Eu a uso para verificar o schema de breadcrumb em todas as páginas de um site em minutos.

Mais uma coisa: Se você está usando JSON-LD por meio de um gerenciador de tags, o Google às vezes não executa os scripts do GTM antes de analisar o schema. Coloque-o inline. Sempre.