Schema Markup pode representar informações de uma página de forma estruturada e apoiar recursos de busca compatíveis, mas não garante presença no ChatGPT ou nos recursos de IA do Google. O Google declara que não há um schema especial necessário para AI Overviews e Modo IA. A implementação deve começar pelo conteúdo real e pelo tipo adequado de entidade.

## Qual problema o JSON-LD resolve?

Schema.org é um vocabulário; JSON-LD é um formato usado para expressá-lo. Em vez de depender apenas de um nome no texto, a marcação pode declarar que uma entidade é uma organização e que ela publicou determinado artigo. Isso não transforma a declaração em fato verificado pelo buscador.

O Google recomenda JSON-LD como formato conveniente e documenta a relação entre marcação e recursos de busca na [introdução aos dados estruturados](https://developers.google.com/search/docs/appearance/structured-data/intro-structured-data). A marcação precisa ser acessível e representar o conteúdo da página. Um teste de sintaxe aprovado não confirma credibilidade nem desempenho comercial.

## Escolha tipos que descrevam o que existe

Para um artigo de blog, BlogPosting pode representar título, autor, datas e página principal. Organization pode representar a entidade publicadora. BreadcrumbList descreve a navegação real. Não acrescente Product apenas porque a página oferece um serviço, nem avaliações se não existe um conjunto legítimo de avaliações elegível.

Use identificadores estáveis para referenciar a mesma organização entre páginas. Evite gerar uma organização diferente em cada URL por acidente. Se o site já tem marcação produzida pelo CMS ou plugin, examine-a antes de adicionar outro bloco.

## Um exemplo completo para adaptar

O exemplo abaixo é **hipotético**. O domínio de exemplo, nome e título precisam ser substituídos por informações verdadeiras. Autoria institucional só deve ser usada quando corresponder à responsabilidade editorial real.

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Organization",
      "@id": "https://example.com/#organization",
      "name": "Organização Exemplo",
      "url": "https://example.com/"
    },
    {
      "@type": "BlogPosting",
      "@id": "https://example.com/blog/guia#article",
      "headline": "Guia demonstrativo de integração",
      "mainEntityOfPage": "https://example.com/blog/guia",
      "author": {"@id": "https://example.com/#organization"},
      "publisher": {"@id": "https://example.com/#organization"},
      "inLanguage": "pt-BR"
    }
  ]
}
```

O exemplo evita inventar pessoa, data, logo ou imagem. Na implementação real, siga as propriedades recomendadas para o conteúdo e acrescente apenas valores disponíveis e corretos. A [documentação de Article](https://developers.google.com/search/docs/appearance/structured-data/article) explica autoria, datas e outras propriedades. Ausência de uma propriedade recomendada e erro de sintaxe são problemas diferentes.

Baixe o [exemplo e roteiro de validação](/recursos/a31-jsonld-validacao.md), que explica como inserir o JSON no componente existente, serializar com segurança e conferir duplicações. O código aqui não foi instalado em outro site nem submetido a validadores externos neste artigo.

## Valide em camadas

1. Faça o parser JSON aceitar o documento, sem vírgulas extras ou comentários.
2. Use o Schema Markup Validator para conferir vocabulário e relações.
3. Use o Rich Results Test para recursos específicos suportados pelo Google.
4. Confira o HTML servido na URL pública, além do código do componente.
5. Compare título, autoria e datas com o que o leitor vê.
6. Reavalie depois de mudanças no CMS ou plugin de SEO.

Uma marcação pode ser semanticamente válida sem habilitar um resultado avançado. Mesmo uma página elegível pode não recebê-lo. A [documentação de IA da Pesquisa](https://developers.google.com/search/docs/appearance/ai-features) também não estabelece uma garantia de citação decorrente de JSON-LD.

## O que priorizar quando há pouco tempo

Corrija primeiro páginas inacessíveis, informações incorretas e conteúdo insuficiente. Depois, descreva as entidades de forma consistente. Não existe motivo para preencher dezenas de campos falsos em nome da completude.

Consulte o [guia de autoria e fontes](/blog/eeat-autoria-fontes-experiencia-real) e o [diagnóstico de indexação](/blog/identificar-problemas-indexacao-conteudo) para relacionar marcação ao restante da página. Há mais roteiros no [blog](/blog). Para revisar a implementação existente, [fale com a Infoagents](/contato).