JSON-LD
JSON-LD (JavaScript Object Notation for Linked Data) é o formato de dados estruturados preferido pela Google: um bloco de script colocado numa página que descreve a entidade nessa página aos motores de busca sem alterar o HTML visível.
O JSON-LD reside numa tag script com o tipo application/ld+json, normalmente no head ou no body da página. Por estar separado do markup renderizado, não mistura atributos pelo HTML à maneira do microdata e do RDFa, o que explica a preferência da Google por este formato e a razão pela qual é o mais simples de adicionar, auditar e remover sem perturbar o layout. Cada bloco é um objeto autónomo com um @context que aponta para o vocabulário schema.org e um @type que identifica a entidade, permitindo a uma máquina ler a página como dados em vez de inferir o significado a partir do texto.
Um único bloco pode descrever um produto, um artigo, uma organização, uma hierarquia de navegação (breadcrumb) ou classificações de avaliações agregadas, e vários blocos podem coexistir na mesma página. O formato é simplesmente JSON, pelo que é simples para um template gerar e para um validador ler, e pode ser injetado após o carregamento da página por gestores de tags quando não é possível editar o template diretamente. As entidades podem também ser ligadas por referência com @id, de modo que um bloco Product pode apontar para a Organisation que o vende sem repetir os detalhes da marca na íntegra.
Considere uma loja Shopify a vender cerâmica artesanal do Alentejo. O template de produto renderiza um bloco AggregateRating com ratingValue de 4,7 sobre reviewCount de 213, um bloco Offer com price 24,00 e priceCurrency EUR e availability definida como InStock, e um bloco Organization separado em todas as páginas a descrever o ateliê e o seu logótipo. Quando o lojista lança uma promoção de fim de época, o tema tem de regenerar o preço no JSON no mesmo momento em que o altera na página; caso contrário, os dois ficam dessincronizados. Se um produto se esgotar, a availability tem de passar a OutOfStock no markup, ou a Google pode continuar a apresentar um preço e um estado de stock que já não correspondem à realidade.
O JSON-LD também importa para os motores de resposta com IA. O ChatGPT, o Perplexity e o Google AI Overviews recorrem a sinais limpos e interpretáveis quando decidem o que é uma página e se a devem citar, e um bloco bem formado elimina a ambiguidade sobre o nome do produto, o preço, a classificação e o vendedor. Não é garantia de citação, e estes sistemas continuam a ler o texto visível, mas os dados estruturados reduzem o custo de compreensão da página e tornam os factos essenciais mais difíceis de interpretar de forma incorreta.
O aviso honesto é que o JSON-LD tem de corresponder ao que o visitante vê efetivamente. A Google trata dados estruturados que afirmam classificações, preços ou conteúdo não presentes na página como uma violação das suas diretrizes, podendo suprimir rich snippets ou emitir uma ação manual. Convém manter o JSON sincronizado com o conteúdo visível, validá-lo após alterações ao template e tratá-lo como uma descrição fiel da página em vez de um espaço para fazer afirmações adicionais.