Marque só o que é visível na página
Eu também já vi validador verde e zero efeito. Você pode colar JSON-LD no head e obter “valid”, mas se o código descreve algo que a pessoa não vê, isso não conserta uma página vazia.
O erro que eu eliminaria primeiro: Inserir uma avaliação ou um preço inventados.
O que preparar e que resultado esperar
- Resultado: Os buscadores recebem pistas claras da página, e você pode validar o JSON-LD antes da publicação.
- Escolha uma entidade principal da página e reúna o nome real, URL, telefone, endereço, serviço e breadcrumbs.
- Mantenha os dados de origem e os direitos de acesso separados do resultado para verificar o que o markup de página Schema.org produziu.
- Confronte cada campo com o texto visível e teste a URL no Rich Results Test, no validador Schema.org e no Search Console.
Adicione JSON-LD e valide antes da publicação
- Escolher o tipo de página
Use Service para um serviço, Organization/LocalBusiness para a empresa, Article para um artigo e BreadcrumbList para a navegação. Não coloque Product em um serviço comum.
Проверьте: O tipo descreve a entidade principal real da página.
Если не сработало: Mantenha só Article/Organization e não marque o que não tiver certeza.
- Adicionar JSON-LD
Em um CMS procure Custom code/Head; em um site estático adicione um script no head. Os campos devem bater com o conteúdo visível e a URL canônica.
<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Service", "name": "Reparo de ar-condicionado", "serviceType": "Reparo de AC residencial", "url": "https://example.com/services/repair/" } </script>Проверьте: O JSON-LD faz parse e não contém dados ausentes da página.
Если не сработало: Verifique aspas, vírgulas e a codificação JSON.
- Validar o markup com ferramentas
Rode Rich Results Test e Validator.Schema.org, depois envie a URL no Search Console → URL Inspection. Os nomes dos relatórios podem variar.
Проверьте: Sem erros de sintaxe nem avisos críticos para o tipo escolhido.
Если не сработало: Corrija o JSON primeiro e depois confira o suporte a um rich result específico.
- Monitorar após a publicação
Após atualizações, revise os relatórios de enhancements e confirme que o markup não ficou desatualizado com mudanças de endereço, preço ou FAQ.
Проверьте: Os dados estruturados batem com a página atual.
Если не сработало: Remova um tipo que você não consegue mais sustentar com texto visível.
Escolho o tipo pelo sentido da página
Para uma página de serviço típica, `Organization`, `Service` e `BreadcrumbList` costumam bastar. Não adicione `aggregateRating` se não houver avaliações na página; não invente preço; não transforme serviço em Product. Os dados JSON-LD devem bater com o texto visível e as URLs reais.
Em um CMS procure `Custom code / Head`; em um site estático adicione um `script` no `<head>`. Depois confira a página com Rich Results Test e `validator.schema.org`, e abra URL Inspection no Search Console.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Service",
"name": "Automação de processos de negócio",
"serviceType": "Automação de processos de negócio",
"url": "https://example.com/services/automation/"
}
</script>Como saber que o markup não está mentindo
Abra o HTML de origem e encontre cada `application/ld+json`: um problema comum é CMS e código manual publicando dois grafos conflitantes. Confira se `url`, `@id`, imagens e breadcrumbs apontam para páginas que retornam 200. Antes das mudanças, salve impressões, cliques, CTR e posição de 5–10 páginas semelhantes, ou não dá para comparar o efeito.
- Sintaxe válida não garante rich result.
- Markup não substitui conteúdo real.
- Não use dados ocultos só para um snippet.
Não testo markup só com afirmações
Salve a URL, o tipo de schema, a data de validação, os erros do validador, o bloco visível na página e o resultado esperado. Se você adicionou FAQPage, perguntas e respostas devem ser expansíveis e visíveis para pessoas. Se adicionou Service, o nome e o escopo do serviço devem bater com o texto da página.
Após a publicação, não prometa rich snippet ao cliente. Espere o recrawl e compare impressões e CTR com URLs semelhantes. Dados estruturados ajudam os buscadores a entender a página, mas não substituem um copy útil nem garantem exibição especial.
Como escolher um tipo Schema.org sem inventar fatos
| Critério | Pergunta | Bom sinal |
|---|---|---|
| Entrada | O que exatamente entra no markup de página Schema.org? | Escolha uma entidade principal da página e reúna o nome real, URL, telefone, endereço, serviço e breadcrumbs. |
| Ação | O que o sistema pode fazer sozinho? | Somente ações pré-listadas, sem acesso a toda a conta |
| Verificação | Como saber que o resultado é aceitável? | Confronte cada campo com o texto visível e teste a URL no Rich Results Test, no validador Schema.org e no Search Console. |
| Falha | Para onde vai um caso pouco claro? | Remova o campo ou tipo em disputa em vez de preenchê-lo com avaliação, preço ou endereço inventados. |
O que deve mudar depois da configuração
Os buscadores recebem pistas claras da página, e você pode validar o JSON-LD antes da publicação.
Por que markup válido ainda não ganha snippet
Inserir uma avaliação ou um preço inventados.
Marcar texto oculto que o visitante nunca vê.
Adicionar dez tipos sem entender a entidade principal.
Tratar JSON válido como garantia de rich result.
Quando o schema precisa se conectar aos dados do site
Traga um especialista se o markup for gerado para centenas de tipos de página, se conectar a um catálogo ou cobrir vários locales.
O que checar no JSON-LD
Posso adicionar dez tipos de schema de uma vez?
Melhor começar pelos tipos que descrevem a entidade principal da página e são sustentados por texto visível.
Onde devo validar o JSON-LD?
No Rich Results Test, no validador Schema.org e via URL Inspection após a publicação.
FAQPage garante um snippet de FAQ?
Não. O markup ajuda a entender o conteúdo, mas o formato de exibição e a elegibilidade são decididos pelo buscador.
Posso marcar avaliações de um formulário?
Só se a avaliação estiver realmente publicada, se relacionar à entidade e você seguir as regras do buscador.
