A marcação schema descreve o conteúdo de uma página de forma estruturada. JSON-LD é o formato dos dados; tipos como Article e Product identificam o que é descrito. O gerador gratuito do Screpy transforma os dados de artigos, produtos ou caminhos de navegação em JSON-LD. Escolha o tipo adequado, preencha o formulário e reveja o resultado antes de o adicionar ao site. Pode copiar o script completo ou descarregar os dados JSON.
Gerar é o primeiro passo. A ferramenta não lê a página, não confirma preços ou autores, não instala código nem o envia ao Google. Uma implementação útil exige factos corretos, colocação na página certa e verificação do resultado publicado.
Escolher o tipo de schema adequado à página
Comece pelo que o visitante pode realmente ler ou comprar, não pela apresentação que pretende nos resultados de pesquisa. Existem três modos e três subtipos de artigo:
| Conteúdo da página | Escolha | O que descreve |
|---|---|---|
| Artigo editorial geral | Article | Artigo, título e autor |
| Artigo de blogue | BlogPosting | Artigo apresentado como publicação de blogue |
| Notícia | NewsArticle | Artigo noticioso |
| Um produto com uma oferta | Product | Produto e um Offer atual |
| Caminho de navegação da página | Breadcrumb | BreadcrumbList ordenada |
Uma categoria não é automaticamente um único Product. Uma página comercial não se torna NewsArticle apenas porque essa opção existe. Selecione o tipo que representa fielmente o conteúdo.
Para morada, contactos ou horários de uma empresa, utilize o Local Business Schema Generator. Este gerador não cria todos os tipos de Schema.org. Manter o tipo correto é mais útil do que forçar informações num formulário inadequado.
Preparar informações corretas do artigo
Escolha Article, BlogPosting ou NewsArticle e introduza URL, título e nome do autor. São campos obrigatórios deste formulário, não requisitos universais do Google. A documentação atual de Article apresenta propriedades recomendadas quando aplicáveis, em vez de uma lista obrigatória para todos os casos.
O autor gerado é uma única Person. Utilize o nome de uma pessoa real e, quando disponível, o URL do perfil que a identifica. Não introduza uma editora como pessoa nem junte vários autores num só nome para caberem no formulário. Um autor Organization ou vários autores exigem uma implementação que modele esses factos corretamente. Este ecrã não gera essas estruturas.
Os detalhes adicionais incluem até três URLs de imagens e as datas reais de publicação e alteração. Utilize imagens relevantes e acessíveis, não endereços inventados nem apenas um logótipo para remover um aviso. O formulário aceita datas de calendário e rejeita alterações anteriores à publicação. Não passe a data de publicação para hoje só porque acrescenta marcação.
Os avisos de imagem ou data em falta pedem a revisão de informações reais. Não justificam valores inventados nem representam todos os requisitos de uma funcionalidade de pesquisa.
Descrever uma oferta real de um produto
O modo produto exige nome, URL, preço real, moeda e disponibilidade. Escolha o estado correto: InStock, OutOfStock, PreOrder, BackOrder ou Discontinued. Descrição, imagem, SKU e marca são opcionais. O resultado contém um Product com um Offer; não é um feed, sistema de variantes ou atualizador automático de stock.
Para uma Trail Bottle fictícia, em stock e com preço de 29,90 EUR, a estrutura básica é:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Bottle",
"url": "https://example.com/products/trail-bottle/",
"offers": {
"@type": "Offer",
"url": "https://example.com/products/trail-bottle/",
"price": 29.9,
"priceCurrency": "EUR",
"availability": "https://schema.org/InStock"
}
}
</script>
São valores ilustrativos, não uma oferta publicada nem uma ficha comercial validada. O exemplo reduzido omite uma imagem, que o gerador assinala para revisão. Substitua todos os valores fictícios e forneça uma imagem real adequada quando existir. Zero é aceite para uma oferta realmente gratuita, não para substituir um preço desconhecido.
Avaliações e classificações agregadas não são geradas. Não as invente para remover avisos de outro validador. O guia Google de resultados de produto distingue propriedades e requisitos das ofertas. Experiências comerciais mais completas podem exigir implementação adicional.
Construir o caminho de navegação na ordem certa
O modo Breadcrumb cria um caminho com dois a dez elementos. Introduza os nomes numa ordem coerente com a hierarquia do site. Todos precisam de nome; todos exceto o último precisam de URL completo. O gerador atribui posições a partir de um e apresenta uma pré-visualização, mas não descobre a estrutura do site.
Numa página fictícia de lista de verificação, poderia introduzir:
| Posição | Nome | URL |
|---|---|---|
| 1 | Guias | https://example.com/guides/ |
| 2 | Caminhadas | https://example.com/guides/hiking/ |
| 3 | Lista para mochila de um dia | Opcional neste último elemento |
A documentação Breadcrumb do Google permite omitir o URL final, utilizando o da página que contém a marcação. Instale este caminho na página da lista, não em todas as páginas com os mesmos valores finais.
A pré-visualização não acrescenta navegação visível ao site. Mantenha a marcação coerente com a hierarquia real e verifique os links apresentados separadamente. Não presuma que o código garante a mesma apresentação na pesquisa em todos os dispositivos.
Copiar e instalar JSON-LD na página correspondente
Copiar script fornece o elemento HTML completo com o conteúdo JSON-LD. Descarregar fornece schema.json, contendo apenas o objeto JSON sem a estrutura HTML envolvente. São formatos para métodos diferentes: um campo CMS que espera JSON puro precisa dos dados, enquanto um modelo HTML pode aceitar o script completo.
A introdução do Google aos dados estruturados descreve JSON-LD num elemento script em head ou body. Utilize o modelo, campo ou mecanismo de extensão apropriado. Colar código num editor de parágrafos pode apresentá-lo como texto ou removê-lo em vez de o instalar.
Antes de adicionar um bloco, veja o que o CMS ou tema já produz. Article e BreadcrumbList podem descrever aspetos diferentes da mesma página. O problema são descrições contraditórias do mesmo artigo, produto ou caminho. Atualize a implementação responsável em vez de deixar preço ou autor antigos junto de uma versão nova incompatível.
O gerador serializa os valores de forma segura para o seu script, mas não pode confirmar o resultado final do CMS. Guarde a página, inspecione a saída servida e confirme os valores previstos. Copiar ou descarregar, por si só, não altera o site.
Validar código, factos e elegibilidade separadamente
Verifique o resultado instalado por etapas:
- Confirme que o JSON é analisável e o script está na página prevista.
- Reveja tipos e propriedades, incluindo objetos aninhados.
- Compare nomes, preços, datas, imagens e navegação com a página real.
- Consulte os requisitos atuais da funcionalidade de pesquisa pretendida.
O Structured Data Checker inspeciona JSON-LD instalado, erros de análise, entidades e algumas propriedades. A cobertura é limitada. Uma Person ou um Offer aninhados, ou um subtipo de artigo, podem ficar fora dessas verificações e aparecer como não suportados ou parciais. Esse estado, por si só, não torna a estrutura inválida. Reveja os resultados concretos e utilize validação mais abrangente quando necessário.
Use o Rich Results Test para funcionalidades Google suportadas. Informação recomendada em falta exige revisão, não classificações, imagens ou datas inventadas. Sintaxe correta também não prova quem escreveu um artigo ou se uma oferta continua disponível.
As diretrizes gerais do Google exigem informação relevante, correta e atual, além das regras de cada funcionalidade. Mesmo marcação correta não garante um resultado enriquecido. A contagem de propriedades mede o tamanho da saída, não completude ou uma nota SEO.
Manter a marcação sincronizada com alterações futuras
Volte a gerar ou atualize o modelo quando preço, stock, autor, uma data significativa ou a hierarquia mudar. Publique factos visíveis e marcação em conjunto e verifique novamente a página. O gerador não vigia alterações posteriores nem atualiza automaticamente uma instalação existente.
Em páginas traduzidas, utilize título, descrição e nomes de navegação na língua correspondente, com os URLs corretos e as ofertas reais dessa versão. Mantenha nomes técnicos como headline e priceCurrency. Uma língua de interface diferente não traduz os dados nem cria versões localizadas das páginas.
Registe os dados revistos e o local de instalação nas suas notas de publicação. A atualização seguinte será uma alteração concreta numa fonte conhecida, não outro script isolado que possa deixar de corresponder à página.