Snippet de avaliação

Um snippet de avaliação é um pequeno trecho de uma avaliação ou classificação publicada em 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. Você pode fornecer classificações para os seguintes tipos de conteúdo:

O Google também aceita avaliações para os seguintes tipos do schema.org:

Exemplos

Há várias maneiras de adicionar dados estruturados de avaliação a uma página:

Você pode adicionar uma avaliação simples.
Também é possível incorporar uma avaliação em outro tipo de schema.org usando a propriedade Review (em inglês) dele.
Adicionar classificações às suas avaliações.
Adicionar 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.

Avaliação simples

JSON-LD

Veja o exemplo de uma avaliação simples em JSON-LD:

RDFa

Veja o exemplo de uma avaliação simples em RDFa:

Microdados

Veja o exemplo de uma avaliação simples em microdados:

<div itemscope itemtype="https://schema.org/Review">
  <div itemprop="itemReviewed" itemscope itemtype="https://schema.org/Restaurant">
    <img itemprop="image" src="https://developers.google.com/search/docs/data-types/markup/seafood-restaurant.jpg?hl=pt-BR" 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>

Avaliação incorporada

JSON-LD

Veja o exemplo de uma avaliação incorporada em 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

Veja o exemplo de uma avaliação incorporada em RDFa:

Microdados

Veja o exemplo de uma avaliação incorporada em microdados:

<div itemscope itemtype="https://schema.org/Product">
  <img itemprop="image" src="https://developers.google.com/search/docs/data-types/markup/catcher-in-the-rye-book-cover.jpg?hl=pt-BR" 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>

Avaliação com classificações

JSON-LD

Veja um exemplo de avaliação com classificações em JSON-LD:

RDFa

Veja um exemplo de avaliação com classificações em RDFa:

Microdados

Veja um exemplo de avaliação com classificações em microdados:

Avaliação agregada

JSON-LD

Veja o exemplo de uma avaliação agregada em JSON-LD:

RDFa

Veja o exemplo de uma avaliação agregada em RDFa:

Microdados

Veja o exemplo de uma avaliação agregada em microdados:

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 estruturados Organization não se qualificam 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 da crítica.
- Os sites precisam coletar informações de classificações diretamente dos usuários, e não de outros sites.

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`	`Person` ou `Organization` É o autor da resenha. O nome do avaliador precisa ser válido. Por exemplo, "50% de desconto até domingo" não é um nome válido para um avaliador.
`itemReviewed`	`Thing` É o item que está sendo avaliado. No entanto, se a avaliação estiver incorporada a outro tipo do schema.org que use a propriedade `review`, você poderá omitir a propriedade `itemReviewed`. Os tipos válidos para o item avaliado são: `Book` `Course` `CreativeWorkSeason` `CreativeWorkSeries` `Episode` `Event` `Game` `HowTo` `LocalBusiness` `MediaObject` `Movie` `MusicPlaylist` `MusicRecording` `Organization` `Product` `Recipe` `SoftwareApplication`
`itemReviewed.name`	`Text` É o nome do item que está sendo avaliado. Se a avaliação estiver incorporada a outro tipo do schema.org que use a propriedade `review`, ainda será necessário fornecer o `name` do item avaliado. Exemplo: { "@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`	`Rating` É 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`	`Number` ou `Text` É 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"). Se a escala não for implícita (por exemplo, "4"), uma escala de 1 a 5 será assumida. Se outra escala for aplicada, use `bestRating` e `worstRating`.

Propriedades recomendadas

Propriedades recomendadas
`datePublished`	`Date` É a data em que a avaliação foi publicada, no formato ISO 8601.
`reviewRating.bestRating`	`Number` É o maior valor permitido neste sistema de classificação. A propriedade `bestRating` só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo `bestRating` for omitido, o valor 5 será adotado.
`reviewRating.worstRating`	`Number` É o menor valor permitido neste sistema de classificação. A propriedade `worstRating` só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo `worstRating` for omitido, o valor 1 será adotado.

datePublished

Date

É a data em que a avaliação foi publicada, no formato ISO 8601.

reviewRating.bestRating

Number

É o maior valor permitido neste sistema de classificação. A propriedade bestRating só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo bestRating for omitido, o valor 5 será adotado.

reviewRating.worstRating

Number

É o menor valor permitido neste sistema de classificação. A propriedade worstRating só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo worstRating for omitido, o valor 1 será adotado.

AggregateRating

A definição completa de AggregateRating está disponível em schema.org/AggregateRating (em inglês).

Propriedades obrigatórias
`itemReviewed`	`Thing` É o item que está sendo avaliado. No entanto, se a avaliação agregada estiver incorporada a outro tipo do schema.org que use a propriedade `aggregateRating`, você poderá omitir a propriedade `itemReviewed`. Os tipos válidos para o item avaliado são: `Book` `Course` `CreativeWorkSeason` `CreativeWorkSeries` `Episode` `Event` `Game` `HowTo` `LocalBusiness` `MediaObject` `Movie` `MusicPlaylist` `MusicRecording` `Organization` `Product` `Recipe` `SoftwareApplication`
`itemReviewed.name`	`Text` É o nome do item que está sendo avaliado. Se a avaliação estiver incorporada a outro tipo do schema.org que use a propriedade `review`, ainda será necessário fornecer o `name` do item avaliado. Exemplo: { "@context": "https://schema.org/", "@type": "Game", "name": "Firefly", "aggregateRating": { "@type": "AggregateRating", "ratingValue": "88", "bestRating": "100", "ratingCount": "20" } }
`ratingCount`	`Number` É o número total de classificações dadas ao item no seu site. É necessário incluir pelo menos uma das seguintes propriedades: `ratingCount` ou `reviewCount`.
`reviewCount`	`Number` 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: `ratingCount` ou `reviewCount`.
`ratingValue`	`Number` ou `Text` É 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"). Se a escala não for implícita (por exemplo, 4), será usada uma escala de 1 a 5. Se outra escala for aplicada, use `bestRating` e `worstRating`.

Propriedades recomendadas

Propriedades recomendadas
`bestRating`	`Number` É o maior valor permitido neste sistema de classificação. A propriedade `bestRating` só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo `bestRating` for omitido, o valor 5 será adotado.
`worstRating`	`Number` É o menor valor permitido neste sistema de classificação. A propriedade `worstRating` só será obrigatória se o sistema de classificação não for uma escala de cinco pontos. Se o campo `worstRating` for omitido, o valor 1 será adotado.

bestRating

Number

worstRating

Number