O Gerador de Marcação de Esquema é uma ferramenta projetada para auxiliar na criação de dados estruturados no formato JSON-LD para páginas da web. Através de formulários guiados, operadores de conteúdo, webmasters e desenvolvedores podem descrever elementos específicos de suas páginas, gerando um código padronizado que facilita a interpretação do conteúdo por parte dos mecanismos de busca.
Todo o processamento das informações inseridas ocorre diretamente no navegador do usuário. As entradas permanecem no seu navegador e nada é enviado para o BroBroGo, garantindo que os dados não sejam transmitidos para servidores externos durante a digitação.
A Função do JSON-LD e do Schema.org na Web
O Schema.org é um esforço colaborativo que estabelece um vocabulário compartilhado para estruturar dados na web. Ao aplicar essa marcação, o conteúdo textual de uma página é traduzido em um formato que os mecanismos de pesquisa conseguem processar de maneira semântica.
O formato JSON-LD (JavaScript Object Notation for Linked Data) é o método recomendado para a implementação dessas marcações. Ele funciona como um script embutido no documento HTML, organizando as propriedades e objetos sem interferir na renderização visual da página para os usuários. Essa organização estruturada ajuda os motores de busca a compreenderem o contexto exato do conteúdo, estabelecendo relações claras entre entidades, como produtos, preços, etapas de processos e perguntas frequentes.
Estruturação de FAQPage
A marcação do tipo FAQPage é utilizada quando uma página apresenta uma lista de perguntas e respostas sobre um determinado tópico. Para que o código JSON-LD seja gerado corretamente, a ferramenta exige o preenchimento de campos específicos, validando as informações em tempo real.
Regras de Validação para FAQ
- Requisito Mínimo: É obrigatório fornecer pelo menos um par completo de pergunta e resposta. Caso contrário, a ferramenta exibirá a mensagem: "Adicione pelo menos uma pergunta e resposta completas.".
- Campos Individuais: Cada item adicionado deve conter tanto a pergunta quanto a resposta. Se houver omissão, os erros apontados serão "O item
{index}precisa de uma pergunta." ou "O item{index}precisa de uma resposta.".
Estruturação de Product com Ofertas
A marcação de Produto (Product) descreve um item comercializado, incluindo detalhes de identificação e as condições de aquisição (Offer).
Campos Disponíveis e Regras de Preenchimento
- Nome do Produto: Campo obrigatório. A ausência gera o erro "Adicione o nome do produto.".
- Preço: Deve ser um número não negativo, utilizando ponto como separador decimal opcional. Erros associados incluem "Adicione o preço da oferta." e "Use um preço não negativo com dígitos e um ponto decimal opcional.".
- Código da Moeda: Deve seguir o padrão internacional de três letras (como BRL, USD ou EUR). Caso contrário, exibe-se "Use um código de moeda de três letras, como BRL, USD ou EUR.".
- URLs (Produto e Imagem): Devem ser endereços absolutos e válidos iniciando com
http://ouhttps://. Se inválidos, a ferramenta indica "A URL do produto deve ser um endereço completo http:// ou https://." ou "A 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. Se deixados em branco, são omitidos do JSON-LD final.
Estruturação de HowTo para Tutoriais
O esquema HowTo descreve instruções passo a passo para a realização de uma tarefa específica. Ele permite detalhar o tempo necessário, os materiais e as ferramentas utilizadas.
Requisitos do Tutorial
- Título: Obrigatório. Se ausente, exibe "Adicione o título do tutorial.".
- Etapas: É necessário incluir pelo menos uma etapa com instruções. A falta de etapas gera o aviso "Adicione pelo menos uma etapa completa.". Se uma etapa for criada sem texto explicativo, o sistema aponta "O item
{index}precisa de instruções para a etapa.". - Tempo Total: Opcional, mas se preenchido deve ser um número inteiro entre 1 e 100.000 minutos. Valores fora desse intervalo geram o erro "O tempo total deve ser um número inteiro de 1 a 100.000 minutos.".
- Suprimentos e Ferramentas: Devem ser inseridos um por linha nos respectivos campos.
Limites do Editor e Geração do Código
Para garantir a estabilidade da ferramenta, existem limites de tamanho e quantidade de itens:
- Se um texto exceder o limite de caracteres de um campo, a mensagem exibida será "
{field}é longo demais para este editor. Mantenha-o com menos de{max}caracteres.". - Se o número de itens adicionados ultrapassar o limite do sistema, o aviso será "Este editor suporta até
{max}itens por vez.".
O script JSON-LD completo é gerado e exibido na área de saída apenas quando todos os campos obrigatórios estiverem validados e sem erros. O status da ferramenta é atualizado dinamicamente, exibindo mensagens como "Todos os campos obrigatórios são válidos." ou detalhando a quantidade de pendências com "{count} problema(s) para corrigir.".
Perguntas Frequentes
Quais 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 devo colocar 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 não exibe mais resultados avançados (rich results) de FAQ ou HowTo.