Gerador de Esquema JSON-LD: Como Criar e Validar Dados Estruturados

Resumindo: para criar marcação Schema sem um desenvolvedor, abra o Gerador de Marcação Schema gratuito do PromoPilot, selecione um tipo — artigo, produto, FAQ, organização, empresa local ou breadcrumbs — e preencha os campos. Um bloco <script type="application/ld+json"> pronto aparecerá imediatamente à direita: copie-o com um clique, cole-o na página e verifique o link no Teste de Resultados Avançados Google. Abaixo, você encontrará o tipo necessário para sua página, quais campos são obrigatórios e os erros mais comuns.

Tenho construído sites e lojas virtuais há 12 anos e incorporo dados estruturados em todos os projetos. O que mais observo durante as auditorias é a existência de margem de lucro sobre os produtos, mas com o preço congelado no mesmo patamar de dois anos atrás.

O que um gerador de marcação Schema pode fazer?

Schema.org é um vocabulário comum usado por sites para comunicar informações sobre uma página aos mecanismos de busca: "Este é um produto, custa €89 e está em estoque." JSON-LD é um formato no qual essas informações são escritas como um bloco de código separado, sem afetar o layout. O gerador suporta os seis tipos mais populares.

Cada tipo possui seu próprio conjunto de campos. Por exemplo, para um artigo: título (obrigatório), descrição, autor, datas de publicação e atualização, URL da imagem, URL do artigo e editora.

Como gerar marcação de esquema JSON-LD online?

1. Abra o Gerador de Marcação de Esquema e selecione um tipo na linha superior.
2. Preencha os campos obrigatórios (marcados com um asterisco) e quaisquer outros recomendados que você conheça: quanto mais completas as informações, maior a chance de obter um resultado mais abrangente.
3. Copie o código usando o botão "Copiar código".
4. Insira o bloco na página — seja <head> ou <body>. No WordPress, você pode usar o campo de código no modelo ou um plugin de inserção de código; no construtor, você pode usar a seção de código personalizado da página.
5. Clique em "Verificar nos resultados avançados Google " abaixo do código e cole o endereço da página publicada.

Esta é a aparência do gerador: blocos de marcação, formulário de campo à esquerda e JSON-LD em tempo real à direita.

Exemplo do resultado para um cartão de produto:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Рюкзак Nord 20 л из кожи",
  "image": "https://example.com/img/nord-20.jpg",
  "offers": { "@type": "Offer", "price": "89.00", "priceCurrency": "EUR", "availability": "https://schema.org/InStock" }
}

Que tipo de marcação sua página precisa?

O erro mais comum que os iniciantes cometem é tentar colocar tudo em uma única página. A marcação deve descrever o que realmente está na página. Uma regra simples para os tipos de página:

• Página inicial: Organização (ou Empresa Local, caso tenha um escritório, salão de beleza ou loja com endereço).
• Contato: Empresa local com endereço, número de telefone e horário de funcionamento.
• Categoria: Lista de trilhas de navegação.
• Ficha do produto: Produto + Lista de navegação (breadcrumblist).
• Artigo do blog: Artigo + Lista de navegação.
• Página de Perguntas Frequentes: FAQ - somente se as perguntas e respostas estiverem visíveis para o visitante na página.

Vale a pena sermos honestos sobre as FAQs: desde 2023, Google tem exibido trechos de FAQs principalmente para sites governamentais e médicos de boa reputação. Para empresas comuns, a marcação de FAQ ainda é útil — ela estrutura o conteúdo para mecanismos de busca e assistentes de IA —, mas você não deve contar com a exibição direta de perguntas nos resultados de pesquisa.

Quais são os erros de marcação mais comuns?

1. Os dados não correspondem à página. O preço na marcação é de €79, mas na página é de €89 — isso viola as políticas Google e pode resultar na perda de resultados avançados.
2. Marcação para conteúdo invisível. Perguntas frequentes com questões que não estão na página ou avaliações que ninguém escreveu.
3. Formato de valor inválido. Preço com símbolo de moeda ( "89 €" em vez de "89.00" e "EUR"), data não está no formato 2026-10-12.
4. Endereços de imagem relativos. O endereço completo, começando com https://, é obrigatório.
5. JSON corrompido. Uma vírgula extra ou uma aspa em espinha de peixe após copiar o texto por um editor de texto faz com que o bloco inteiro seja ignorado.
6. Duplicados. O plugin já exibe "Organização", mas você colou um segundo com um nome diferente.

Como verificar a formatação após colar?

A verificação leva alguns minutos, mas sem ela é fácil deixar código defeituoso no seu site. Meu processo é o seguinte:

1. Teste de resultados avançados por endereço de página. A ferramenta mostrará os tipos de marcação Google encontrou, incluindo erros críticos (vermelho) e avisos (amarelo). Certifique-se de corrigir os erros e os avisos, se possível: geralmente, esses são campos recomendados que não foram preenchidos.
2. Verifique com a página visível. Abra a página ao lado e confira visualmente: mesmo preço, mesmo nome, mesmo endereço e número de telefone.
3. O Search Console estará disponível em alguns dias. A seção de melhorias apresentará relatórios sobre os tipos de marcação detectados — eles mostrarão erros em todas as páginas do site, não apenas em uma de cada vez.

Se o verificador de URLs não detectar a marcação, mesmo que o código esteja inserido, o problema geralmente está no cache do site ou em algum plugin de otimização que esteja bloqueando scripts. Limpe o cache e verifique novamente.

Comparação: Gerador de Esquemas e Alternativas

Conclusão: o gerador serve para criação, o Rich Results Test para testes e o plugin ou modelo para marcação em massa. Nos meus projetos, uso os três em diferentes etapas.

O catálogo da PromoPilot contém 87 ferramentas de SEO gratuitas. Além deste artigo, a série também inclui análises detalhadas de um gerador de meta tags e de um depurador Open Graph: juntamente com o Schema, eles abrangem tudo o que um site comunica sobre si mesmo para mecanismos de busca e mídias sociais.

Quais são as limitações do gerador de marcação Schema?

O gerador cria o código, mas não monitora sua relevância: se o preço ou a disponibilidade mudarem, você precisa atualizar a marcação manualmente. Ele não verifica se os dados correspondem à página — essa é sua responsabilidade. E, mais importante, uma marcação correta não garante um snippet em destaque. Google decide se exibe ou não um snippet em destaque, levando em consideração a qualidade da página e a consulta de pesquisa.

Quando uma ferramenta gratuita não é suficiente?

Um gerador de templates é suficiente para a página inicial e a página de contato. Para uma loja com centenas de produtos, não. Um especialista é necessário se:

• A margem de lucro do produto deve obter o preço, a disponibilidade e a avaliação do banco de dados do site e se atualizar automaticamente;
• O Search Console mostra erros de dados estruturados em centenas de páginas;
• É necessário um conjunto de marcações: Organização, Produto, Lista de Caminho de Navegação e avaliações, coordenadas entre si;
• Você quer ser citado corretamente por assistentes de IA, não apenas Google.

O que posso fazer pelo seu site?

Sou Valeriy Danyuk, desenvolvedor e especialista em SEO com 12 anos de experiência e mais de 200 clientes. Incorporo dados estruturados em templates para que sejam coletados do banco de dados do site, em vez de manualmente.

SEO, Conteúdo e GEO

• Auditoria SEO completa para sites: verifico a marcação de todos os modelos, corrijo erros do Search Console e organizo os tipos de links.
• Como um hotel foi destaque no ChatGPT, Gemini e Perplexity em 5 semanas — promoção geográfica, onde é crucial que os assistentes de IA compreendam com precisão os dados comerciais.
• Um blog de SEO com inteligência artificial que gera leads orgânicos — a formatação de artigos é aplicada automaticamente a cada artigo.

Sites e lojas online

• Uma loja online construída em WooCommerce com marcação de produto e trilha de navegação (breadcrumbs) no modelo.
• Plataforma de dropshipping com lojas parceiras.
• Na 1001site dados estruturados, mapas do site e pré-visualizações de mídias sociais são configurados automaticamente.

Diretórios de contabilidade e IA

• Contabilidade + escrituração contábil + uma loja com 30.000 produtos - precificação de milhares de cartões a partir de um único banco de dados.
• Guia de IA baseado em vetores para reparo de equipamentos com um robô.

Envie-me o link do seu site pelo Telegram e eu lhe direi qual a formatação que está faltando nas suas páginas principais.

Resultado

1. O gerador de esquemas cria JSON-LD para seis tipos: Artigo, Produto, FAQ, Organização, Negócio Local e Breadcrumbs.
2. Indique apenas o que estiver visível na página e mantenha os dados (preço, disponibilidade, datas) atualizados.
3. Após colar o código, sempre verifique a página no Teste de Resultados Avançados.
4. Para uma loja, a marcação é incorporada ao modelo ou é escolhida uma plataforma que já a possua, por exemplo, 1001site.

Crie a estrutura organizacional para sua página inicial com o gerador de esquema gratuito — leva apenas 5 minutos e um bloco de código.

Fontes

• Página da ferramenta Gerador de Esquemas PromoPilot - tipos, campos e perguntas frequentes.
• Google Search Central - Introdução a Dados Estruturados e Diretrizes da Página de Perguntas Frequentes.
• Google Rich Results Test e o Schema Markup Validator são ferramentas oficiais de validação.