Snippet de avaliação

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:

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.

  1. Adicione as propriedades obrigatórias. Para mais informações, assista a este vídeo sobre onde colocar dados estruturados JSON-LD na página.
  2. Siga as diretrizes.
  3. Valide o código usando o Teste de pesquisa aprimorada.
  4. 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.
  5. Para manter o Google informado 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:

  • Adicionar 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 estruturados Organization 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 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 avaliação. 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 aninhada em outro tipo do schema.org usando 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 aninhada 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á usada. 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 no 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 classificação agregada estiver aninhada em outro tipo de schema.org usando 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 aninhada 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 no 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.

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:

  1. Depois de implantar os dados estruturados pela primeira vez
  2. Depois de lançar novos modelos ou atualizar o código
  3. 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:

  1. Corrija os erros.
  2. Inspecione um URL ativo para verificar se o problema persiste.
  3. 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.