Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Extrait d'avis

Un extrait d'avis correspond à une petite portion d'une note ou d'un avis tiré d'un site Web spécialisé, généralement une moyenne des notes combinées données par un grand nombre d'internautes. Lorsque Google trouve des balises d'avis ou de notes valides, un extrait enrichi comprenant des étoiles et d'autres informations récapitulatives provenant d'avis ou de notes peut s'afficher. Une note est une évaluation basée sur une échelle numérique (comprise entre 1 et 5, par exemple). Les extraits d'avis peuvent apparaître dans les résultats enrichis ou dans les fiches info Google. Vous pouvez fournir des notes pour les types (et sous-types) de contenu suivants :

Extrait d'avis dans la recherche Google

Google accepte également les avis pour les types schema.org suivants (et leurs sous-types) :

Exemples

Plusieurs options s'offrent à vous pour ajouter des données structurées Review à une page :

  • Ajoutez un avis simple.
  • Intégrez un avis dans un autre type schema.org à l'aide de sa propriété review.
  • Ajoutez des notes globales. Vous pouvez omettre la note d'un avis individuel si votre contenu balisé contient à la fois un auteur et la date de l'avis. Pour les avis globaux, vous devez fournir la note moyenne pour que l'extrait enrichi s'affiche.
  • Imbriquez les notes globales dans un autre type schema.org à l'aide de sa propriété aggregateRating.

Avis simple

Voici un exemple d'avis simple.

JSON-LD


<html>
  <head>
  <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "Review",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://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"
      },
      "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>
      <div property="publisher" typeof="Organization">
        <meta property="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Microdonnées


 <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>
      <div itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
        <meta itemprop="name" content="Washington Times">
      </div>
    </div>
  </body>
</html>

Avis imbriqué

Voici un exemple d'avis imbriqué dans une propriété Product. Vous pouvez copier et coller cet exemple sur votre propre page 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": "https://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"
        }
       },
      {
        "@type": "Review",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": "1"
        },
        "author": {
          "@type": "Person",
          "name": "Jane Doe"
        }
      }],
      "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">
        <div rel="schema:brand">
          <div typeof="schema:Brand">
            <div property="schema:name" content="Penguin"></div>
          </div>
        </div>
        <div property="schema:description" content="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."></div>
        <div property="schema:sku" content="9780241984758"></div>
        <div property="schema:mpn" content="925872"></div>
        <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"> Reviews:
          <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">4 May 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 property="review" typeof="Review">
          <span property="reviewRating" typeof="Rating">
            <span property="ratingValue">1</span> -
          </span>
          <b>"<span property="name">The worst thing I've ever read</span>" </b> by
          <span property="author" typeof="Person">
            <span property="name">Jane Doe</span></span>, written on
          <meta property="datePublished" content="2006-05-10">10 May 2006
          <span property="publisher" typeof="Organization">
            <meta property="name" content="Washington Times">
          </span>
        </div>
        <div rel="schema:aggregateRating">
          <div typeof="schema:AggregateRating">
            <div property="schema:reviewCount" content="89"></div>
            <div property="schema:ratingValue" content="4.4">4,4</div> stars
          </div>
        </div>
        <div rel="schema:offers">
          <div typeof="schema:Offer">
            <div property="schema:price" content="4.99"></div>
            <div property="schema:availability" content="https://schema.org/InStock"></div>
            <div property="schema:priceCurrency" content="GBP"></div>
            <div property="schema:priceValidUntil" datatype="xsd:date" content="2020-11-21"></div>
            <div rel="schema:url" resource="https://example.com/catcher"></div>
            <div property="schema:itemCondition" content="https://schema.org/UsedCondition"></div>
          </div>
        </div>
    </div>
  </body>
</html>

Microdonnées


 <html>
  <head>
    <title>The Catcher in the Rye</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <div itemprop="brand" itemtype="https://schema.org/Brand" itemscope>
        <meta itemprop="name" content="Penguin" />
      </div>
      <meta itemprop="description" content="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." />
      <meta itemprop="sku" content="0446310786" />
      <meta itemprop="mpn" content="925872" />
      <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"> Reviews:
        <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">4 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
            <meta itemprop="name" content="Washington Times">
        </span>
      </div><div itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span> -
        </span>
        <b>"<span itemprop="name">The worst thing I've ever read</span>" </b> by
        <span itemprop="author" itemscope itemtype="https://schema.org/Person">
          <span itemprop="name">Jane Doe</span></span>, written on
        <meta itemprop="datePublished" content="2006-05-10">10 May 2006
        <span itemprop="publisher" itemscope itemtype="https://schema.org/Organization">
          <meta itemprop="name" content="Washington Times">
        </span>
      </div>
      <div itemprop="aggregateRating" itemtype="https://schema.org/AggregateRating" itemscope>
        <meta itemprop="reviewCount" content="89" />
        <span itemprop="ratingValue" content="4.4">4,4</span> stars
      </div>
      <div itemprop="offers" itemtype="https://schema.org/Offer" itemscope>
        <link itemprop="url" href="https://example.com/catcher" />
        <meta itemprop="availability" content="https://schema.org/InStock" />
        <meta itemprop="priceCurrency" content="GBP" />
        <meta itemprop="itemCondition" content="https://schema.org/UsedCondition" />
        <meta itemprop="price" content="4.99" />
        <meta itemprop="priceValidUntil" content="2020-11-21" />
      </div>
    </div>
  </body>
</html>

Note globale

Voici un exemple de note globale.

JSON-LD


<html>
  <head>
    <title>Legal Seafood</title>
    <script type="application/ld+json">
    {
      "@context": "https://schema.org/",
      "@type": "AggregateRating",
      "itemReviewed": {
        "@type": "Restaurant",
        "image": "https://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>

Microdonnées


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

Note globale imbriquée

Voici un exemple de note globale imbriquée dans une propriété Product. Vous pouvez copier et coller cet exemple sur votre propre page 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": "Brand",
      "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" typeof="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>

Microdonnées


 <html>
  <head>
    <title>Executive Anvil</title>
  </head>
  <body>
    <div itemscope itemtype="https://schema.org/Product">
      <span itemprop="brand" itemtype="https://schema.org/Brand" itemscope>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>

Consignes

Votre contenu doit suivre ces consignes pour pouvoir apparaître sous forme de résultat enrichi.

Consignes techniques

  • Assurez-vous d'utiliser la propriété schema.org/AggregateRating pour baliser la note globale donnée par plusieurs personnes à un élément. Google peut afficher les notes globales sous forme d'extraits enrichis ou, dans certains cas, sous forme de réponses dans les résultats de recherche.
  • Faites clairement référence à un produit ou à un service spécifique en imbriquant l'avis dans le balisage d'un autre type schema.org, tel que schema.org/Book ou schema.org/Recipe, ou en utilisant un type schema.org comme valeur pour la propriété itemReviewed.
  • Assurez-vous que les utilisateurs peuvent facilement accéder aux avis et notes que vous balisez depuis la page balisée. Ils doivent comprendre immédiatement que la page contient des avis.
  • Veillez à ne fournir un avis que sur un élément spécifique, et non sur une catégorie ou une liste d'éléments.
  • Si vous incluez plusieurs avis, ajoutez une note globale pour chacun d'eux.
  • Ne regroupez pas les avis provenant d'autres sites Web.
  • Si l'extrait d'avis concerne un établissement local ou une organisation, vous devez suivre ces instructions supplémentaires :
    • Si l'entité examinée contrôle les avis la concernant, les pages qui utilisent LocalBusiness ou tout autre type de données structurées Organization ne peuvent pas bénéficier d'étoiles. (par exemple, lorsqu'un avis portant sur l'entité A est publié sur le site de cette même entité via ses données structurées ou via un widget tiers intégré).
    • Les notes doivent provenir directement des utilisateurs.
    • N'ayez pas recours à des rédacteurs humains pour créer, gérer ou compiler les notes relatives aux établissements locaux.

Définitions des types de données structurées

Vous devez inclure les propriétés obligatoires pour que vos données structurées s'affichent dans les résultats de recherche. Vous pouvez également inclure les propriétés recommandées pour ajouter d'autres informations à vos données structurées et ainsi offrir une meilleure expérience utilisateur.

Review

La définition complète de la propriété Review est disponible sur schema.org/Review.

Propriétés obligatoires
author

Person ou Organization

Auteur de l'avis. Le nom de l'auteur doit être valide. Par exemple "50 % de remise jusqu'à samedi" n'est pas un nom valide.

Ce champ doit comporter moins de 100 caractères. Dans le cas contraire, aucun extrait d'avis basé sur un auteur ne pourra être affiché pour votre page.

Pour aider Google à interpréter les auteurs dans différentes fonctionnalités, envisagez de suivre les bonnes pratiques en matière de balisage des auteurs.

itemReviewed

Un des types valides

Élément faisant l'objet de l'avis. Toutefois, si l'avis est imbriqué dans un autre type schema.org à l'aide de la propriété review, vous pouvez omettre la propriété itemReviewed.

Les types valides pour l'élément sur lequel porte l'avis sont les suivants :
itemReviewed.name

Text

Nom de l'élément sur lequel porte l'avis. Si l'avis est imbriqué dans un autre type schema.org avec la propriété review, vous devez tout de même indiquer le nom (name) de l'élément qui fait l'objet de l'avis. Exemple :


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "review": {
    "@type": "Review",
    "reviewRating": {
      "@type": "Rating",
      "ratingValue": "5"
    },
    "author": {
      "@type": "Person",
      "name": "John Doe"
    }
}
reviewRating

Rating

Note donnée dans cet avis. La note peut correspondre à une Rating imbriquée ou un sous-type plus spécifique. Le sous-type le plus courant est AggregateRating.
reviewRating.ratingValue

Number ou Text

Valeur numérique indiquant le niveau de qualité de l'élément sous forme de nombre, de fraction ou de pourcentage (par exemple, "4", "6/10" ou "60 %"). Google interprète l'échelle pour les fractions et les pourcentages, car elle est implicite dans la fraction elle-même ou le pourcentage. Pour les nombres, une échelle par défaut à cinq points est utilisée : 1 correspond à la valeur la plus faible et 5 à la valeur la plus élevée. Si une autre échelle est prévue, utilisez bestRating et worstRating.
Propriétés recommandées
datePublished

Date

Date à laquelle l'avis a été publié, au format ISO 8601.

reviewRating.bestRating

Number

Il s'agit de la valeur la plus élevée autorisée dans ce système de notation. En l'absence de bestRating, la valeur 5 est déduite.
reviewRating.worstRating

Number

Il s'agit de la valeur la plus faible autorisée dans ce système de notation. En l'absence de worstRating, la valeur 1 est déduite.

AggregateRating

La définition complète de l'élément AggregateRating est disponible sur schema.org/AggregateRating.

Propriétés obligatoires
itemReviewed

Un des types valides

Élément qui est évalué. Toutefois, si la note globale est imbriquée dans un autre type schema.org à l'aide de la propriété aggregateRating, vous pouvez omettre la propriété itemReviewed.

Les types valides pour l'élément sur lequel porte l'avis sont les suivants :
itemReviewed.name

Text

Nom de l'élément sur lequel porte l'avis. Si l'avis est imbriqué dans un autre type schema.org avec la propriété review, vous devez tout de même indiquer le nom (name) de l'élément qui fait l'objet de l'avis. Exemple :


{
  "@context": "https://schema.org/",
  "@type": "Game",
  "name": "Firefly",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "88",
    "bestRating": "100",
    "ratingCount": "20"
  }
}
ratingCount

Number

Nombre total de notes données à l'élément sur votre site. Vous devez indiquer au moins l'une des valeurs suivantes : ratingCount ou reviewCount.
reviewCount

Number

Spécifie le nombre de personnes ayant fourni un avis, qu'il soit accompagné d'une note ou non. Vous devez indiquer au moins l'une des valeurs suivantes : ratingCount ou reviewCount.

ratingValue

Number ou Text

Valeur numérique indiquant le niveau de qualité de l'élément sous forme de nombre, de fraction ou de pourcentage (par exemple, "4", "6/10" ou "60 %"). Google interprète l'échelle pour les fractions et les pourcentages, car elle est implicite dans la fraction elle-même ou le pourcentage. Pour les nombres, une échelle par défaut à cinq points est utilisée : 1 correspond à la valeur la plus faible et 5 à la valeur la plus élevée. Si une autre échelle est prévue, utilisez bestRating et worstRating.
Propriétés recommandées
bestRating

Number

Il s'agit de la valeur la plus élevée autorisée dans ce système de notation. En l'absence de bestRating, la valeur 5 est déduite.

worstRating

Number

Il s'agit de la valeur la plus faible autorisée dans ce système de notation. En l'absence de worstRating, la valeur 1 est déduite.

Dépannage

Si vous ne parvenez pas à mettre en œuvre ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.