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:

Avaliação incorporada

JSON-LD

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

RDFa

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

Microdados

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

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:

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
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:

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
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.