Schema e rich snippets

aggregateRating feito corretamente: o campo que o Google rejeita em silêncio

É no aggregateRating que a maioria dos rich snippets de estrelas falha sem aviso. Os campos obrigatórios, as regras de honestidade e porque as suas estrelas não aparecem.

Por LucaAtualizado 7 min

Campos obrigatórios e a distinção entre contagens

O aggregateRating exige um ratingValue e pelo menos um reviewCount ou ratingCount. O ratingValue é a média das classificações e a contagem indica quantas avaliações geraram essa média. A distinção entre as duas contagens é relevante: reviewCount conta apenas avaliações escritas, enquanto ratingCount inclui também classificações por estrelas sem texto. Se cem utilizadores classificaram o produto e quarenta escreveram algo, reviewCount é 40 e ratingCount é 100. Pode declarar os dois, mas coloque 100 no reviewCount apenas quando existem 100 avaliações escritas, porque o nome do campo é uma declaração sobre o que o número representa.

bestRating e worstRating têm como predefinição 5 e 1 e só precisam de ser declarados quando a escala for diferente da padrão. A maioria das lojas pode omiti-los.

  • ratingValue: a média, por exemplo "4,6".
  • reviewCount: o número de avaliações escritas.
  • ratingCount: o número de classificações, incluindo estrelas sem texto.
  • bestRating / worstRating: opcionais, predefinição é 5 e 1.

O que faz o Google reter o rich snippet de estrelas

As diretrizes de dados estruturados do Google exigem que o aggregateRating reflita avaliações que o utilizador pode efetivamente ver nessa página. A contagem na marcação e as avaliações apresentadas devem representar o mesmo conjunto. Quando divergem, a marcação é tratada como não representativa da página, o que é motivo suficiente para o rich snippet ser retido.

Utilizar uma classificação global única em todas as páginas de produto é uma das causas mais frequentes de rejeição. Um produto recém-lançado que herda a reputação de um produto mais vendido não satisfaz este requisito, porque o aggregateRating num Product é uma afirmação sobre aquele produto específico, não sobre a loja. A inflação por via de avaliações importadas de variantes descontinuadas ou contagens que incluem avaliações não publicadas produz o mesmo resultado.

  • Média geral da loja reutilizada em todas as páginas de produto.
  • Contagem superior ao número de avaliações visíveis na página.
  • Avaliações importadas de outro produto ou variante.
  • Contagens que incluem avaliações ocultas, removidas ou não publicadas.

Como verificar a marcação e diagnosticar a ausência de estrelas

Abra a página de produto e verifique o HTML renderizado, não o widget. Confirme que o objeto aggregateRating está no HTML do servidor com um ratingValue e uma contagem, depois conte as avaliações visíveis na página e verifique se os dois números descrevem o mesmo conjunto. O Rich Results Test assinala campos obrigatórios em falta, mas não deteta um número aparentemente correto que sobrestima a página. A ferramenta valida a estrutura, não a veracidade: uma contagem de trezentas ao lado de doze avaliações visíveis passa no validador e ainda assim corre o risco de rejeição.

O problema da injeção por JavaScript é o mais silencioso: muitas aplicações de avaliações renderizam a classificação num widget após o carregamento da página, pelo que o aggregateRating que o utilizador vê nunca chega ao HTML que o rastreador lê. Um aggregateRating correto está no HTML do servidor antes de qualquer script ser executado, é específico por produto e a contagem corresponde às avaliações da página.

2 campos
ratingValue mais um reviewCount ou ratingCount: o mínimo para um aggregateRating válido
Google structured data guidelines, 2024
1:1
A contagem na marcação deve corresponder às avaliações efetivamente visíveis na página
Google structured data guidelines, 2024
Por produto
O aggregateRating num Product é uma afirmação sobre aquele produto, não sobre a loja na sua globalidade
Google structured data policies, 2024
Perguntas frequentes
É necessário declarar reviewCount e ratingCount?
Não, é necessário pelo menos um. Utilize reviewCount quando cada entrada é uma avaliação escrita, e ratingCount quando o total inclui classificações por estrelas sem texto. Pode declarar os dois se tiver ambos os números, mas não declarar nenhum invalida o aggregateRating.
Posso utilizar a média geral da loja em todos os produtos?
Não. O aggregateRating num Product é uma afirmação sobre aquele produto, pelo que uma média geral da loja aplicada em todas as páginas é tratada como enganosa e é uma razão comum para as estrelas serem retidas. Cada produto necessita da sua própria classificação e da sua própria contagem.
É necessário declarar o bestRating?
Apenas se a sua escala não for de 5 estrelas. bestRating tem como predefinição 5 e worstRating tem como predefinição 1, pelo que uma loja com cinco estrelas padrão pode omitir ambos. Declare-os quando avalia numa escala de 10 ou qualquer outra, para que o ratingValue seja interpretado corretamente.
A marcação está validada, mas as estrelas não aparecem. Porquê?
A validação verifica a sintaxe, não a elegibilidade. As causas mais prováveis são uma contagem que contradiz as avaliações visíveis, marcação injetada por um script que o rastreador não executa, ou o Google a optar por não apresentar o snippet para essa pesquisa. Verifique primeiro o HTML renderizado e a contagem visível.