JSON-LD

O JSON-LD fica em uma tag script com o tipo application/ld+json, normalmente no head ou no body da página. Por ficar separado do HTML renderizado, não mistura atributos ao longo da marcação como fazem microdata e RDFa. É por isso que o Google o recomenda e por isso que é o formato mais fácil de adicionar, auditar e remover sem afetar o layout. Cada bloco é um objeto autocontido com um @context que aponta para o vocabulário schema.org e um @type que nomeia a entidade, permitindo que uma máquina leia a página como dado estruturado em vez de tentar adivinhar o significado pelo texto.

Um único bloco pode descrever um produto, um artigo, uma organização, um breadcrumb ou classificações de avaliações agregadas, e vários blocos podem coexistir na mesma página. O formato é JSON puro, o que facilita a geração por templates e a leitura por validadores, além de permitir a injeção após o carregamento da página via tag managers quando não é possível editar o template diretamente. Também é possível vincular entidades por referência usando @id, de modo que um bloco de Product pode apontar para a Organização que o vende sem repetir os dados da marca.

Considere uma loja Shopify que vende cosméticos naturais. O template de produto renderiza um bloco AggregateRating com ratingValue de 4,7 sobre reviewCount de 213, um bloco Offer com price de 110,00, priceCurrency BRL e availability definida como InStock, além de um bloco Organisation separado em todas as páginas descrevendo a marca e seu logo. Quando o lojista realiza uma promoção, o tema precisa atualizar o preço no JSON no mesmo momento em que altera o preço na página, caso contrário os dois ficam desalinhados. Se um produto esgota, availability precisa mudar para OutOfStock na marcação também, ou o Google pode continuar exibindo um preço e uma disponibilidade que já não existem.

O JSON-LD também importa para os motores de resposta com IA. ChatGPT, Perplexity e Google AI Overviews se apoiam em sinais limpos e legíveis por máquina para decidir o que uma página descreve e se ela merece ser citada. Um bloco bem formado elimina a ambiguidade sobre o nome do produto, preço, classificação e vendedor. Não é uma garantia de ser mencionado, e esses sistemas ainda leem o texto visível, mas os dados estruturados reduzem o custo de interpretação da página e tornam os fatos-chave mais difíceis de serem lidos de forma incorreta.

A ressalva importante é que o JSON-LD precisa corresponder ao que o visitante realmente vê. O Google trata dados estruturados que afirmam classificações, preços ou conteúdos não presentes na página como uma violação das diretrizes, podendo suprimir rich results ou aplicar uma ação manual. Mantenha o JSON sincronizado com o conteúdo visível, valide após alterações no template e trate o JSON-LD como uma descrição fiel da página, não como espaço para fazer afirmações extras.