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 :

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

Comment ajouter des données structurées

Ces données structurées représentent un format normalisé permettant de fournir des informations sur une page et de classer son contenu. En savoir plus sur le fonctionnement des données structurées

Voici, dans les grandes lignes, comment créer, tester et publier des données structurées. Pour consulter un guide détaillé sur l'ajout de données structurées à une page Web, accédez à cet atelier de programmation.

  1. Ajoutez les propriétés obligatoires. Pour déterminer où placer les données structurées sur la page, regardez Données structurées JSON-LD : où les insérer sur la page.
  2. Suivez les consignes.
  3. Validez votre code à l'aide du test des résultats enrichis.
  4. Déployez quelques pages où figurent vos données structurées et utilisez l'outil d'inspection d'URL pour découvrir comment Google voit la page. Assurez-vous que Google peut accéder à votre page et qu'elle n'est pas bloquée par un fichier robots.txt, la balise noindex ni par des identifiants de connexion. Si tout semble être en ordre, vous pouvez demander à Google d'explorer de nouveau vos URL.
  5. Pour informer Google des modifications futures de vos pages, nous vous recommandons de nous envoyer un sitemap. Vous pouvez automatiser cette opération à l'aide de l'API Sitemap de la Search Console.

Exemples

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

  • Ajoutez un avis simple.
  • Intégrez un avis dans un autre type de propriété 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 que vous pouvez copier et coller sur votre propre page 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>

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

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

Microdonnées

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

Note globale

Voici un exemple de note globale que vous pouvez copier et coller sur votre propre page 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>

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

Microdonnées

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

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 marquer 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. Ces derniers doivent comprendre immédiatement que la page contient des avis.
  • Veillez à ne fournir un avis qu'à propos d'un élément spécifique, et non au sujet d'une catégorie ou d'une liste d'éléments. Pour obtenir des exemples, reportez-vous aux erreurs fréquentes liées aux éléments de liste.
  • Si l'extrait d'avis concerne un établissement local, vous devez suivre ces instructions supplémentaires :
    • Les pages utilisant la propriété LocalBusiness ou tout autre type de données structurées Organization ne peuvent pas s'afficher sous forme d'extraits enrichis contenant des étoiles si l'entité examinée est celle qui contrôle les avis la concernant (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. À la place, utilisez des données structurées liées aux avis de critiques.
    • Les sites doivent collecter les notes auprès des utilisateurs directement concernés, et non auprès d'autres sites.

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 du critique doit être valide. Par exemple "50 % de remise jusqu'à samedi" n'est pas un nom valide.

itemReviewed

Thing

É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"
    },
    "reviewBody": "I really enjoyed this game. You
    get to capture fireflies and put them in jars."
  }
}
reviewRating

Rating

Note donnée dans cet avis. La note peut correspondre à une propriété 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 (nombre, fraction ou pourcentage). Exemple : "4", "60 %" ou "6/10". Si l'échelle n'est pas implicite (par exemple, "4"), une échelle comprise entre 1 et 5 est choisie par défaut. 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 classification. La propriété bestRating n'est requise que si le système de classification ne correspond pas à une échelle de notation à 5 points. En l'absence de bestRating, la valeur 5 est déduite par défaut.

reviewRating.worstRating

Number

Il s'agit de la valeur la plus faible autorisée dans ce système de classification. La propriété worstRating n'est requise que si le système de classification ne correspond pas à une échelle de notation à 5 points. En l'absence de worstRating, la valeur 1 est déduite par défaut.

AggregateRating

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

Propriétés obligatoires
itemReviewed

Thing

É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 (nombre, fraction ou pourcentage). Exemple : "4", "60 %" ou "6/10". Si l'échelle n'est pas implicite (par exemple, "4"), une échelle comprise entre 1 et 5 est choisie par défaut. 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 classification. La propriété bestRating n'est requise que si le système de classification ne correspond pas à une échelle de notation à 5 points. En l'absence de bestRating, la valeur 5 est déduite par défaut.

worstRating

Number

Il s'agit de la valeur la plus faible autorisée dans ce système de classification. La propriété worstRating n'est requise que si le système de classification ne correspond pas à une échelle de notation à 5 points. En l'absence de worstRating, la valeur 1 est déduite par défaut.

Suivre les résultats enrichis avec la Search Console

La Search Console est un outil qui vous permet de suivre les performances de vos pages dans la recherche Google. Il n'est pas nécessaire de vous inscrire à la Search Console pour figurer dans les résultats de recherche Google. Cependant, en vous inscrivant, vous comprendrez mieux la façon dont Google interprète votre site et serez plus à même de l'améliorer. Nous vous recommandons de consulter la Search Console dans les cas suivants :

  1. Après avoir déployé des données structurées pour la première fois
  2. Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code
  3. Analyse régulière du trafic

Après avoir déployé des données structurées pour la première fois

Une fois que Google a indexé vos pages, recherchez les problèmes à l'aide du rapport sur l'état des résultats enrichis. Idéalement, vous devriez constater une augmentation du nombre de pages valides, sans augmentation du nombre d'erreurs ou d'avertissements. Si vous détectez des problèmes au niveau des données structurées :

  1. Corrigez les erreurs.
  2. Inspectez une URL en ligne pour vérifier si le problème persiste.
  3. Demandez la validation à l'aide du rapport d'état.

Après avoir publié de nouveaux modèles ou après avoir mis à jour votre code

Lorsque vous apportez des modifications importantes à votre site Web, surveillez l'augmentation des erreurs et des avertissements relatifs aux données structurées.
  • Si vous constatez une augmentation du nombre d'erreurs, vous avez peut-être déployé un nouveau modèle qui ne fonctionne pas, ou votre site interagit différemment et de façon incorrecte avec le modèle déjà disponible.
  • Si vous constatez une diminution du nombre d'éléments valides (sans augmentation du nombre d'erreurs), vous n'intégrez peut-être plus de données structurées dans vos pages. Utilisez l'outil d'inspection d'URL pour identifier la cause du problème.

Analyse régulière du trafic

Analysez votre trafic de recherche Google à l'aide du rapport sur les performances. Les données indiquent la fréquence à laquelle votre page s'affiche en tant que résultat enrichi dans la recherche Google, ainsi que la fréquence à laquelle les internautes cliquent dessus et la position moyenne à laquelle vous apparaissez dans les résultats de recherche. Vous pouvez également extraire automatiquement ces résultats avec l'API Search Console.

Dépannage

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