Módulo 5 · 5.3

Testar, manter e o que não é permitido

Módulo 5: Dados estruturados · Tempo de leitura: 12 minutos

Objetivo de aprendizagem: No final desta lição, saberá testar dados estruturados com o Rich Results Test e o Schema Markup Validator, explicar a diferença entre erros e avisos e aplicar as regras do Google, como a proibição de avaliações sobre a sua própria empresa.

Conceitos chave: Rich Results Test, Schema Markup Validator, problema crítico (erro) versus problema não crítico (aviso), HTML apresentado, relatórios na Search Console, diretrizes para dados estruturados, avaliações próprias (self-serving), ação manual, blocos duplicados, manutenção

Duas ferramentas de teste, duas perguntas

Existem duas ferramentas gratuitas, e cada uma responde a uma pergunta diferente.

	Rich Results Test	Schema Markup Validator
De quem	Google	schema.org (o sucessor da antiga Structured Data Testing Tool do Google, na schema.org desde 2021)
Pergunta a que responde	"Esta página é elegível para uma apresentação especial no Google?"	"Esta marcação schema.org é válida?"
Que tipos	Apenas os tipos para os quais o Google tem uma apresentação especial	Todos os tipos da schema.org
Verifica as regras do Google	Sim: propriedades obrigatórias e recomendadas segundo o Google	Não, apenas a própria schema.org
Entrada	Endereço de uma página ou código colado	Endereço de uma página ou código colado

Comece pelo Rich Results Test (https://search.google.com/test/rich-results), em português Teste de resultados avançados. Introduza o endereço da sua página, não o código: assim, a ferramenta vê a página tal como o Googlebot a obtém, incluindo o JSON-LD acrescentado com JavaScript. Se colar o código, o JavaScript pode deparar-se com limitações, segundo o próprio Google. Se quiser saber se a sua marcação está correta segundo a schema.org, também para tipos que o Google não utiliza, use o Schema Markup Validator (https://validator.schema.org/).

Ler erros e avisos

O Rich Results Test divide os problemas em dois tipos:

Problemas críticos (erros). Falta uma propriedade obrigatória ou um valor é inválido. Nesse caso, o item não é elegível para uma apresentação especial. Resolva-os sempre.
Problemas não críticos (avisos). Falta uma propriedade recomendada, como priceRange ou geo. O item é válido. Preencha a propriedade se tiver os dados e estes estiverem corretos; não invente nada só para eliminar um aviso.

O teste indica "No items detected" (nenhum item detetado) quando sabe que existe JSON-LD na página? Verifique então três causas:

O JSON é inválido (uma vírgula a mais ou a menos, umas aspas esquecidas). Nesse caso, o bloco inteiro é ignorado. O Schema Markup Validator indica normalmente a linha onde está o problema.
O tipo é desconhecido (Bloemist em vez de Florist) ou está mal escrito (localbusiness).
A página está bloqueada para o Googlebot com robots.txt ou noindex (lições 3.3 e 1.3). O Google pede expressamente: não bloqueie páginas com dados estruturados.

A Search Console acompanha tudo

Assim que o seu site estiver na Search Console (módulo 2), a Search Console mostra em Enhancements um relatório por cada tipo para o qual o Google tem uma apresentação especial e encontra marcação válida no seu site. Aí vê os itens válidos, os itens com problemas não críticos e os itens inválidos, com páginas de exemplo. Algumas coisas a saber:

Não existe um botão "resolver isto". Corrige a origem (o seu site, o seu plugin, o seu construtor de sites) e depois pode pedir uma validação no relatório.
Os números referem-se a itens, não a páginas. Uma página pode conter vários itens.
Se não houver relatório para um tipo, o Google não encontrou marcação válida desse tipo ou o tipo não tem uma apresentação própria.

O que não é permitido

As diretrizes do Google para dados estruturados são curtas e rigorosas. As mais importantes:

Descreva apenas o que é visível. Nada de horários, preços ou avaliações no seu JSON-LD que um visitante não consiga encontrar na página.
Nada enganador. Os dados têm de ser uma representação honesta da página.
Na página certa. Coloque a marcação na página que ela descreve.
As imagens nos seus dados estruturados têm de poder ser obtidas e indexadas pelo Google.
Nada de avaliações falsas nem de avaliações que não venham de utilizadores reais.

Avaliações sobre a sua própria empresa

Uma regra que surpreende muitas empresas: no bloco LocalBusiness do seu próprio site, não coloque aggregateRating nem review sobre si próprio. O Google diz: se a empresa avaliada gere ela própria as avaliações sobre si, as páginas com marcação LocalBusiness ou outra marcação Organization não são elegíveis para estrelas nos resultados da pesquisa. O Google introduziu esta regra em 2019. Não importa se recolhe as avaliações por si, se as obtém de um widget ou se as copia de um site de avaliações. As estrelas da sua empresa no Google Maps vêm do seu Perfil da Empresa no Google (lição 6.5), não do seu próprio JSON-LD.

Por vezes, plugins e temas colocam automaticamente uma classificação deste tipo na sua marcação. Verifique, por isso, se o seu próprio JSON-LD contém aggregateRating e desative-o se se referir à sua própria empresa.

O que acontece em caso de abuso

Se infringir as diretrizes, o Google pode aplicar uma ação manual relativa a dados estruturados. Pode vê-la na Search Console em Segurança e ações manuais (lição 2.4). A consequência, segundo o Google: a página deixa de ser elegível para apresentações especiais. Segundo o Google, uma ação manual deste tipo não tem influência na classificação normal nos resultados da pesquisa. Depois de corrigir, peça uma nova revisão na Search Console.

Manutenção: os erros silenciosos

A maioria dos problemas não surge ao escrever, mas mais tarde.

Dois blocos que se contradizem. O seu tema coloca um bloco LocalBusiness e o seu plugin de SEO também, com outro número de telefone. Escolha uma única origem e desative a outra. Dois blocos de tipos diferentes (um WebSite e um Florist) não são problema; a mesma empresa duas vezes com dados diferentes, sim.
Dados que mudam. Novo número de telefone, mudança de morada, horários diferentes no verão. Altere primeiro no seu local habitual (o seu construtor de sites ou plugin) e depois reveja o seu Perfil da Empresa no Google, o Apple Business e os diretórios (módulo 6).
Um novo tema ou um novo construtor. Depois de renovar o site, por vezes já não há JSON-LD, ou há em duplicado. Teste após cada alteração importante.
Horários temporários. Feriados e férias indicam-se no seu Perfil da Empresa no Google como horário especial. Em JSON-LD é possível com validFrom e validThrough; não se esqueça de os retirar depois.

Um bom hábito: teste a sua página de contacto no Rich Results Test após cada alteração dos dados da empresa e após cada atualização importante do site, e consulte o relatório na Search Console uma vez por trimestre.

Na prática: testar um site WordPress e um site do AI Builder

Num site WordPress com um plugin de SEO, o Rich Results Test mostra frequentemente mais itens: WebSite, Organization ou LocalBusiness, BreadcrumbList e um Article por artigo. Num site criado com o AI Builder da WebOké, encontra na página inicial um @graph com um WebSite e a empresa como subtipo de LocalBusiness. Se quiser ver todas as propriedades desse bloco, incluindo os horários na forma abreviada openingHours, cole também o endereço no Schema Markup Validator: este mostra cada tipo e cada propriedade da schema.org. Noutros construtores de sites, o teste funciona exatamente da mesma forma.

Resumo

O Rich Results Test indica se a sua página é elegível para uma apresentação no Google; o Schema Markup Validator indica se a sua marcação é schema.org válida.
Teste com o endereço da página, não com código colado. Os problemas críticos resolvem-se sempre; os avisos apenas com dados reais.
Nada de JSON inválido nem de tipos desconhecidos, e não bloqueie para o Googlebot páginas com dados estruturados.
Nada de avaliações ou classificações sobre a sua própria empresa na sua própria marcação; o abuso pode resultar numa ação manual.
Volte a testar após cada alteração dos seus dados ou do seu site e evite blocos duplicados que se contradizem.

Questionário

Exercício

Exercício A5.3: Encontre os erros. Descarregue o ficheiro de exemplo jsonld-fouten-1.json: um bloco JSON-LD para uma florista com seis erros. Leia-o linha a linha (também o pode colar no Schema Markup Validator) e escolha, entre as dez afirmações do exercício, as seis que descrevem um erro real. O programa compara a sua escolha com a chave fixa e explica cada afirmação.

Exercício A5.3: Encontre os erros

Ficheiro deste exercício: jsonld-fouten-1.json

A. @context aponta para um endereço errado. B. telephone tem o formato errado. C. O tipo Bloemist não existe em schema.org. D. O endereço é um texto em vez de um PostalAddress. E. Os valores de geo têm de estar entre aspas. F. O horário de funcionamento usa nomes de dias em neerlandês e não a notação de 24 horas. G. Contém uma avaliação da própria empresa. H. url não pode começar por https. I. Depois da última propriedade há uma vírgula, o que torna o JSON inválido. J. sameAs não pode apontar para o Instagram. Em seguida, cole o ficheiro no Schema Markup Validator: que erros indica essa ferramenta?

Que afirmações (A a J) descrevem um erro real? Letras separadas por vírgulas, por exemplo A, B

O que preenche e o que encontramos não ficam guardados. O seu navegador memoriza as suas respostas e se concluiu o exercício com sucesso. Se tiver sessão iniciada, guardamos apenas que concluiu o exercício (quase) com sucesso em Os meus cursos; aí também o pode eliminar.

Para saber mais

Rich Results Test do Google: https://search.google.com/test/rich-results
Schema Markup Validator: https://validator.schema.org/
Google Search Central, Diretrizes gerais para dados estruturados: https://developers.google.com/search/docs/appearance/structured-data/sd-policies
Google Search Central, Fragmentos de avaliações (com a regra sobre avaliações próprias): https://developers.google.com/search/docs/appearance/structured-data/review-snippet
Ajuda da Google Search Console, Relatórios de resultados avançados: https://support.google.com/webmasters/answer/7552505
Google Search Central, Dados estruturados com JavaScript: https://developers.google.com/search/docs/appearance/structured-data/generate-structured-data-with-javascript

Cookies na WebOké

Definições de cookies

Necessários

Marketing