O que é JSON-LD?
JSON-LD é um formato para escrever dados estruturados, ou seja, para descrever ao buscador o que existe em uma página usando um vocabulário padronizado. A sigla significa JavaScript Object Notation for Linked Data e é usada assim em português. A marcação fica em um bloco <script type="application/ld+json">, separada do conteúdo visível.
O JSON-LD responde a uma limitação do HTML, que informa a existência de um texto sem dizer que aquele texto é o preço de um produto ou a data de um evento. Os dados estruturados fornecem essa camada de significado, com o vocabulário do Schema.org. O JSON-LD é o formato recomendado pelo Google entre as três opções existentes, junto de microdata e RDFa, e sua vantagem prática está no isolamento em um único bloco.
Como funciona na prática?
O JSON-LD funciona em três etapas:
- Escolha do tipo: você identifica o que a página representa no Schema.org: Product, Article, FAQPage, LocalBusiness, Event, entre dezenas de tipos.
- Preenchimento: você descreve as propriedades em pares de chave e valor, como nome, preço e disponibilidade, sempre refletindo o que está visível.
- Inserção: você coloca o bloco no HTML, direto no template ou por gerenciador de tags.
Quando a marcação está correta e a página se qualifica, o resultado pode ganhar um rich snippet. A regra de ouro: a marcação precisa descrever o que o usuário vê. Marcar preço ou avaliação que não existem na página viola as diretrizes de spam do Google.
Exemplos de uso
- Loja de instrumentos: cada página de produto traz Product com nome, preço em reais e nota média, e o resultado passa a exibir preço e estrelas.
- Clínica veterinária: o site marca LocalBusiness com endereço, telefone e horário, alinhando os dados à ficha do negócio no Google.
Erros comuns
- Marcar dados que não aparecem na página, o que viola as diretrizes e pode gerar penalização.
- Manter marcação desatualizada, como preço antigo, depois que a página mudou.
- Marcar avaliações da empresa inteira em todas as páginas de produto, o que o Google não aceita.
Perguntas frequentes sobre JSON-LD
JSON-LD melhora o ranqueamento?
Os dados estruturados não são fator de ranqueamento direto segundo o Google. O ganho é de apresentação e compreensão: o resultado pode exibir rich snippets, que aumentam o destaque na página de busca, e o buscador entende melhor as entidades da página. O efeito no tráfego vem por esses caminhos.
Como testar se meu JSON-LD está correto?
Use o Teste de Resultados Aprimorados do Google para verificar se a página se qualifica a algum recurso e o validador do Schema.org para conferir a sintaxe. O relatório de aprimoramentos do Google Search Console mostra erros e avisos do site inteiro após o rastreamento das páginas.
JSON-LD funciona se for inserido por JavaScript?
Funciona, desde que o Google consiga renderizar a página e ler o bloco. A inserção via gerenciador de tags é aceita, porém depende da renderização, o que adiciona um ponto de falha. Colocar o JSON-LD direto no HTML servido é o caminho mais previsível.