Fundamentos de dados estruturados JSON-LD

Dados estruturados são JSON legível por máquina que descreve o assunto da página — um artigo, uma receita, um produto ou um evento. Os mecanismos de busca usam esses dados para renderizar resultados aprimorados (avaliações com estrelas, cartões de receitas e trilhas de navegação), em vez de simples links azuis.

O formato preferido do Google é JSON-LD: um único bloco <script type="application/ld+json"> no cabeçalho ou no corpo, contendo um ou mais objetos schema.org. Ele é separado do HTML visível, portanto adicioná-lo ou atualizá-lo não exige reescrever o modelo.

Todo objeto JSON-LD precisa de @context (quase sempre "https://schema.org") e @type (a classe schema.org: Article, Recipe, Product, FAQPage). @context informa aos analisadores de qual vocabulário vêm os nomes das propriedades.

Para Article, forneça headline, image (uma URL ou matriz), datePublished, dateModified, author (um objeto Person ou Organization) e publisher (Organization com logotipo). Esses são os campos mínimos necessários para que o Google considere a página para o carrossel de principais notícias.

Páginas de produtos declaram @type Product com name, image, description, brand, sku e um subobjeto offers contendo price, priceCurrency e availability. Combinado com aggregateRating, o Google pode renderizar avaliações com estrelas e trechos de preço diretamente no resultado da busca.

BreadcrumbList descreve a hierarquia de navegação. Cada itemListElement é um ListItem com position, name e item (a URL). Quando presente, o Google substitui a linha da URL no trecho pelo caminho de navegação identificado, o que gera mais cliques.

Os esquemas de página de FAQ e HowTo anteriormente desbloqueavam componentes de resultados avançados na SERP. Desde então, o Google restringiu os resultados avançados de FAQ a algumas categorias de sites (gov, edu), mas a marcação ainda é valiosa para assistentes de voz e outros consumidores — mantenha-a em páginas reais de FAQ.

O Google penaliza marcações que não correspondem ao que os usuários veem. Não declare uma classificação de 5 estrelas que não apareça na página; não liste um preço de US$ 9,99 que o usuário nunca vê. Os dados estruturados devem descrever com precisão o conteúdo renderizado.

O Teste de resultados avançados do Google (search.google.com/test/rich-results) analisa qualquer URL ou código colado, lista os tipos de esquema detectados e avisa sobre propriedades obrigatórias ausentes. Execute-o antes de publicar qualquer alteração nos dados estruturados.

Você pode declarar vários blocos JSON-LD na mesma página (Artigo + BreadcrumbList + Organização, por exemplo) ou combiná-los em uma única matriz @graph. As duas formas são válidas; escolha a que for mais fácil de incluir em modelos no seu fluxo de compilação.

O JSON-LD fica em um elemento script separado do conteúdo visível. Para atualizá-lo, gere novamente o bloco JSON — nunca injete dados estruturados apenas por meio de JavaScript no cliente, pois o Googlebot nem sempre executa JS de forma confiável antes da indexação.

Quais duas propriedades de nível superior todo objeto JSON-LD deve incluir para que os dados estruturados sejam válidos?

O JSON-LD declara dados estruturados em um único bloco de script application/ld+json, com @context e @type identificando cada objeto. Esquemas comuns (Artigo, Produto, BreadcrumbList) desbloqueiam resultados avançados de pesquisa quando a marcação reflete com precisão a página visível. Valide com o Teste de resultados avançados antes da publicação.