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 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.
  • Não agregue avaliações de outros sites.
  • 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 crítica.

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

Um dos tipos válidos:

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

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"). 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 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 no sistema de classificação. Se o campo bestRating for omitido, o valor 5 será adotado.

reviewRating.worstRating

Number

É o menor valor permitido no sistema de classificação. 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

Um dos tipos válidos:

É 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 os seguintes:

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"). 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 bestRating e worstRating.

Propriedades recomendadas
bestRating

Number

É o maior valor permitido no sistema de classificação. Se o campo bestRating for omitido, o valor 5 será adotado.

worstRating

Number

É o menor valor permitido no sistema de classificação. 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.