Schema markup SEO: JSON-LD para FAQ, produto e artigo
Com esta ferramenta de schema markup SEO, você transforma um formulário em JSON-LD, os dados estruturados que dizem aos buscadores do que trata uma página. Escolha um Tipo de schema, preencha os campos e copie a tag script pronta para a sua página. O código se atualiza enquanto você digita e tudo acontece no seu navegador, então nada do que você informa é enviado.
Schema markup online em cinco passos
- Escolha um tipo em Tipo de schema: Página de perguntas frequentes, Artigo, Produto, Negócio local, Evento, Pessoa ou Organização.
- Preencha os campos abaixo do código. O bloco Código JSON-LD acima se reescreve a cada tecla e mostra uma dica até você digitar alguma coisa.
- Se você precisa de uma propriedade do schema.org que o formulário não tem, clique em Adicionar propriedade personalizada em Propriedades personalizadas.
- Clique em Copiar JSON-LD. O botão mostra “Copiado” por um instante e a tag script inteira vai para a sua área de transferência.
- Cole a tag no HTML da sua página e depois teste a página com o Teste de resultados em destaque do Google ou com o Schema Markup Validator.
Não há botão de gerar. Um campo vazio nunca é escrito, então até um formulário preenchido pela metade resulta em um JSON limpo e válido, sem valores vazios nem vírgulas sobrando.
Negócio local, evento, artigo, pessoa e organização
- Negócio local: os campos de endereço (Endereço, Cidade, Estado ou região, CEP, País) são agrupados em um único PostalAddress. Não há campo para horário de funcionamento, então adicione openingHours como propriedade personalizada.
- Evento: Nome do local e Endereço do local viram um Place, e Organizador vira uma Organization. Os seletores de data escrevem a data e a hora como você as escolhe, sem deslocamento de fuso horário. Se o seu evento precisar, adicione-o com uma propriedade personalizada, por exemplo startDate.
- Artigo: Autor vira uma Person e Editora uma Organization. Data de publicação e Data de modificação são escritas como datas simples.
- Pessoa e organização: digite um endereço por linha em URLs de perfis, uma por linha e eles viram uma lista sameAs. Uma linha que não seja um endereço web completo fica de fora.
Schema FAQ: pares de pergunta e resposta
Escolha Página de perguntas frequentes e o formulário mostra um cartão “Pergunta 1” com os campos Pergunta e Resposta. Adicionar pergunta acrescenta outro par, e o X no cartão o remove. Um par precisa das duas metades: com só a pergunta ou só a resposta, ele fica fora do código e uma nota abaixo do formulário avisa você.
A marcação de FAQ é uma FAQPage com uma Question e uma acceptedAnswer para cada par. Use-a apenas em uma página que mostre aos visitantes essas mesmas perguntas e respostas.
Schema de produto com preço e disponibilidade
O tipo Produto escreve uma Brand a partir de Marca e, somente quando você informa um Preço, uma Offer com a URL da página, o preço, o Código da moeda e a Disponibilidade. O preço é escrito como número JSON, o código da moeda em maiúsculas e a disponibilidade vira um endereço do schema.org, como https://schema.org/InStock. Você pode escolher Em estoque, Esgotado, Pré-venda ou Descontinuado. Sem preço não há Offer, e a URL da página é escrita no próprio Product.
O formulário não gera avaliações nem notas, porque não tem como saber o que clientes de verdade disseram. Ele também não confere os requisitos de produto do Google, então confirme-os para a sua página.
Propriedades personalizadas no seu JSON-LD
Adicionar propriedade personalizada acrescenta uma linha com Nome da propriedade e Valor, além de um X para removê-la. A linha vai para o final do código. Como o valor é escrito depende do que você digita:
42outrue: um número ou um valor verdadeiro/falso{"@type": "Place"}ou["a", "b"]: um objeto ou uma lista JSONMo-Fr 09:00-17:00: texto simples"12345"entre aspas: o texto 12345, não um número
Uma propriedade personalizada com o mesmo nome de um campo do formulário substitui esse campo. Um valor que começa como JSON mas não é válido, por exemplo um objeto com uma chave faltando, é escrito como texto, e uma nota abaixo da linha avisa você.
O que o gerador deixa de fora e onde colocar o JSON-LD
Campos vazios nunca são escritos. Uma URL que não seja um endereço http ou https completo, um preço que não seja um número, um código de moeda que não tenha três letras e um par de pergunta preenchido pela metade são sinalizados abaixo do campo e ficam fora do código até serem válidos. Todo sinal de “menor que” em um valor é escrito como \u003c, para que nada do que você digitar possa fechar a tag script antes da hora. A ferramenta só monta o código: ela não o valida contra os requisitos do Google para resultados em destaque e não pode prometer um resultado em destaque.
Cole a tag script inteira na página que ela descreve. O Google lê JSON-LD no head ou no body, então use o lugar mais fácil no seu template. A marcação deve descrever o que a página realmente mostra: um bloco Product em uma página de produto e um bloco FAQPage só onde essas perguntas e respostas estão visíveis. Para o título, a descrição e as tags sociais do head, use o Gerador de Meta Tags, e para reformatar ou conferir um bloco JSON-LD que você já tem, cole-o no Formatador de JSON.
Não marque conteúdo que não está na página nem invente avaliações ou notas. Os buscadores podem ignorar dados estruturados que não combinam com a página visível, e alguns tipos de marcação enganosa podem levar a uma ação manual.
Perguntas frequentes
O que é JSON-LD?
JSON-LD é uma forma de escrever dados estruturados como JSON dentro de uma tag script, para que os buscadores entendam do que trata uma página sem analisar o texto visível. A ferramenta escreve para você: o bloco “Código JSON-LD” mostra uma tag script completa do tipo application/ld+json, com um @context de https://schema.org e o @type que você escolheu.
Para que serve o schema markup SEO?
O schema markup rotula o conteúdo de uma página com o vocabulário do schema.org, para que o buscador saiba que um bloco de texto é o preço de um produto, a data de um evento ou uma lista de perguntas e respostas. Ele pode deixar a página elegível a resultados mais ricos na busca, mas não muda o que os visitantes veem na própria página.
Como colocar schema markup no HTML?
Clique em “Copiar JSON-LD” e cole a tag script inteira no HTML da sua página. Em um construtor de sites ou CMS, procure um campo de código personalizado, código do cabeçalho ou configurações de SEO. Use um bloco para cada coisa que a página descreve e confira se os fatos batem com a página visível. O Google lê JSON-LD tanto no head quanto no body.
O que é schema FAQ?
Schema FAQ é a marcação FAQPage: uma lista de perguntas, cada uma com uma resposta aceita. Escolha “Página de perguntas frequentes” em “Tipo de schema”, preencha “Pergunta” e “Resposta” de cada par e use “Adicionar pergunta” para os demais. Use apenas em uma página que mostre essas mesmas perguntas e respostas.
A ferramenta garante um resultado em destaque?
Não. A ferramenta só monta o código e não o valida contra os requisitos do Google para resultados em destaque. Quem decide se mostra um resultado em destaque é o buscador, que pode ignorar dados estruturados que não combinam com a página visível.
Como testar o schema markup?
Cole o código na sua página e teste a página com o Teste de resultados em destaque do Google ou com o Schema Markup Validator. A ferramenta não confere os requisitos do Google, então, em um produto, confira-os você mesmo.
Posso adicionar propriedades que o formulário não tem, como o horário de funcionamento?
Sim. Clique em “Adicionar propriedade personalizada” em “Propriedades personalizadas”, digite o “Nome da propriedade”, por exemplo openingHours, e o “Valor”. A linha vai para o final do código. Um valor que seja JSON válido é escrito como JSON, qualquer outro como texto.
Por que a minha URL, o preço ou a moeda não aparecem no código?
A ferramenta deixa de fora os valores inválidos e os sinaliza abaixo do campo. Uma URL precisa ser um endereço http ou https completo, o preço um número e o código da moeda três letras, como USD, EUR ou JPY. Assim que o valor é válido, ele aparece no código.
O meu texto é enviado para algum lugar?
Não. O código é montado no seu navegador e nada do que você informa é enviado. Você não precisa de conta.