Avançar para o conteúdo
SilktideAjuda

Validade dos dados estruturados

Quando uma página inclui dados legíveis por máquina que descrevem o seu conteúdo para os motores de pesquisa, esses dados têm de ser válidos para serem úteis. A Silktide verifica se a marcação é analisada corretamente, declara que tipo de coisa descreve e inclui as propriedades exigidas por esse tipo.

Os são normalmente escritos como , utilizando o vocabulário schema.org:

<!-- Válido: é analisado, tem um @type e inclui o headline obrigatório -->
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to store wine"
}
</script>

Por que isso é importante

Os motores de pesquisa descartam silenciosamente os dados estruturados inválidos. JSON inválido, um bloco que nunca indica o que descreve ou um tipo sem as suas propriedades essenciais fazem com que a marcação seja ignorada — perde os resultados enriquecidos (classificações com estrelas, cartões de artigos, detalhes de produtos) que a marcação deveria proporcionar, e nada na página informa que isso aconteceu.

Os dados estruturados inválidos são, sem dúvida, piores do que não ter dados estruturados: o esforço foi despendido e a página parece estar coberta, mas não oferece nada.

Como corrigir

  1. JSON inválido — corrija a sintaxe. Vírgulas finais, aspas não escapadas dentro do texto e marcadores de posição de modelos que nunca foram substituídos são as causas mais comuns.
  2. Sem @type — adicione um a cada entidade, utilizando um tipo reconhecido pelo schema.org, como Article, Product ou Event.
  3. Propriedades obrigatórias em falta — adicione o que o tipo exige: por exemplo, um Article precisa de um headline, um Product precisa de um name e um Event precisa de um name e de um startDate.
  4. Valide o resultado com o Teste de resultados avançados do Google ou com o validador do schema.org antes de publicar.

Como a Silktide testa isto

  1. Testa apenas páginas elegíveis para indexação nos motores de pesquisa.
  2. Recolhe todos os blocos JSON-LD da página. As páginas sem blocos são ignoradas — a verificação sobre a existência de dados estruturados é feita separadamente por Dados estruturados.
  3. Comunica no máximo uma ocorrência por página, começando pela mais grave:
    • Um bloco que não é JSON válido.
    • Um bloco que não contém @type.
    • Um tipo reconhecido sem uma propriedade que exige. A Silktide testa os elementos essenciais dos tipos comuns, incluindo Article (headline), Product, Organization, Person, LocalBusiness (name), Recipe (name e ingredients), Event (name e start date), FAQPage (questions) e BreadcrumbList (items).

Resolução de problemas

A minha marcação passa no teste do Google, mas a Silktide assinala-a

A Silktide valida os elementos essenciais obrigatórios dos tipos comuns, em vez de todo o vocabulário do schema.org, e as entidades aninhadas são validadas individualmente — por exemplo, uma Person aninhada como autora ainda tem de ter um name. Verifique a entidade específica indicada na ocorrência.

Utilizo microdata ou RDFa em vez de JSON-LD

Esta verificação lê apenas JSON-LD, o formato recomendado pelo Google. Os dados estruturados noutros formatos não são validados aqui.

Saiba mais

Última atualização

Esta página foi útil?