Rich snippets: comentários

Novo. O schema.org permite que você marque uma variedade muito maior de tipos de itens em suas páginas, usando um vocabulário que o Google, a Microsoft e o Yahoo! podem entender. Saiba mais. O Google ainda oferece suporte a sua marcação de rich snippets existente.

Quando informações de resenhas são marcadas no corpo de uma página da Web, o Google pode identificá-las e usá-las para compreender e apresentar as informações nas suas páginas. Informações de resenhas como avaliações e descrições podem ajudar os usuários a identificar melhor as páginas que possuem conteúdo válido.

Diretrizes de uso

A função de um rich snippet de avaliação é fornecer aos usuários informações de avaliações sobre um produto ou serviço específico, como a avaliação por estrela (de 1 a 5 estrelas) e o nome dos avaliadores.

As seguintes diretrizes se aplicam a snippets de comentários:

  • Ao usar a marcação de avaliação, o tópico principal da página deve ser sobre um produto ou serviço específico. Por exemplo, não há suporte para o uso da marcação de avaliação em uma página que contém vários produtos.
  • Não há suporte para avaliações de produtos ou serviços relacionados a adultos.
  • Se a marcação tiver uma única avaliação, o nome do avaliador deverá ser um nome válido (pessoa ou organização). Por exemplo, "50% de desconto até domingo" não é um nome válido para um avaliador.

É possível marcar resenhas individuais (por exemplo, a resenha de um produto feita por um editor) ou agregar as informações de resenhas (por exemplo, a avaliação média de um comércio local ou o número total de resenhas enviadas por usuários).

Use o formato de resenha individual para páginas que contêm uma única resenha. Para páginas com uma série de resenhas, use o formato de resenha agregada. Se sua página contiver os dois (por exemplo, a resenha de um editor e um conjunto de resenhas de usuários), recomendamos escolher um formato. Use o formato de resenha individual para marcar a resenha do editor OU o formato de resenha agregada para resumir o conjunto de resenhas de usuários. Se uma página tiver os dois tipos de marcação, o Google usará a marcação de resenha agregada para exibição.

Observação: Há muitas formas possíveis de indicar avaliações em resenhas, por exemplo, estrelas, porcentagens e diversas escalas de avaliação. Mais informações sobre como mostrar avaliações em resenhas.

Resenhas individuais

exemplo de um rich snippet do Google mostrando dados de resenha

Propriedades

Uma resenha pode conter diversas propriedades diferentes que você pode marcar usando microdados, microformatos ou RDFa. O Google reconhece as seguintes propriedades de resenha, derivadas do microformato hReview. De modo geral, você pode usar o mesmo nome de propriedade para microdados, microformatos e RDFa. Quando os nomes de propriedade de microdados/RDFa e de microformatos forem diferentes, o nome de propriedade dos microformatos aparecerá entre parênteses. As propriedades em negrito são obrigatórias. Além disso, pelo menos dois dos seguintes itens devem estar presentes: rating ou dtrviewed.

Propriedade Descrição
itemreviewed (item) Item resenhado. Em microformatos, pode incluir o nome do item resenhado (fn).
rating Uma avaliação de qualidade numérica para o item (por exemplo, 4). É possível indicar uma escala de avaliação, especificando best (padrão: 5) e worst (padrão: 1). Mais informações sobre as avaliações de resenhas.
reviewer O autor da resenha.
dtreviewed A data na qual o item foi resenhado no formato de data ISO.
description O corpo da resenha.
summary Um breve resumo da resenha.

O seguinte código HTML contém uma resenha do restaurante L'Amourita Pizza.

<div>

L’Amourita Pizza

Resenha feita por Ulysses Grant em 6 de janeiro.

Pizza deliciosa e saborosa em Eastlake!
O L'Amourita serve pizzas tradicionais no estilo napolitano assadas em forno a lenha, 
 
levadas a sua mesa rapidamente e sem confusão.  A pizzaria de bairro ideal.
Avaliação: 4,5
</div>

As seções, a seguir descrevem como marcar este conteúdo usando microdados, microformatos ou RDFa.

Microdados

Este é o mesmo HTML marcado com microdados:

<div>
  <div itemscope itemtype="http://data-vocabulary.org/Review">
    
    <span itemprop="itemreviewed">L’Amourita Pizza</span>
    
    Resenha feita por <span itemprop="reviewer">Ulysses Grant</span> em
    
    <time itemprop="dtreviewed" datetime="2009-01-06">6 de janeiro</time>.
    
    <span itemprop="summary">Pizza deliciosa e saborosa em Eastlake!</span>
    <span itemprop="description">L'Amourita serve pizzas tradicionais no estilo napolitano assadas em forno a lenha, 
       
      levadas a sua mesa rapidamente e sem confusão.  Uma pizzaria de bairro ideal.</span>
    Classificação: <span itemprop="rating">4.5</span>
  </div>
</div>

Veja como este exemplo funciona:

  • Na primeira linha, <itemscope itemtype="http://data-vocabulary.org/Review"> indica que o HTML em <div> representa uma resenha. itemscope indica que o conteúdo de <div> descreve um item, e itemtype="http://data-vocabulary.org/Review" indica que o item é uma resenha.
  • O exemplo descreve propriedades da resenha, como assunto, autor e data. Para nomear as propriedades da resenha, cada elemento que contém uma dessas propriedades (como <div> ou <span>) tem um atributo itemprop designado indicando uma propriedade. Por exemplo, <span itemprop="reviewer">.
Microformatos

Este é o mesmo conteúdo HTML marcado com o microformato hReview:

​<div class="hreview">
   <span class="item">
      <span class="fn">L’Amourita Pizza</span>
   
   </span>
   Resenha feita por <span class="reviewer">Ulysses Grant</span> em 
   
   <span class="dtreviewed">
      
      6 de janeiro<span class="value-title" title="2009-01-06" ></span>
   
   </span>.
   <span class="summary">Pizza deliciosa e saborosa em Eastlake!</span>
   <span class="description">O L'Amourita serve pizzas tradicionais no estilo   
      
   napolitano, assadas em forno a lenha e levadas a sua mesa rapidamente e sem confusão.    
   Uma pizzaria de bairro ideal.</span>
   Avaliação: 
   <span class="rating">4,5</span>

</div>

Veja como este exemplo funciona.

  • Na primeira linha, class="hreview" indica que o HTML em <div> descreve uma resenha.
  • A informação estruturada é transmitida pelo atributo class (como class="rating" e class="reviewer" e os valores (como 4.5, Ulysses Grant). É possível alterar as tags como span e div para atender a suas necessidades de formatação.
  • As propriedades podem conter outras propriedades. No exemplo acima, a propriedade item descreve o sujeito da resenha e inclui a subpropriedade (nome) fn.

Texto não visível

Recomendamos o fornecimento de informações de data no formato de data ISO. Isso ajuda a garantir que suas informações apareçam corretamente nos resultados da pesquisa. Você pode fornecer essas informações, enquanto ainda exibe uma data legível na própria página, usando o padrão de classe de valor de microformatos.

Considere este snippet do exemplo de HTML acima:

   <span class="dtreviewed">
      
      6 de janeiro<span class="value-title" title="2009-01-06" />
   
   </span>.

Ao incluir esta informação de data dentro do bloco nomeado com class="dtreviewed", você indica que o analisador de rich snippets deve usar o valor do atributo title para encontrar a data em que a resenha foi escrita.

Entidades aninhadas

Na sua resenha, convém usar o formato pessoas para fornecer informações sobre o autor da resenha ou usar o formato organização para descrever um comércio que está sendo resenhado. Nesse caso, você pode aninhar a entidade pessoal ou comercial dentro da sua entidade de resenha. Mais informações sobre entidades aninhadas.

RDFa

Veja o mesmo conteúdo HTML marcado com RDFa.

<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review">
   
   <span property="v:itemreviewed">L’Amourita Pizza</span>
   
   Avaliado por
   <span property="v:reviewer">Ulysses Grant</span> em
   
   <span property="v:dtreviewed" content="2009-01-06">6 de janeiro</span>.
   
   <span property="v:summary">Pizza deliciosa e saborosa em Eastlake!</span>
   <span property="v:description">O L'Amourita serve pizzas tradicionais no estilo 
    
   napolitano, assadas em forno a lenha e levadas até a sua mesa rapidamente e sem confusão.    
   Uma pizzaria de bairro ideal.</span>
   Avaliação:
   <span property="v:rating">4,5</span>

</div>

Veja como este exemplo funciona.

  • O exemplo começa com uma declaração de namespace usando xmlns. Isso indica o namespace onde o vocabulário (uma lista de entidades e seus componentes) é especificado. É possível usar a declaração de namespace xmlns:v="http://rdf.data-vocabulary.org/#" sempre que você marcar páginas para pessoas, resenhas ou dados de locais. Use uma barra à direita e # (xmlns:v="http://rdf.data-vocabulary.org/#" ).
  • Além disso, na primeira linha, typeof="v:Review" indica que o conteúdo marcado é uma resenha.
  • Cada propriedade da resenha (como o assunto da resenha e a pessoa que resenha) é nomeada usando uma propriedade property. O nome da propriedade é assinalado com v: (<span property="v:rating">).

Texto não visível

Recomendamos o fornecimento de informações de data no formato de data ISO. Isso ajuda a garantir que suas informações apareçam corretamente nos resultados da pesquisa. É possível fornecer essas informações, enquanto exibe uma data legível na própria página, usando o atributocontent".

Considere este snippet do exemplo de HTML acima:

  <span property="v:dtreviewed" content="2009-01-06">Jan 6</span>

Ao incluir essa informação de data no atributo content , você indica que o analisador de rich snippets deve usar este valor para encontrar a data em que a resenha foi escrita.

Entidades aninhadas

Na sua resenha, convém usar o formato pessoas para fornecer informações sobre o autor da resenha ou usar o formato organização para descrever um comércio que está sendo resenhado. Nesse caso, você pode aninhar a entidade pessoal ou comercial dentro da sua entidade de resenha. Mais informações sobre entidades aninhadas.

Resenhas agregadas

O Google também reconhece marcações sobre resenhas agregadas. Por exemplo, um restaurante pode ter 24 resenhas, com uma avaliação média de 9 em uma escala que vai até 10. Agregar as resenhas permite que você transmita essas informações.

imagem de um rich snippet do Google para uma resenha agregada de um restaurante

Propriedades

O Google reconhece as seguintes propriedades de resenha agregadas, derivadas do microformato hReview-aggregate. Em geral, é possível usar o mesmo nome de propriedade para microdados, microformatos e RDFa. Onde os nomes de propriedade de microdados/RDFa e microformatos forem diferentes, o nome dos microformatos aparecerá entre parênteses. É obrigatório que as propriedades estejam em negrito. Cada item deve incluir pelo menos um count ou votes.

Property Descrição
itemreviewed(item) Item resenhado. Em microformatos, pode incluir o nome do item resenhado (fn).
rating Uma avaliação de qualidade numérica para o item (por exemplo, 4). É possível indicar uma escala de avaliação, especificando best (padrão: 5) e worst (padrão: 1). Mais informações sobre as avaliações de resenhas.
count O número total de comentários para o item em seu site. Observação: sempre que incluir count, será necessário também que a página contenha a marcação de resenha para cada item resenhado. count deve incluir somente resenhas em seu próprio site.
votes Especifica o número de pessoas que forneceram uma avaliação com ou sem uma resenha. A página deve especificar pelo menos um count ou votes.
summary Um pequeno resumo do conjunto de resenhas que estão sendo agregadas.
photo A foto ou a imagem do item que está sendo revisado.

O código a seguir representa uma resenha agregada do L'Amourita Pizza.

<div>

L’Amourita Pizza

9 de 10, com base em 24 avaliações.

5 resenhas de usuários.

</div>

As próximas seções explicam como marcar este conteúdo usando microdados, microformatos ou RDFa.

Microdados

Este é o mesmo código HTML marcado com microdados.

  <div itemscope itemtype="http://data-vocabulary.org/Review-aggregate">
    
    <span itemprop="itemreviewed">L’Amourita Pizza</span>
    
    <img itemprop="photo" src="pizza.jpg" />
    
    <span itemprop="rating" itemscope itemtype="http://data-vocabulary.org/Rating">
      <span itemprop="average">9</span>
      
      de <span itemprop="best">10</span>
    
    </span>
    com base em <span itemprop="votes">24</span> avaliações.
    
    <span itemprop="count">5</span> resenhas de usuários.
  
  </div>    

Veja como este exemplo funciona:

  • Na primeira linha, <itemscope itemtype="http://data-vocabulary.org/Review-aggregate"> indica que o HTML em <div> representa uma resenha agregada. itemscope indica que o conteúdo de <div> descreve um item, e itemtype="http://data-vocabulary.org/Review" indica que o item é uma resenha.
  • O exemplo descreve propriedades da resenha agregada, como assunto e avaliação. Para nomear as propriedades da resenha agregada, cada elemento que contém uma dessas propriedades (como <div> ou <span>) tem um atributo itemprop designado indicando uma propriedade. Por exemplo, <span itemprop="itemreviewed">.
  • Uma propriedade pode consistir de outro item (em outras palavras, um item pode incluir outros itens). Por exemplo, a resenha acima inclui uma avaliação (itemtype="http://data-vocabulary.org/Rating") com as propriedades average, beste count. Mais informações sobre as avaliações de resenhas.
Microformatos

Este é o mesmo conteúdo HTML marcado com o microformato hReview-aggregate.

<div class="hreview-aggregate">
   
   <span class="item">
      <span class="fn">L’Amourita Pizza</span>
   
      <img src="pizza.jpg" class="photo" />
   
   </span>
   <span class="rating">
      
      <span class="average">9</span> de
      
      <span class="best">10</span>
   
   </span>
   baseado em
   <span class="votes">24</span> avaliações.
   
   <span class="count">5</span> resenhas de usuários.

</div>

Veja como este exemplo funciona:

  • Na primeira linha, class="hreview-aggregate" indica que o HTML em <div> resume as resenhas em uma página.
  • A informação estruturada é transmitida pelo atributo class (como class="fn" e class="rating" e os valores (como L'Amourita Pizza, 9). É possível alterar as tags como span e div para atender a suas necessidades de formatação.
  • As propriedades podem conter outras propriedades. No exemplo acima, a propriedade rating inclui as subpropriedades average (a avaliação média) e best (a avaliação mais alta possível), e a propriedade item contém fn. Mais informações sobre entidades aninhadas.
  • votes é útil sempre que os usuários em um site de resenhas puderem avaliar um item sem escrever resenhas completas sobre ele. Seus votos contribuem com a avaliação média, mas não com o número de resenhas disponíveis.
RDFa

Veja o mesmo conteúdo HTML marcado com RDFa.

<div xmlns:v="http://rdf.data-vocabulary.org/#" typeof="v:Review-aggregate">
   
   <span property="v:itemreviewed">L’Amourita Pizza</span>
   
   <img src="pizza.jpg" rel="v:photo" />
   
   <span rel="v:rating">
      <span typeof="v:Rating">
         
         <span property="v:average">9</span>
         
         de  
         <span property="v:best">10</span>
      
      </span>
   </span>
   baseado em 
   <span property="v:votes">24</span> avaliações. 
    
   <span property="v:count">5</span> resenhas de usuários

</div>

Veja como este exemplo funciona:

  • O exemplo começa com uma declaração de namespace usando xmlns. Isso indica o namespace onde o vocabulário (uma lista de entidades e seus componentes) é especificado. É possível usar a declaração xmlns:v="http://rdf.data-vocabulary.org/# namespace" sempre que você marcar páginas para pessoas, resenhas ou dados do local. Use uma barra à direita e # (xmlns:v="http://rdf.data-vocabulary.org/#" ).
  • Além disso, na primeira linha, typeof="v:Review-aggregate" indica que o conteúdo marcado resume as resenhas em uma página.
  • Cada propriedade da resenha (como o assunto da resenha e o número de votos) é nomeada usando property. O nome da propriedade é assinalado com v: (<span property="v:itemreviewed">).
  • Queremos incluir a avaliação da resenha (typeof=v:Rating") na entidade typeof="v:Review-aggregate". Nesse caso, utilizamos rel , em vez de property para indicar uma relação entre a resenha agregada (a entidade v:Review-aggregate) e essa avaliação (the entity v:Rating). Em seguida, incluímos <span typeof="v:Rating"></div> para adicionar a entidade de avaliação de fato. Mais informações sobre entidades aninhadas.
  • votes é útil sempre que os usuários em um site de resenhas puderem avaliar um item sem escrever resenhas completas sobre ele. Seus votos contribuem com a avaliação média, mas não com o número de resenhas disponíveis.