JSON-LD (JavaScript Object Notation for Linked Data) é um formato de dados estruturados que ajuda os mecanismos de busca a entenderem do que suas páginas realmente tratam. Em vez de adivinhar somente pelo seu conteúdo HTML, os mecanismos de busca podem ler um bloco JSON-LD e saber exatamente se uma página descreve uma receita, um produto, um negócio local ou um artigo de notícia. O formato usa um bloco <script type="application/ld+json"> embutido no seu HTML, invisível aos visitantes, mas totalmente legível por máquinas.
O que dados estruturados informam aos mecanismos de busca
Pense em dados estruturados como uma camada de tradução entre seu site e o Google. Sua página pode mencionar "49,99" em algum lugar do texto, mas sem dados estruturados, o Google não tem ideia se isso é um preço, uma avaliação ou apenas um número aleatório. O JSON-LD remove essa ambiguidade encapsulando seu conteúdo em campos claramente rotulados que seguem o vocabulário do Schema.org.
O Google usa essas informações para vários fins:
- Rich snippets: resultados de busca aprimorados que exibem avaliações em estrelas, preços, tempos de preparo, respostas de FAQ ou datas de eventos diretamente na página de resultados. Eles se destacam visualmente das listagens regulares e tendem a atrair mais cliques.
- Knowledge Graph: quando o Google constrói aqueles painéis de informação à direita dos resultados de busca (para empresas, pessoas ou lugares), os dados estruturados são uma das principais fontes de onde ele extrai informação.
- Busca por voz e assistentes: o Google Assistente e ferramentas similares puxam respostas de dados estruturados. Se sua página de FAQ tem marcação JSON-LD adequada, suas respostas podem ser lidas em voz alta para os usuários.
- Listagens do Google Shopping e Merchant: dados estruturados de produto podem alimentar listagens gratuitas em resultados do Google Shopping, dando visibilidade sem pagar por anúncios.
JSON-LD vs. Microdata vs. RDFa
Existem três formas de adicionar dados estruturados a uma página, e todas alcançam o mesmo objetivo, mas funcionam de forma bem diferente na prática:
- JSON-LD: um bloco de script independente, normalmente colocado no
<head>ou no fim do<body>. Não toca em nada no markup HTML. Você pode adicionar, modificar ou remover sem afetar o layout visual da página. O Google recomenda oficialmente esse formato. - Microdata: atributos adicionados diretamente nos elementos HTML (
itemscope,itempropetc.). Isso significa que seus dados estruturados ficam entrelaçados com o código do template, tornando a manutenção mais difícil e mais propensa a quebrar quando você troca de tema. - RDFa: similar ao Microdata em usar atributos HTML, mas segue uma especificação diferente. É mais comum em contextos não-Google e tem suporte menos amplo nos plugins do WordPress.
Para sites WordPress, o JSON-LD é claramente o vencedor. Ele mantém seus templates limpos, funciona bem com plugins de cache e pode ser gerado dinamicamente em PHP sem alterar os arquivos do tema.
Tipos comuns de Schema.org para sites WordPress
O Schema.org define centenas de tipos, mas apenas alguns são comumente relevantes para sites WordPress. Aqui estão os que você encontrará com mais frequência:
- Article / BlogPosting: usado em posts de blog e artigos de notícia. Inclui headline, autor, data de publicação e imagem destacada. É o tipo mais comum em sites WordPress e pode disparar resultados ricos no estilo artigo no Google.
- FAQPage: marca páginas com conteúdo de perguntas e respostas. Quando o Google reconhece, pode exibir snippets de FAQ expansíveis diretamente nos resultados de busca, o que pode aumentar significativamente o espaço ocupado pela sua listagem.
- HowTo: para conteúdo de tutorial ou passo a passo. O Google pode exibir os passos individuais nos resultados de busca, às vezes com imagens para cada passo.
- Product: essencial para lojas WooCommerce. Inclui preço, disponibilidade, avaliações e marca. É isso que habilita resultados ricos no estilo produto, com preços e avaliações em estrela.
- LocalBusiness: para negócios com localização física. Inclui endereço, horário de funcionamento, telefone e coordenadas geográficas. Alimenta o Google Maps e os resultados de busca local.
- BreadcrumbList: descreve o caminho de navegação até a página atual. O Google usa isso para exibir links de breadcrumb nos resultados de busca em vez da URL bruta, o que fica mais limpo e ajuda os usuários a entenderem a estrutura do seu site.
- WebSite: colocado na página inicial, esse tipo pode habilitar a caixa de busca de sitelinks no Google, permitindo que usuários pesquisem seu site diretamente da página de resultados.
Como plugins de SEO do WordPress geram JSON-LD
A maioria dos proprietários de sites WordPress não escreve JSON-LD à mão. Em vez disso, os plugins de SEO cuidam disso automaticamente:
- Yoast SEO: gera um grafo JSON-LD abrangente em todas as páginas, incluindo os tipos WebSite, WebPage, Organization (ou Person), Article e BreadcrumbList. O Yoast monta um grafo conectado em que todas as entidades referenciam umas às outras, o que dá ao Google uma visão completa do seu site.
- Rank Math: oferece geração automática semelhante, mas também fornece uma interface para adicionar tipos de schema personalizados a posts individuais. Você pode marcar um post como Recipe, Event ou Course sem escrever código.
- Schema Pro e outros plugins dedicados: se você precisa de controle mais granular (por exemplo, adicionar múltiplos tipos de schema a uma única página ou lidar com estruturas aninhadas complexas), plugins de schema dedicados oferecem essa flexibilidade.
Uma observação importante: não use múltiplos plugins que geram JSON-LD ao mesmo tempo. Dados estruturados duplicados ou conflitantes confundem os mecanismos de busca e podem resultar em nenhum dos seus rich snippets sendo exibido.
Um exemplo prático de JSON-LD
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "What is JSON-LD?",
"author": {
"@type": "Person",
"name": "John Doe"
},
"datePublished": "2025-01-15",
"dateModified": "2025-03-10",
"publisher": {
"@type": "Organization",
"name": "Example Site",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"image": "https://example.com/article-image.jpg",
"description": "A comprehensive guide to JSON-LD structured data."
}Note como tudo está autossuficiente em um único bloco. Você poderia colar isso em qualquer página sem modificar um único elemento HTML, e os mecanismos de busca entenderiam imediatamente que a página descreve um artigo escrito por John Doe.
Testando e validando seus dados estruturados
Antes de confiar nos seus dados estruturados para gerar resultados ricos, você deve validá-los. O Google fornece duas ferramentas para isso:
- Rich Results Test (search.google.com/test/rich-results): insira uma URL ou cole seu código e o Google mostra quais tipos de resultado rico estão elegíveis e se há erros ou avisos.
- Schema Markup Validator (validator.schema.org): um validador mais geral que checa sua marcação contra a especificação completa do Schema.org, não apenas o subconjunto que o Google suporta.
Execute essas verificações depois de fazer alterações nas configurações do seu plugin de SEO ou após trocar de tema. Mudanças de tema às vezes podem remover ou duplicar blocos de dados estruturados.
Impacto sobre as taxas de clique
O retorno prático dos dados estruturados é melhor visibilidade nos resultados de busca. Páginas com rich snippets ocupam mais espaço visual na página de resultados e fornecem mais informação à primeira vista. Estudos e relatórios da indústria consistentemente mostram que resultados ricos podem aumentar a taxa de cliques em 20 a 30 por cento em comparação com listagens simples. Snippets de FAQ, em particular, podem dobrar a altura do seu resultado de busca, empurrando os concorrentes mais para baixo na página. Mesmo se sua posição de ranking se mantiver, mais destaque visual significa mais cliques.
Dito isso, o Google não garante resultados ricos para toda página com dados estruturados. Depende da qualidade do seu conteúdo, de o Google considerar a marcação confiável e de quão competitiva é a query de busca.
O que o InspectWP verifica
O InspectWP varre o seu site WordPress em busca de blocos de dados estruturados JSON-LD e relata quais tipos do Schema.org estão presentes. Verifica se suas páginas incluem os tipos mais comuns (Article, BreadcrumbList, WebSite) e sinaliza páginas onde os dados estruturados estão totalmente ausentes. Isso ajuda a identificar lacunas na sua marcação e garantir que seu plugin de SEO esteja gerando a saída correta em todo o site.