Données structurées d'extrait d'avis (Review, AggregateRating)

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

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. En fonction du format que vous utilisez, découvrez où insérer des données structurées sur la page.
  2. Suivez les consignes.
  3. Validez votre code à l'aide de l'outil de test des résultats enrichis et corrigez les erreurs critiques, le cas échéant. Envisagez également de résoudre les problèmes non critiques que l'outil a pu signaler, car cela peut contribuer à améliorer la qualité de vos données structurées. Toutefois, ce n'est pas nécessaire pour pouvoir bénéficier 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 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
      },
      "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>"A good seafood place." </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>"A good seafood place." </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": "2024-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>"A masterpiece of literature" </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>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>"The worst thing I've ever read" </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="2024-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>"A masterpiece of literature" </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
        <div>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 itemprop="review" itemscope itemtype="https://schema.org/Review">
        <span itemprop="reviewRating" itemscope itemtype="https://schema.org/Rating">
            <span itemprop="ratingValue">1</span> -
        </span>
        <b>"The worst thing I've ever read" </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="2024-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 ou les notes 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, un avis concernant l'entité A est placé sur le site Web de l'entité A, soit directement dans ses données structurées, soit via un widget tiers intégré (par exemple, le widget Avis Google sur l'établissement ou le widget d'avis Facebook).
    • 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.

Les propriétés prises en charge par Google sont les suivantes :

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, 60% ou 6 / 10). 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.

Pour les nombres décimaux, utilisez un point au lieu d'une virgule (par exemple, 4.4 au lieu de 4,4). Dans les microdonnées et RDFa, vous pouvez utiliser les attributs content pour remplacer le contenu visible. De cette façon, vous pouvez montrer à l'utilisateur la convention de style à utiliser, tout en répondant aux exigences en termes de points pour les données structurées. Exemple :

<span itemprop="ratingValue" content="4.4">4,4</span> stars

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.

Les propriétés prises en charge par Google sont les suivantes :

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, 60% ou 6 / 10). 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.

Pour les nombres décimaux, utilisez un point au lieu d'une virgule (par exemple, 4.4 au lieu de 4,4). Dans les microdonnées et RDFa, vous pouvez utiliser les attributs content pour remplacer le contenu visible. De cette façon, vous pouvez montrer à l'utilisateur la convention de style à utiliser, tout en répondant aux exigences en termes de points pour les données structurées. Exemple :

<span itemprop="ratingValue" content="4.4">4,4</span> stars

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.

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. Lors des analyses régulières 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, il y aura une augmentation du nombre d'articles valides et pas d'augmentation du nombre d'articles non valides. Si vous détectez des problèmes au niveau des données structurées :

  1. Corrigez les éléments non valides.
  2. Inspectez une URL active 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 éléments non valides dans les données structurées.
  • Si vous constatez une augmentation du nombre d'éléments non valides, 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'éléments non valides), 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.

Lors des analyses régulières 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 ou à déboguer des données structurées, voici quelques ressources susceptibles de vous aider.