Schema de Avaliações de Produto: Guia Completo para Shopify (2026)

Quais tipos de schema são necessários para as estrelas de avaliação no Google?

São três tipos, aninhados. Um Product descreve o item. Dentro dele, um Review carrega uma avaliação individual (autor, nota, texto) e um aggregateRating carrega o resumo (nota média e total de avaliações). O Google lê o Product como pai e os outros dois como propriedades vinculadas a ele.

Nem sempre são necessários os três. Uma avaliação em destaque pode ficar sozinha dentro de review. Uma classificação por estrelas construída a partir de muitas avaliações fica dentro de aggregateRating. A maioria das lojas quer os dois: a média para o rich result com estrelas e pelo menos uma avaliação completa, para que a marcação tenha uma voz real e atribuível por trás do número.

• Product: o tipo pai, com pelo menos um name. É nele que as estrelas se sustentam.
• aggregateRating: ratingValue (a média) e reviewCount ou ratingCount.
• Review: author, reviewRating com ratingValue, e o texto da avaliação.
• reviewRating precisa de bestRating se a escala não for o padrão de 5.

Como os três tipos se aninham no JSON-LD?

Use um único script JSON-LD com "@type": "Product" no topo. Adicione um name, depois um objeto "aggregateRating" e uma propriedade "review" (um array se forem várias avaliações). O objeto aggregateRating tem ratingValue e reviewCount. Cada objeto review tem author, um reviewRating com seu próprio ratingValue e o texto da avaliação.

A estrutura é uma árvore, não uma lista plana. O Product é o tronco; aggregateRating e review são os galhos. Mantenha-os dentro das chaves do Product, e não como blocos de nível superior separados, para que o Google os leia como pertencentes àquele item. Um produto, um nó Product, com avaliações e classificações aninhadas dentro.

As avaliações precisam estar visíveis na página?

Sim. O Google exige que as avaliações e classificações marcadas com schema sejam visíveis a uma pessoa nessa mesma página. Marcar uma média 4,8 sem exibir nenhuma avaliação, ou com números que não correspondem ao que o cliente vê, é uma violação de dados estruturados: o rich result é removido ou a página é sinalizada.

Essa é a regra que a maioria das configurações Shopify descumpre em silêncio. O tema exibe um bloco JSON-LD com a nota média, mas as avaliações ficam dentro de um Widget JavaScript que carrega depois que a página é exibida. Para o cliente parece normal. Para o Google, o número marcado não tem conteúdo visível que o sustente. O schema e as avaliações exibidas precisam ser as mesmas avaliações, renderizadas no HTML da página, não um número solto sem evidência.

Quais avaliações não posso incluir na marcação de produto?

Avaliações da própria organização não são elegíveis para o rich result de estrelas de produto. Não é possível marcar avaliações da loja, da marca ou do serviço e tê-las exibidas como estrelas em um produto. O rich result de estrelas de produto é para avaliações do produto em si, escritas por clientes, não depoimentos sobre o quanto a empresa é boa.

Na prática, isso elimina alguns atalhos comuns: um bloco de depoimentos de clientes sobre a loja marcado como avaliações de produto, avaliações escritas ou solicitadas sobre a própria organização, e classificações agregadas de toda a loja em vez de vinculadas ao item específico da página. Vincule cada classificação ao produto que o comprador está visualizando, com origem em compradores reais.

• Permitido: avaliações de clientes sobre o produto específico na página.
• Não permitido: avaliações da empresa ou marca apresentadas como estrelas de produto.
• Não permitido: uma média geral da loja reutilizada em todas as páginas de produto.
• Arriscado: avaliações que você não consegue demonstrar serem genuínas e visíveis na página.

Onde colocar o schema em uma loja Shopify?

No Shopify, o template de produto renderiza o JSON-LD. Muitos temas já incluem um bloco Product básico; aplicativos de avaliação frequentemente injetam seu próprio aggregateRating nele ou exibem um bloco concorrente. O objetivo é um nó Product limpo por página de produto, com as classificações aninhadas dentro, correspondendo às avaliações exibidas na tela.

O problema é que a nota média vem do aplicativo de avaliações enquanto o schema Product vem do tema, e os dois nem sempre concordam. Se o aplicativo renderiza as avaliações no lado do cliente, as avaliações visíveis e a classificação marcada podem divergir, ou as avaliações podem estar completamente ausentes do HTML. A configuração correta mantém os números e as avaliações visíveis na mesma origem para que não possam divergir.

Quais são os erros de validação mais comuns?

Execute qualquer página de produto pelo Rich Results Test do Google e pelo Schema Markup Validator antes de confiar na configuração. Os erros se concentram em uma lista curta e a maioria envolve um valor ausente ou a marcação descrevendo algo que a página não exibe.

Corrija os erros (em vermelho) primeiro; eles bloqueiam o rich result. Avisos (em amarelo) são campos recomendados que fortalecem a elegibilidade, mas não impedem as estrelas por conta própria. Refaça o teste após cada atualização de tema ou de aplicativo, pois uma atualização pode reescrever o bloco silenciosamente.

• Campo "aggregateRating" ou "review" ausente: o Google não tem classificação para renderizar estrelas.
• "name" ausente no Product: as estrelas não têm onde se sustentar.
• ratingValue sem avaliações visíveis na página: a regra de conteúdo visível foi descumprida.
• Avaliações não presentes no HTML: o Widget as carregou após o rastreamento, então a marcação aponta para o nada.

O que uma configuração correta exige na prática?

Três coisas precisam estar alinhadas: aninhamento correto, um valor em cada campo obrigatório e avaliações visíveis que correspondam à marcação. Aninhe corretamente os tipos Product, Review e aggregateRating, preencha os campos obrigatórios e garanta que as avaliações marcadas estejam presentes e visíveis no HTML da página.

A parte difícil no Shopify raramente é a estrutura do JSON-LD: é o fato de as avaliações ficarem em um Widget e nunca chegarem ao HTML que a marcação afirma descrever. A maioria dos aplicativos de avaliação foi construída para o cliente que navega na página e para por aí. Fazer com que as avaliações existentes sejam renderizadas na página, para que o schema tenha conteúdo visível real por trás, é a lacuna que o BeyondReviews foi criado para fechar.