
Um snippet de avaliação é um pequeno trecho de uma avaliação ou classificação proveniente de um site de avaliações. Geralmente, ele é uma média das pontuações combinadas de vários avaliadores. Quando o Google encontra avaliações válidas ou marcação de classificações, ele pode exibir um rich snippet com estrelas e outras informações resumidas de avaliações ou classificações. Além do texto de avaliação, a classificação é uma avaliação descrita em escala numérica (como 1 a 5). Os snippets de avaliação podem ser exibidos em pesquisas aprimoradas ou em Painéis de informações do Google. É possível fornecer classificações para os seguintes tipos (e subtipos) de conteúdo:
O Google também aceita avaliações para os seguintes tipos (e subtipos) do schema.org:
CreativeWorkSeason
CreativeWorkSeries
Episode
Game
MediaObject
MusicPlaylist
MusicRecording
Organization
Como adicionar dados estruturados
Os dados estruturados são um formato padronizado para fornecer informações sobre uma página e classificar o conteúdo dela. Caso você não saiba muito sobre o assunto, veja como os dados estruturados funcionam.
Esta é uma visão geral de como criar, testar e lançar dados estruturados. Para ver um guia passo a passo sobre como adicioná-los a uma página da Web, confira nosso codelab.
- Adicione as propriedades obrigatórias. Para mais informações, assista a este vídeo sobre onde colocar dados estruturados JSON-LD na página.
- Siga as diretrizes.
- Valide o código usando o Teste de pesquisa aprimorada.
- Implante algumas páginas que incluam os dados estruturados e use a Ferramenta de inspeção de URL para testar como o Google vê a página. Verifique se a página está
acessível ao Google e se não está bloqueada por um arquivo robots.txt, pela tag
noindex
ou por requisitos de login. Se estiver tudo certo, peça ao Google para rastrear novamente seus URLs. - Para enviar informações ao Google sobre alterações futuras, recomendamos que você envie um sitemap. É possível automatizar isso com a API Search Console Sitemap.
Exemplos
Há várias maneiras de adicionar dados estruturados Review
a uma página:
- Adicione uma avaliação simples.
- Aninhe uma avaliação em outro tipo do schema.org usando a propriedade Review (em inglês) dele.
- Adicione avaliações agregadas. Você poderá omitir a classificação para uma avaliação individual se o conteúdo marcado contiver um autor e uma data de avaliação. Para avaliações agregadas, forneça a classificação média para que o rich snippet seja exibido.
- Use a propriedade aggregateRating (em inglês) de outro tipo de schema.org para aninhar classificações agregadas a ele.
Avaliação simples
Veja um exemplo de uma avaliação simples que você pode copiar e colar na sua página HTML.
JSON-LD
<html> <head> <title>Legal Seafood</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Review", "itemReviewed": { "@type": "Restaurant", "image": "http://www.example.com/seafood-restaurant.jpg", "name": "Legal Seafood", "servesCuisine": "Seafood", "priceRange": "$$$", "telephone": "1234567", "address" :{ "@type": "PostalAddress", "streetAddress": "123 William St", "addressLocality": "New York", "addressRegion": "NY", "postalCode": "10038", "addressCountry": "US" } }, "reviewRating": { "@type": "Rating", "ratingValue": "4" }, "name": "A good seafood place.", "author": { "@type": "Person", "name": "Bob Smith" }, "reviewBody": "The seafood is great.", "publisher": { "@type": "Organization", "name": "Washington Times" } } </script> </head> <body> </body> </html>
RDFa
<html> <head> <title>Legal Seafood</title> </head> <body> <div vocab="https://schema.org/" typeof="Review"> <div property="itemReviewed" typeof="Restaurant"> <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/> <span property="name">Legal Seafood</span> <span property="servesCuisine">Seafood</span> <span property="priceRange">$$$</span> <span property="telephone">1234567</span> <span property="address">123 William St, New York</span> </div> <span property="reviewRating" typeof="Rating"> <span property="ratingValue">4</span> </span> stars - <b>"<span property="name">A good seafood place.</span>" </b> <span property="author" typeof="Person"> <span property="name">Bob Smith</span> </span> <span property="reviewBody">The seafood is great.</span> <div property="publisher" typeof="Organization"> <meta property="name" content="Washington Times"> </div> </div> </body> </html>
Microdados
<html> <head> <title>Legal Seafood</title> </head> <body> <div itemscope itemtype="https://schema.org/Review"> <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant"> <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/> <span itemprop="name">Legal Seafood</span> <span itemprop="servesCuisine">Seafood</span> <span itemprop="priceRange">$$$</span> <span itemprop="telephone">1234567</span> <span itemprop="address">123 William St, New York</span> </div> <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating"> <span itemprop="ratingValue">4</span> </span> stars - <b>"<span itemprop="name">A good seafood place.</span>" </b> <span itemprop="author" itemscope itemtype="https://schema.org/Person"> <span itemprop="name">Bob Smith</span> </span> <span itemprop="reviewBody">The seafood is great.</span> <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization"> <meta itemprop="name" content="Washington Times"> </div> </div> </body> </html>
Avaliação aninhada
Veja um exemplo de avaliação aninhada em um Product
. Você pode copiar e
colar o exemplo na sua página HTML.
JSON-LD
<html> <head> <title>The Catcher in the Rye</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Product", "brand": { "@type": "Brand", "name": "Penguin Books" }, "description": "The Catcher in the Rye is a classic coming-of-age story: an story of teenage alienation, capturing the human need for connection and the bewildering sense of loss as we leave childhood behind.", "sku": "9780241984758", "mpn": "925872", "image": "http://www.example.com/catcher-in-the-rye-book-cover.jpg", "name": "The Catcher in the Rye", "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "author": { "@type": "Person", "name": "John Doe" }, "reviewBody": "I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood." }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "88", "bestRating": "100", "ratingCount": "20" }, "offers": { "@type": "Offer", "url": "https://example.com/offers/catcher-in-the-rye", "priceCurrency": "USD", "price": "5.99", "priceValidUntil": "2020-11-05", "itemCondition": "https://schema.org/UsedCondition", "availability": "https://schema.org/InStock", "seller": { "@type": "Organization", "name": "eBay" } } } </script> </head> <body> </body> </html>
RDFa
<html> <head> <title>The Catcher in the Rye</title> </head> <body> <div vocab="https://schema.org/" typeof="Product"> <img property="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/> <span property="name">The Catcher in the Rye</span> <div property="review" typeof="Review"> Review: <span property="reviewRating" typeof="Rating"> <span property="ratingValue">5</span> - </span> <b>"<span property="name">A masterpiece of literature</span>" </b> by <span property="author" typeof="Person"> <span property="name">John Doe</span></span>, written on <meta property="datePublished" content="2006-05-04">May 4, 2006 <div property="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div> <span property="publisher" typeof="Organization"> <meta property="name" content="Washington Times"> </span> </div> </div> </body> </html>
Microdados
<html> <head> <title>The Catcher in the Rye</title> </head> <body> <div itemscope itemtype="https://schema.org/Product"> <img itemprop="image" src="https://example.com/photos/1x1/catcher-in-the-rye-book-cover.jpg" alt="Catcher in the Rye"/> <span itemprop="name">The Catcher in the Rye</span> <div itemprop="review" itemscope itemtype="https://schema.org/Review"> Review: <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating"> <span itemprop="ratingValue">5</span> - </span> <b>"<span itemprop="name">A masterpiece of literature</span>" </b> by <span itemprop="author" itemscope itemtype="https://schema.org/Person"> <span itemprop="name">John Doe</span></span>, written on <meta itemprop="datePublished" content="2006-05-04">May 4, 2006 <div itemprop="reviewBody">I really enjoyed this book. It captures the essential challenge people face as they try make sense of their lives and grow to adulthood.</div> <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization"> <meta itemprop="name" content="Washington Times"> </span> </div> </div> </body> </html>
Avaliação agregada
Veja um exemplo de uma avaliação agregada que você pode copiar e colar na sua página HTML.
JSON-LD
<html> <head> <title>Legal Seafood</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "AggregateRating", "itemReviewed": { "@type": "Restaurant", "image": "http://www.example.com/seafood-restaurant.jpg", "name": "Legal Seafood", "servesCuisine": "Seafood", "telephone": "1234567", "address" : { "@type": "PostalAddress", "streetAddress": "123 William St", "addressLocality": "New York", "addressRegion": "NY", "postalCode": "10038", "addressCountry": "US" } }, "ratingValue": "88", "bestRating": "100", "ratingCount": "20" } </script> </head> <body> </body> </html>
RDFa
<html> <head> <title>Legal Seafood</title> </head> <body> <div vocab="https://schema.org/" typeof="AggregateRating"> <div property="itemReviewed" typeof="Restaurant"> <img property="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/> <span property="name">Legal Seafood</span> <span property="servesCuisine">Seafood</span> <span property="telephone">1234567</span> <span property="address">123 William St, New York</span> </div> <span property="ratingValue">4.2</span> out of <span property="bestRating">5</span> stars - <span property="ratingCount">123</span> votes </div> </body> </html>
Microdados
<html> <head> <title>Legal Seafood</title> </head> <body> <div itemscope itemtype="https://schema.org/AggregateRating"> <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant"> <img itemprop="image" src="https://example.com/photos/1x1/seafood-restaurant.jpg" alt="Legal Seafood"/> <span itemprop="name">Legal Seafood</span> <span itemprop="servesCuisine">Seafood</span> <span itemprop="telephone">1234567</span> <span itemprop="address">123 William St, New York</span> </div> <span itemprop="ratingValue">4.2</span> out of <span itemprop="bestRating">5</span> stars - <span itemprop="ratingCount">123</span> votes </div> </body> </html>
Avaliação agregada aninhada
Veja um exemplo de uma avaliação agregada aninhada em um Product
. Você pode copiar e colar o
exemplo na sua página HTML.
JSON-LD
<html> <head> <title>Executive Anvil</title> <script type="application/ld+json"> { "@context": "https://schema.org/", "@type": "Product", "name": "Executive Anvil", "image": [ "https://example.com/photos/1x1/photo.jpg", "https://example.com/photos/4x3/photo.jpg", "https://example.com/photos/16x9/photo.jpg" ], "brand": { "@type": "Thing", "name": "ACME" }, "aggregateRating": { "@type": "AggregateRating", "ratingValue": "4.4", "ratingCount": "89" }, "offers": { "@type": "AggregateOffer", "lowPrice": "119.99", "highPrice": "199.99", "priceCurrency": "USD" } } </script> </head> <body> </body> </html>
RDFa
<html> <head> <title>Executive Anvil</title> </head> <body> <div vocab="https://schema.org/" typeof="Product"> <span property="brand">ACME</span> <span property="name">Executive Anvil</span> <img property="image" src="https://example.com/photos/1x1/anvil_executive.jpg" alt="Executive Anvil logo" /> <span property="aggregateRating" typeof="AggregateRating"> Average rating: <span property="ratingValue">4.4</span>, based on <span property="ratingCount">89</span> reviews </span> <span property="offers" typeof="AggregateOffer"> from $<span property="lowPrice">119.99</span> to $<span property="highPrice">199.99</span> <meta property="priceCurrency" content="USD" /> </span> </div> </body> </html>
Microdados
<html> <head> <title>Executive Anvil</title> </head> <body> <div itemscope itemtype="https://schema.org/Product"> <span itemprop="brand">ACME</span> <span itemprop="name">Executive Anvil</span> <img itemprop="image" src="https://example.com/photos/1x1/anvil_executive.jpg" /> <span itemprop="aggregateRating" itemscope itemtype="https://schema.org/AggregateRating"> Average rating: <span itemprop="ratingValue">4.4</span>, based on <span itemprop="ratingCount">89</span> reviews </span> <span itemprop="offers" itemscope itemtype="https://schema.org/AggregateOffer"> from $<span itemprop="lowPrice">119.99</span> to $<span itemprop="highPrice">199.99</span> <meta itemprop="priceCurrency" content="USD" /> </span> </div> </body> </html>
Diretrizes
Seu conteúdo precisa seguir estas diretrizes para se qualificar para exibição como uma pesquisa aprimorada.
Diretrizes técnicas
- Marque uma avaliação agregada de um item, que tenha sido feita por várias pessoas, com schema.org/AggregateRating. O Google pode mostrar avaliações agregadas como rich snippets ou, no caso de alguns tipos de itens, como respostas nos resultados da pesquisa.
- Faça referência clara a um produto ou serviço específico aninhando a avaliação na marcação de
outro tipo do schema.org, como schema.org/Book ou
schema.org/Recipe (páginas em inglês), ou usando um
tipo de schema.org como um valor para a propriedade
itemReviewed
. - Verifique se as avaliações e classificações marcadas estão prontamente disponíveis para os usuários na página marcada. É necessário que fique bem claro para os usuários que a página tem conteúdo de avaliação.
- Forneça informações de avaliação sobre um item específico, não sobre uma categoria ou uma lista de itens. Para ver exemplos, consulte os erros comuns associados aos itens da lista.
- Se o snippet de avaliação for uma empresa ou organização local, siga estas diretrizes adicionais:
- Páginas que usam
LocalBusiness
ou qualquer outro tipo de dados estruturadosOrganization
não se qualificarão para o recurso de avaliação por estrelas se a entidade analisada controlar as avaliações sobre si mesma. Por exemplo, uma avaliação sobre a entidade A é colocada no site da entidade A diretamente nos dados estruturados ou por meio de um widget incorporado de terceiros. - As classificações precisam ser provenientes diretamente dos usuários.
- Não dependa de editores humanos para criar, selecionar ou compilar informações de classificações para empresas locais. Em vez disso, use dados estruturados de avaliação crítica.
- Os sites precisam coletar informações de classificações diretamente dos usuários, e não de outros sites.
- Páginas que usam
Definições de tipos de dados estruturados
É necessário incluir as propriedades obrigatórias para que seus dados estruturados sejam exibidos nos resultados da pesquisa. Também é possível incluir as propriedades recomendadas para adicionar mais informações aos seus dados estruturados, o que pode proporcionar uma melhor experiência do usuário.
Review
A definição completa de Review
está disponível em
schema.org/Review (em inglês).
Propriedades obrigatórias | |
---|---|
author |
É o autor da avaliação. O nome do avaliador precisa ser válido. Por exemplo, "50% de desconto até domingo" não é um nome válido para isso. |
itemReviewed
|
O item que está sendo avaliado. No entanto, se a avaliação estiver aninhada em outro
tipo do schema.org usando a
propriedade |
itemReviewed.name
|
É o nome do item que está sendo avaliado. Se a avaliação estiver aninhada a outro tipo do
schema.org que use a
propriedade { "@context": "https://schema.org/", "@type": "Game", "name": "Firefly", "review": { "@type": "Review", "reviewRating": { "@type": "Rating", "ratingValue": "5" }, "author": { "@type": "Person", "name": "John Doe" }, "reviewBody": "I really enjoyed this game. You get to capture fireflies and put them in jars." } } |
reviewRating
|
É a classificação dada na avaliação. A classificação pode ser um Rating aninhado ou um subtipo mais específico. O subtipo mais comum é AggregateRating. |
reviewRating.ratingValue
|
É uma classificação numérica da qualidade do item, que pode ser um número inteiro, uma fração ou porcentagem (por exemplo, "4", "60%" ou "6/10").
O Google entende a escala das frações e porcentagens, já que a escala é
implícita nelas próprias. A escala padrão para números é
de 5 pontos, em que 1 é o valor mais baixo e 5 é o mais alto. Se outra escala for
aplicada, use |
Propriedades recomendadas | |
---|---|
datePublished |
É a data em que a avaliação foi publicada, no formato ISO 8601. |
reviewRating.bestRating
|
É o maior valor permitido no sistema de classificação. Se o campo |
reviewRating.worstRating
|
É o menor valor permitido no sistema de classificação. Se o campo |
AggregateRating
A definição completa de AggregateRating
está disponível em
schema.org/AggregateRating (em inglês).
Propriedades obrigatórias | |
---|---|
itemReviewed
|
É o item que está sendo avaliado. No entanto, se a classificação agregada estiver aninhada em
outro tipo de schema.org usando a
propriedade
|
itemReviewed.name
|
É o nome do item que está sendo avaliado. Se a avaliação estiver aninhada a outro tipo do
schema.org que use a
propriedade { "@context": "https://schema.org/", "@type": "Game", "name": "Firefly", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "88", "bestRating": "100", "ratingCount": "20" } } |
ratingCount
|
É o número total de classificações dadas ao item no seu site. É necessário incluir pelo menos uma das seguintes propriedades:
|
reviewCount
|
Especifica o número de pessoas que forneceram uma avaliação com ou sem
uma classificação. É necessário incluir pelo menos uma das seguintes propriedades: |
ratingValue
|
É uma classificação numérica da qualidade do item, que pode ser um número inteiro, uma fração ou porcentagem (por exemplo, "4", "60%" ou "6/10").
O Google entende a escala das frações e porcentagens, já que a escala é
implícita nelas próprias. A escala padrão para números é
de 5 pontos, em que 1 é o valor mais baixo e 5 é o mais alto. Se outra escala for
aplicada, use |
Propriedades recomendadas | |
---|---|
bestRating |
É o maior valor permitido no sistema de classificação. Se o campo |
worstRating |
É o menor valor permitido no sistema de classificação. Se o campo |
Monitorar pesquisas aprimoradas com o Search Console
O Search Console é uma ferramenta que ajuda você a monitorar o desempenho das suas páginas na Pesquisa Google. Não é preciso se inscrever na plataforma para ser incluído nos resultados da Pesquisa Google, mas isso pode ajudar você a entender e melhorar como vemos seu site. Recomendamos verificar o Search Console nos seguintes casos:
- Depois de implantar os dados estruturados pela primeira vez
- Depois de lançar novos modelos ou atualizar o código
- Análise periódica do tráfego
Depois de implantar os dados estruturados pela primeira vez
Depois que o Google indexar as páginas, procure problemas com o relatório de status da pesquisa aprimorada relevante. Em condições ideais, você verá um aumento de páginas válidas e nenhum aumento de erros ou avisos. Se você encontrar problemas nos dados estruturados, faça o seguinte:
- Corrija os erros.
- Inspecione um URL ativo para verificar se o problema persiste.
- Solicite a validação com o relatório de status.
Depois de lançar novos modelos ou atualizar o código
Ao fazer mudanças significativas no site, monitore aumentos nos erros e avisos de dados estruturados.- Caso você perceba um aumento nos erros, talvez tenha lançado um novo modelo que não funcione ou o site esteja interagindo com o modelo existente de uma maneira nova e incorreta.
- Caso você veja uma diminuição nos itens válidos (não correspondidos por um aumento nos erros), talvez não esteja mais incorporando os dados estruturados às páginas. Use a Ferramenta de inspeção de URL para saber o que está causando o problema.
Análise periódica do tráfego
Analise o tráfego da Pesquisa Google com o Relatório de desempenho. Os dados mostrarão com que frequência sua página aparece como aprimorada na Pesquisa, com que frequência os usuários clicam nela e qual é a posição média dela nos resultados. Também é possível extrair automaticamente esses resultados com a API Search Console.Solução de problemas
Se você tiver problemas para implementar os dados estruturados, veja alguns recursos que podem ajudar.
- Pode haver um erro nos dados estruturados. Consulte a lista de erros de dados estruturados.
- Solução de problemas relacionados à ausência e à queda no total de pesquisas aprimoradas
- Em caso de dúvidas sobre rastreamento e indexação, consulte as Perguntas frequentes para webmasters.
- Faça uma pergunta durante o horário de atendimento dos webmasters.
- Poste uma pergunta no fórum para webmasters.