Documentação

Guia essencial para utilizar Schema JSON-LD.

Esta documentação apresenta os conceitos principais, a importância dos dados estruturados, onde devem ser implementados e quais os cuidados essenciais para uma marcação mais consistente.

Sobre

O que é o SchemaGen?

O SchemaGen é uma ferramenta criada para gerar código Schema JSON-LD de forma simples e organizada. O objetivo é ajudar websites, negócios e criadores de conteúdo a estruturar melhor a informação apresentada nas suas páginas.

Com a ferramenta, é possível criar marcações para organizações, negócios locais, artigos, produtos, aplicações, perguntas frequentes, eventos, vídeos e outros tipos de conteúdo comuns em projetos digitais.

Importância

Porque os dados estruturados são relevantes?

Melhor interpretação

Ajuda os motores de busca a compreenderem melhor o conteúdo e o contexto de cada página.

Informação organizada

Permite representar entidades, produtos, artigos, eventos e perguntas de forma mais estruturada.

Base técnica sólida

Contribui para uma implementação SEO mais completa, especialmente em websites com conteúdos importantes.

Implementação

Onde implementar o código JSON-LD?

O código gerado pelo SchemaGen deve ser inserido na página correspondente ao conteúdo representado. Por exemplo, o Schema de um artigo deve estar na página desse artigo, e o Schema de um produto deve estar na página desse produto.

Cabeçalho do website

A implementação pode ser feita dentro da tag <head>, quando existe controlo direto sobre o código da página.

WordPress

Em WordPress, o código pode ser colocado através do tema, de campos personalizados, de um plugin de scripts ou de uma área própria para código no cabeçalho.

Páginas individuais

Sempre que possível, cada marcação deve ser aplicada apenas na página onde a informação existe de forma visível e correspondente.

Tipos principais

Marcações disponíveis na ferramenta

Organization

Indicado para empresas, marcas, instituições e projetos com identidade própria.

LocalBusiness

Útil para negócios com presença local, morada, horário e contactos.

Article

Recomendado para artigos, publicações editoriais, notícias ou conteúdos de blog.

Product

Aplicável a páginas de produto com nome, descrição, preço, marca e disponibilidade.

FAQPage

Usado em páginas com perguntas e respostas claramente visíveis para o utilizador.

VideoObject

Indicado para páginas com vídeos, thumbnails, descrição e data de publicação.

Boas práticas

Recomendações importantes

1

Use dados reais e visíveis

A informação no Schema deve corresponder ao conteúdo apresentado na página.

2

Escolha o tipo correto

Utilize a marcação mais adequada ao conteúdo: artigo para artigos, produto para produtos, evento para eventos.

3

Evite duplicação desnecessária

Não repita marcações iguais várias vezes na mesma página sem necessidade.

4

Atualize quando o conteúdo mudar

Datas, preços, disponibilidade, contactos e descrições devem permanecer alinhados com a página.

Validação

Como verificar a implementação

Depois de implementar o código, é recomendável validar a página com ferramentas próprias para dados estruturados. A validação ajuda a identificar campos em falta, erros de formatação ou marcações que não correspondem ao conteúdo.

Antes de publicar, confirme:

  • • O código JSON-LD está completo e sem erros de sintaxe.
  • • Os campos principais estão preenchidos.
  • • A informação corresponde ao conteúdo visível da página.
  • • O tipo de Schema escolhido é adequado ao objetivo da página.
  • • Não existem dados antigos, duplicados ou incoerentes.