Optimiser la visibilité de vos avis pour le SEO et les IA génératives

Avis vérifiés, grâce à l’intégration de notre widget produit vous permet d’intégrer nativement les données structurées nécessaires à l’affichage des Rich Snippets (extraits enrichis) dans les résultats de recherche organique. 

Cependant, vous avez peut-être temporairement constaté une diminution du nombre d’extraits d’avis valides dans votre Search Console, ou encore une baisse, voire une disparition du volume d’affichage des étoiles sous les liens de vos pages produits dans les résultats de recherche (SERP) ?  

Notre widget est constitué sur la base d’un script Javascript. Google traite spécifiquement cette technologie qui nécessite d’être exécutée par un moteur de rendu pour pouvoir lire son contenu.  

Il peut arriver que Google n’exécute pas systématiquement le Javascript de notre widget produit et donc ne voit pas les données structurées qu’il contient, ce qui peut empêcher l’affichage des Rich Snippets (étoiles, nombre d’avis, extraits d’avis). 

Ce comportement est aléatoire et n’a fait l’objet d’aucune communication officielle de la part de Google.

Au-delà de Google, ce même mécanisme touche désormais les moteurs de recherche conversationnels et les assistants IA (ChatGPT, Perplexity, Google AI Overviews, etc.). Ces outils s’appuient sur le HTML brut de vos pages et n’exécutent pas le Javascript de notre widget : vos notes, vos avis, et le résumé d'avis peuvent donc ne pas être indexés. 

C’est aujourd’hui la principale raison d’intégrer des données structurées au format JSON-LD directement dans le code HTML de vos pages produit : rendre vos avis lisibles à la fois par Google (Rich Snippets) et par les moteurs de recherche IA, indépendamment de l’exécution du Javascript. 

Ainsi, pour garantir une visibilité permanente des données structurées, nous vous recommandons d’implémenter manuellement des données structurées au format JSON-LD, directement dans le code HTML de vos pages produit.

Cette intégration s’appuie sur notre API published et ce guide vous accompagne pas à pas pour enrichir vos pages produit avec des données structurées JSON-LD, conformes aux exigences de Google. 

Comme précisé dans la documentation officielle Google, avoir des données structurées correctes et bien formatées au sein de sa page ne garantit pas à 100% un affichage enrichi dans les résultats de recherche. Cet affichage reste algorythmique selon des règles que seul le moteur de recherche maitrise. 

Prérequis

  • Un client_id / client_secret OAuth2 valide (à générer dans votre espace Avis Vérifiés)
  • Un ID de variation de produit (product_variation_id) pour chaque produit de votre site. (La référence du produit pour lequel vous recevez des avis)

La documentation complète de l’API

Désactiver les Rich Snippets du widget produit

  1. Depuis le menu latéral gauche, cliquez sur Affichage des avis, puis Intégrer mes widgets.
  2. Cliquez sur le petit crayon associé au widget produit de votre choix.
  3. Depuis les paramètres avancés, décochez l'activation des Rich Snippets.

Guide d’intégration étape par étape

Récupérer le JSON-LD pré-packagé

Un nouvel endpoint dédié de l’API Published (en savoir plus sur l'API published) retourne directement le balisage JSON-LD déjà packagé (note moyenne, nombre d’avis et, le cas échéant, les avis individuels), conforme aux exigences de Google.

Vous n’avez donc plus rien à formater vous-même : il suffit de récupérer la réponse de l’API et de l’insérer côté serveur dans le HTML de votre page produit, entre les balises <script type="application/ld+json"> … </script>. C’est la méthode la plus simple et la moins sujette aux erreurs.

URL

https://api.skeepers.io/verified-reviews/v1/published/products/structured-datas

Exemple de réponse obtenue (format JSON) :

{
  "ratings": {
    "@context": "https://schema.org",
    "aggregateRating": {
      "@type": "AggregateRating",
      "ratingValue": 4.3,
      "reviewCount": 12,
      "bestRating": 5,
      "worstRating": 1,
      "itemReviewed": {
        "@id": "https://www.example.com/p/blue-widget"
      }
    }
  },
  "reviews": {
    "@context": "https://schema.org",
    "review": [
      {
        "@type": "Review",
        "reviewBody": "Great product, exactly as described!",
        "datePublished": "2024-06-24T15:12:31Z",
        "reviewRating": {
          "@type": "Rating",
          "ratingValue": 5,
          "bestRating": 5,
          "worstRating": 1
        },
        "author": {
          "@type": "Person",
          "name": "John D."
        },
        "itemReviewed": {
          "@id": "https://www.example.com/p/blue-widget"
        }
      }
    ]
  },
  "reviewSummary": {
    "@context": "https://schema.org",
    "review": {
      "@type": "Review",
      "reviewBody": "Customers love the build quality and value, with occasional notes on delivery times.",
      "datePublished": "2024-06-24T15:12:31Z",
      "author": {
        "@type": "Organization",
        "name": "Skeepers"
      },
      "itemReviewed": {
        "@id": "https://www.example.com/p/blue-widget"
      }
    }
  }
}

Insérez ce bloc tel quel dans le <head> ou juste avant la balise de fermeture </body> de votre page produit. Pensez à conserver un cache rafraîchi quotidiennement (voir Bonnes pratiques) plutôt que d’appeler l’API à chaque chargement de page.

À éviter 

L'injection JavaScript sur votre site, car Google risque de ne pas voir ou mal indexer ces données.

Bien qu’il soit techniquement possible d’injecter des données structurées via JavaScript côté frontend (par exemple avec React, Vue ou d’autres frameworks), cette approche est moins fiable car :

  • Google peut ne pas exécuter entièrement votre JavaScript, voire pas du tout, selon la vitesse de chargement de la page et le budget de crawl.
  • Les données structurées chargées de manière asynchrone peuvent être manquées ou retardées dans l’indexation.
  • Vous risquez d’obtenir des résultats inconsistants selon les produits ou les mises à jour.

Bonnes pratiques

  • Générez et intégrez les données structurées côté serveur, directement dans le HTML, avant que la page ne soit envoyée au navigateur.
  • Lorsque Googlebot ou d’autres crawlers de moteurs de recherche accèdent à votre page, les données structurées sont déjà présentes dans le HTML brut — ce qui les rend faciles et fiables à indexer.
    Exemple : Incluez le bloc <script type="application/ld+json"> dans le template HTML rendu par votre backend, par exemple en PHP, Node.js, Python (Django, Flask), Ruby, etc.
  • Une seule balise "Product" par page est autorisée pour que les Rich Snippets fonctionnent correctement.
  • N’appelez pas l’API à chaque chargement de page. L’API Published est soumise à une limitation de débit (rate limiting). Un nombre d’appels trop élevé entraîne des erreurs 429 Too Many Requests et peut priver vos pages de leur balisage. Mettez en place un cache côté serveur rafraîchi une fois par jour : pour des données d’avis, cette fréquence est largement suffisante.

Tester la validation des données

Utilisez l’outil Google Rich Results Test pour vérifier que les données structurées sont correctes et bien détectées

Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 1 sur 1