- Definição
- JSON-LD: JSON-LD (JSON for Linked Data) é um formato para escrever dados estruturados dentro de uma página, num bloco de código separado do conteúdo visível. É o formato que o Google recomenda para dados estruturados com o vocabulário do schema.org.
Como funciona
JSON é um jeito de escrever dados que qualquer programa entende: pares de nome e valor, entre chaves. O “LD” vem de Linked Data, dados ligados, e indica que esses dados usam um vocabulário público, no caso o schema.org, e podem se referir uns aos outros.
Na prática, o JSON-LD é um bloco de código colocado na página dentro de uma tag <script type="application/ld+json">. Ele não altera nada do que o visitante vê. Serve só para as máquinas.
Um exemplo real
Para uma padaria de bairro, um bloco básico ficaria assim:
{
"@context": "https://schema.org",
"@type": "Bakery",
"name": "Padaria Pão Quente",
"url": "https://padariapaoquente.com.br",
"telephone": "+55 11 3000-0000",
"address": {
"@type": "PostalAddress",
"streetAddress": "Rua das Flores, 120",
"addressLocality": "São Paulo",
"addressRegion": "SP",
"postalCode": "05400-000",
"addressCountry": "BR"
},
"openingHours": "Tu-Su 07:00-19:00",
"sameAs": ["https://www.instagram.com/padariapaoquente"]
}
Os dados são fictícios, mas a estrutura é a mesma que você usaria. @context diz qual vocabulário está sendo usado, @type diz o que a coisa é, e o resto são as propriedades.
Por que o JSON-LD e não outro formato
Existem outros jeitos de escrever dados estruturados, como microdata e RDFa, que misturam as marcações com o HTML visível. O JSON-LD fica num bloco separado, o que tem vantagens práticas: é mais fácil de ler, de gerar por plugin e de manter sem quebrar o layout. É também o formato que o Google recomenda.
Por que importa para o seu negócio
Com um bloco JSON-LD bem feito, qualquer máquina que visite o seu site encontra, num lugar só, quem você é, onde fica e como falar com você. Isso reduz a chance de um assistente misturar a sua empresa com outra de nome parecido, ou de inventar um telefone. Veja alucinação.
Um bloco desses não precisa ficar sozinho. A mesma página pode ter outro bloco descrevendo o caminho até ela (BreadcrumbList) e, numa página de perguntas, um bloco FAQPage. Cada bloco descreve uma coisa, e todos juntos formam um retrato fiel da página para quem a lê de forma automática.
Os erros mais comuns
- JSON inválido. Uma vírgula sobrando ou faltando invalida o bloco inteiro, e a máquina o ignora sem avisar ninguém.
- Informação diferente da página. Um horário no JSON-LD e outro no texto confunde e pode ser tratado como informação enganosa.
- Tipo genérico demais. Usar só Thing ou WebPage quando existe um tipo que descreve a empresa.
- Dados parados no tempo. O endereço mudou, o JSON-LD não.
Como o Mecita olha para isso
A checagem “Dados estruturados” lê cada bloco JSON-LD da página, aponta os que têm JSON inválido e verifica se há um tipo de identidade da empresa. Veja nas checagens.
Perguntas frequentes
Onde o bloco JSON-LD fica na página?
Dentro de uma tag script do tipo application/ld+json, normalmente no cabeçalho ou no corpo do HTML. O visitante não vê nada, mas robôs e buscadores leem.
Como testo se o meu JSON-LD está certo?
O Google oferece o Teste de pesquisa aprimorada e o schema.org tem um validador próprio. Os dois apontam erros de sintaxe e propriedades desconhecidas.
Faltou algum termo? Veja o glossário completo.