Gerador de Marcação de Esquema

Introdução ao Schema.org e Dados Estruturados

Os motores de pesquisa utilizam rastreadores para ler o código HTML das páginas web, mas a linguagem natural pode ser ambígua. O projeto Schema.org fornece um vocabulário partilhado e normalizado que os webmasters, operadores de conteúdo e programadores utilizam para definir explicitamente as entidades e as relações presentes numa página. Ao estruturar a informação com este vocabulário, os motores de pesquisa conseguem processar o significado exato do conteúdo sem dependerem exclusivamente de algoritmos de interpretação de texto.

A implementação de dados estruturados estabelece uma ligação direta entre os elementos visíveis na página e o seu significado semântico. Esta organização facilita a indexação precisa e ajuda os motores de pesquisa a compreenderem o contexto global do conteúdo, associando propriedades específicas a tipos de dados normalizados.

O Formato JSON-LD para Conteúdo Web

O JSON-LD (JavaScript Object Notation for Linked Data) é o formato recomendado para a implementação de dados estruturados na web. Ao contrário de marcações baseadas em atributos inline, como Microdados ou RDFa, o JSON-LD funciona como um bloco de script independente que se insere no código HTML.

Esta separação traz vantagens técnicas significativas para a manutenção do website:

• Isolamento do código: O script JSON-LD não interfere com a estrutura de formatação ou com o design visual do HTML.
• Facilidade de geração: Permite que ferramentas e sistemas de gestão de conteúdo gerem dinamicamente os metadados num único bloco estruturado.
• Leitura limpa: Facilita a auditoria e a validação do código por parte de programadores e ferramentas de diagnóstico.

O Gerador de Marcação de Esquema automatiza a criação deste bloco de código. À medida que preenche os campos guiados, a ferramenta constrói a sintaxe JSON-LD correta em tempo real, garantindo que a estrutura cumpre as especificações do Schema.org.

Estrutura do Esquema FAQPage

O tipo de esquema FAQPage é utilizado quando uma página apresenta uma lista de perguntas e respostas sobre um determinado tema. Para que a marcação seja válida, cada pergunta deve estar estritamente associada à sua respetiva resposta.

O gerador aplica regras de validação em tempo real para garantir a integridade do código:

• Se tentar gerar o código sem dados, a ferramenta exibe o erro "Adicione pelo menos uma pergunta e resposta completas.".
• Cada item individual é verificado durante a escrita. Se faltar um dos componentes, surgem os erros "O item {index} precisa de uma pergunta." ou "O item {index} precisa de uma resposta.".
• Campos opcionais que fiquem vazios são automaticamente omitidos do script final, evitando a presença de propriedades sem valor no JSON-LD.

Estrutura do Esquema Product com Ofertas

O esquema Product descreve um produto físico ou digital e inclui detalhes comerciais através de uma Offer (oferta) associada. Este esquema suporta propriedades detalhadas para identificar o item e as condições de aquisição.

Os campos de entrada e as respetivas regras de validação incluem:

• Nome do produto: Campo obrigatório. A ausência deste dado gera o erro "Adicione o nome do produto.".
• Preço: Deve ser um número não negativo, composto por dígitos e um ponto decimal opcional para os cêntimos. Se o formato for incorreto, a ferramenta exibe "Use um preço não negativo com dígitos e um ponto decimal opcional.". Se o campo estiver vazio, surge "Adicione o preço da oferta.".
• Código da moeda: Requer um código de três letras em conformidade com a norma internacional (por exemplo, EUR, USD ou GBP). O incumprimento desta regra resulta no erro "Use um código de moeda de três letras, como EUR, USD ou GBP.".
• URLs (Produto e Imagem): Devem ser endereços absolutos e completos que comecem por http:// ou https://. URLs inválidos acionam os erros "O URL do produto deve ser um endereço completo http:// ou https://." ou "O URL da imagem deve ser um endereço completo http:// ou https://.".
• Campos opcionais: Descrição, Marca, SKU e Disponibilidade podem ser preenchidos para enriquecer o esquema, sendo ignorados no código final se forem deixados em branco.

Estrutura do Esquema HowTo

O esquema HowTo descreve instruções passo a passo para realizar uma tarefa específica, detalhando os requisitos necessários e a sequência de ações.

A estrutura do gerador para este tipo de esquema exige:

• Título do tutorial: Identificação clara do processo. A sua ausência gera o erro "Adicione o título do tutorial.".
• Minutos totais: Campo opcional para o tempo de execução. Deve ser um número inteiro compreendido entre 1 e 100.000 minutos. Valores fora deste intervalo ou formatos inválidos acionam o erro "O tempo total deve ser um número inteiro de 1 a 100.000 minutos.".
• Suprimentos e Ferramentas: Introduzidos em listas onde deve colocar um item por linha.
• Etapas: Requer pelo menos uma etapa estruturada. Se não existirem etapas, a ferramenta indica "Adicione pelo menos uma etapa completa.". Cada etapa individual exige instruções de texto; caso contrário, o validador apresenta o erro "O item {index} precisa de instruções para a etapa.". O título da etapa é opcional.

Processamento Local e Privacidade

A segurança dos dados introduzidos é gerida diretamente no dispositivo do utilizador. Todas as entradas de texto, valores financeiros e URLs permanecem no seu navegador. O processamento e a conversão para o formato JSON-LD ocorrem localmente através de scripts executados no cliente, garantindo que nada é enviado para o BroBroGo.

Perguntas Frequentes

Que tipos de esquema posso criar? Os formulários guiados cobrem FAQPage, Product com uma Offer, e HowTo com etapas ordenadas, suprimentos e ferramentas. Campos opcionais vazios são deixados de fora do código.

Onde coloco o JSON-LD gerado? Cole o script completo dentro do <head> ou do <body> da página cujo conteúdo visível ele descreve. Mantenha a marcação consistente com o que os visitantes realmente conseguem ver.

Uma marcação válida garante um resultado avançado na pesquisa? Não. Uma marcação válida do schema.org ajuda os serviços a entenderem a página, mas exibições especiais de pesquisa nunca são garantidas. O Google já não exibe resultados avançados (rich results) de FAQ ou HowTo.