Données structurées Product, Offer et AggregateRating : le balisage complet

Une fiche produit correctement balisée peut afficher son prix, sa disponibilité et sa note moyenne directement dans les résultats de recherche, ce qui modifie sensiblement le taux de clic sur des requêtes concurrentielles. Un balisage incomplet ou approximatif, lui, ne produit rien du tout : l'affichage enrichi est un tout ou rien, et une propriété manquante suffit à le refuser. Le sujet paraît technique et il tient en réalité à quelques décisions simples, à condition de comprendre ce que chaque type décrit et comment les trois principaux s'articulent. Cet article détaille ces propriétés, les pièges qui font perdre l'éligibilité et la manière de contrôler le résultat sur un catalogue entier.

Ce que décrit chacun des trois types

La confusion la plus fréquente consiste à traiter ces trois types comme une seule liste de propriétés à remplir, alors qu'ils décrivent trois réalités distinctes qui s'emboîtent. Le premier décrit l'objet, le deuxième décrit une proposition commerciale portant sur cet objet, le troisième décrit l'opinion agrégée de ceux qui l'ont acheté. Cette séparation n'est pas décorative : elle explique pourquoi un même produit peut porter plusieurs propositions de vente et pourquoi les avis ne se rattachent pas au prix. Le panorama général de ces éléments est présenté dans notre article sur les données structurées d'une fiche produit e-commerce.

Le type décrivant le produit rassemble ce qui reste vrai quel que soit le vendeur : le nom, l'image, la description, la marque, les identifiants normalisés, les caractéristiques physiques. Ces informations ne changent pas selon que le produit est en promotion ou en rupture. Elles constituent l'identité de l'objet et servent aux moteurs à rapprocher votre fiche de celles d'autres marchands proposant la même référence. C'est précisément pour cela que les identifiants normalisés comptent autant : sans eux, ce rapprochement devient approximatif et votre fiche perd des occasions d'apparaître dans les comparaisons.

Le type décrivant la proposition commerciale porte tout ce qui vous est propre en tant que vendeur : le prix, la devise, la disponibilité, l'état neuf ou reconditionné, la date jusqu'à laquelle le prix est valable, les conditions de livraison et de retour. Ces informations changent souvent, parfois plusieurs fois par jour sur un catalogue actif, et elles doivent rester synchronisées avec ce que voit le visiteur. Un écart entre le balisage et la page affichée constitue le motif de sanction le plus courant sur ce sujet.

Le type décrivant la note agrégée résume les évaluations reçues : une valeur moyenne, un nombre d'avis ou de notes, et l'échelle employée si elle diffère de l'échelle habituelle. Il ne remplace pas les avis individuels, qui relèvent d'un autre type, et il ne peut exister sans qu'ils existent réellement quelque part sur la page. C'est le point où la tentation de tricher est la plus forte et où les conséquences sont les plus rapides. Une note inventée se repère par simple comparaison entre le balisage et le contenu affiché, contrôle que rien n'empêche de mener à grande échelle.

Le bloc décrivant le produit

Deux propriétés seulement sont strictement obligatoires pour que le type soit valide : le nom et une image. En pratique, cette exigence minimale ne suffit jamais à obtenir un affichage enrichi, qui demande en plus une proposition de vente ou une note agrégée. Viser la validité formelle sans viser l'éligibilité est une erreur de débutant qui produit des balisages parfaitement conformes et parfaitement inutiles. La liste utile est plus longue que la liste obligatoire, et c'est celle là qu'il faut suivre. Elle se lit dans la documentation destinée aux marchands plutôt que dans la spécification générale du vocabulaire, les deux ne poursuivant pas le même objectif.

Le nom doit correspondre à celui affiché sur la page, sans mention promotionnelle ni nom de boutique ajouté. Un nom balisé différent du titre visible est une incohérence détectable automatiquement. Les images doivent être accessibles, de préférence en plusieurs formats de cadrage, et ne pas être bloquées à l'exploration, cas fréquent lorsque les visuels sont servis depuis un domaine séparé mal configuré. Trois images sous des rapports différents constituent la recommandation courante, une seule reste acceptable. Fournir plusieurs cadrages laisse au moteur le choix du format le mieux adapté à chaque emplacement d'affichage, ce qui améliore le rendu sur mobile.

La marque se déclare comme un objet portant un nom, et non comme une chaîne de caractères, distinction qui provoque encore beaucoup d'erreurs de validation. Les identifiants normalisés, code article international, référence fabricant, référence interne, doivent être renseignés dès qu'ils existent. Sur un produit fabriqué par vos soins, la référence fabricant peut être votre propre référence, ce qui est parfaitement légitime. Ne rien déclarer prive le moteur de tout point d'ancrage et affaiblit durablement la fiche. Sur une référence également vendue par des places de marché, l'absence d'identifiant revient à laisser les concurrents occuper seuls la comparaison.

La description doit reprendre le texte de la page plutôt qu'une variante rédigée pour l'occasion. Les caractéristiques physiques, poids, dimensions, couleur, matière, taille, se déclarent avec les propriétés prévues à cet effet plutôt que dans un texte libre. Cet effort supplémentaire sert directement les comparaisons automatiques et il devient déterminant sur les catégories où les caractéristiques départagent les offres, l'électroménager et l'habillement en particulier.

Prix, disponibilité et validité

Le prix se déclare comme un nombre, sans symbole monétaire, sans espace de séparation des milliers et avec un point comme séparateur décimal. La devise se déclare séparément sur trois lettres. Cette contrainte de format est la source d'erreur numéro un sur les catalogues francophones, où le prix affiché emploie la virgule et l'espace. Le balisage doit donc reformater la valeur plutôt que reprendre la chaîne affichée, ce qui demande une conversion explicite dans le gabarit. Cette conversion doit aussi gérer les prix entiers, souvent restitués sans décimale, format parfaitement accepté qui ne nécessite aucun ajout artificiel.

La disponibilité se déclare par une valeur normalisée choisie dans une liste fermée : en stock, en rupture, en précommande, produit abandonné, disponible en magasin uniquement. Cette valeur doit refléter l'état réel au moment du chargement de la page. Un catalogue dont le stock est mis à jour toutes les heures mais dont le balisage est mis en cache pour la journée produit des incohérences qui finissent par être détectées. La question du cache mérite donc d'être tranchée explicitement sur les pages produit. Exclure le bloc de balisage de la mise en cache, ou réduire fortement sa durée de vie sur les fiches à stock tendu, constitue le compromis habituel.

La date de validité du prix devient importante dès qu'une promotion est en cours. Elle indique jusqu'à quand la valeur annoncée est garantie et évite qu'un prix promotionnel ne soit affiché en résultat plusieurs semaines après la fin de l'opération. Sans cette date, le moteur applique une durée par défaut qui ne correspond pas nécessairement à votre calendrier commercial. La renseigner coûte une ligne et supprime une source récurrente de réclamations. Sur une boutique pratiquant des opérations commerciales fréquentes, elle mérite d'être alimentée automatiquement depuis la date de fin de la promotion enregistrée dans le catalogue.

Les conditions de livraison et de retour peuvent également être déclarées, avec les délais, les zones couvertes et les frais applicables. Ces informations apparaissent dans certains affichages comparatifs et elles constituent un facteur de choix réel pour l'acheteur. Elles demandent un travail de modélisation plus lourd que le reste, notamment lorsque les frais varient par zone géographique. Beaucoup de catalogues les omettent, ce qui laisse une marge de différenciation à ceux qui les renseignent correctement. Commencer par la zone de livraison principale, en laissant les cas particuliers de côté, permet d'obtenir l'essentiel du bénéfice pour une fraction du travail.

La note agrégée et les avis

Le bloc de note agrégée demande une valeur moyenne et un décompte, l'un ou l'autre étant accepté selon les cas, le nombre d'avis ou le nombre de notes. Ces deux informations doivent être visibles sur la page, à l'endroit où le visiteur les attend, et correspondre exactement aux valeurs balisées. Déclarer une note que le visiteur ne peut pas voir constitue une violation directe des règles applicables aux extraits enrichis. Le contrôle est en partie automatisé et en partie manuel, ce qui rend la détection inévitable à terme.

Les avis ne peuvent porter que sur le produit lui même, jamais sur la boutique, le service client ou la rapidité de livraison. Cette distinction est régulièrement ignorée par les sites qui affichent leur note globale de marchand sur chaque fiche produit. Le résultat est un balisage non conforme qui, une fois repéré, entraîne la perte de l'affichage enrichi sur l'ensemble du catalogue et non sur la seule page fautive. La sanction est donc disproportionnée par rapport à l'erreur, ce qui justifie une vigilance particulière. Les modalités de collecte et d'affichage sont développées dans notre article sur les avis clients vérifiés, leur collecte et leur balisage.

Les avis individuels se déclarent avec leur auteur, leur date et leur note, et leur présence renforce la crédibilité de la note agrégée. Un auteur ne peut pas être l'entreprise elle même, ni un nom générique désignant la rédaction. Déclarer une dizaine d'avis représentatifs suffit, il n'est pas nécessaire de baliser l'intégralité des évaluations reçues sur une fiche qui en compte plusieurs centaines. Cette limitation allège considérablement le poids du balisage sur les fiches très commentées. Choisir des avis récents plutôt que les mieux notés maintient par ailleurs la cohérence avec ce que le visiteur lit en haut de la liste.

L'échelle employée doit être précisée dès qu'elle s'écarte de la note sur cinq, par exemple une note sur dix ou une évaluation partant de zéro. Sans cette précision, la valeur est interprétée sur l'échelle habituelle et une note de sept devient absurde. Cette erreur est facile à commettre lors d'une migration depuis une plateforme d'avis employant une autre convention. Elle se repère immédiatement dans les outils de test, à condition de les consulter après la migration. Inscrire cette vérification dans la liste de contrôle de toute reprise de plateforme évite de la découvrir des mois plus tard.

Variantes et groupes de produits

Un vêtement décliné en cinq tailles et trois couleurs pose une question que le balisage simple ne résout pas : faut il déclarer un produit ou quinze. La réponse dépend de la structure des adresses. Si chaque combinaison dispose de sa propre page, chacune porte son propre balisage complet. Si toutes les combinaisons partagent une page unique, il faut employer le type dédié aux groupes, qui déclare le produit parent et rattache les déclinaisons avec leurs caractéristiques différenciantes et leurs prix respectifs.

Le type de groupe demande d'indiquer explicitement quelles propriétés varient, la taille, la couleur, la contenance. Cette déclaration permet au moteur de comprendre qu'il s'agit du même produit sous plusieurs formes et non de produits distincts. Elle évite aussi qu'une fourchette de prix ne soit interprétée comme une incohérence. Sur un catalogue de mode ou de cosmétique, cette modélisation représente le principal chantier de balisage et elle mérite d'être traitée sérieusement plutôt que contournée.

La fourchette de prix constitue une alternative acceptable lorsque les déclinaisons ont des prix différents et que leur détail n'apporte rien. Elle se déclare avec un prix minimal, un prix maximal et la devise. C'est une solution simple qui convient bien aux catalogues où la variation de prix est faible. Elle devient insatisfaisante dès que l'écart entre les extrêmes est important, l'affichage d'un prix minimal très inférieur au prix réel du produit consulté produisant une déception au clic.

Les produits vendus par lot ou par conditionnement demandent une attention particulière, car le prix unitaire et le prix du lot ne décrivent pas la même chose. Déclarer le prix unitaire alors que la page vend un lot de six crée une incohérence évidente au moment du panier. La règle est de baliser ce qui est effectivement ajouté au panier, le prix unitaire pouvant être mentionné dans une propriété prévue à cet effet. Cette cohérence entre balisage et transaction réelle est le fil conducteur de tout le sujet. Chaque fois qu'une question se pose sur une propriété, se demander ce que le visiteur paiera effectivement donne presque toujours la bonne réponse.

Les erreurs qui font perdre l'éligibilité

Certaines erreurs empêchent seulement l'affichage enrichi, d'autres exposent à une action manuelle qui retire l'éligibilité sur l'ensemble du site pour une durée indéterminée. Distinguer les deux catégories aide à prioriser les corrections. Les erreurs de format, prix mal écrit, marque déclarée en texte, échelle absente, relèvent de la première catégorie et se corrigent sans autre conséquence. Les écarts entre le balisage et le contenu visible relèvent de la seconde et méritent un traitement immédiat.

Baliser un contenu absent de la page est l'infraction la plus grave et la plus répandue. Cela inclut les notes agrégées sur des produits sans avis, les prix promotionnels non affichés, les disponibilités optimistes et les caractéristiques inventées. Ces pratiques sont détaillées dans notre article sur les données structurées abusives et leurs risques en SEO. Elles produisent un gain de court terme suivi d'une perte durable, arbitrage rarement favorable.

Le balisage de la même fiche à plusieurs endroits, par le thème et par une extension, produit des doublons qui se contredisent parfois. Cette situation est fréquente sur les boutiques ayant accumulé les extensions au fil des années. Le remède consiste à désactiver toutes les sources sauf une, opération qui demande de savoir laquelle est active, information pas toujours évidente à obtenir. Un contrôle du code rendu tranche la question en quelques secondes. Il suffit de rechercher la mention du type de produit dans le document et de compter les occurrences pour savoir combien de sources sont actives.

Le balisage placé dans un contenu chargé après coup par un script peut ne pas être vu, selon le moment où le rendu intervient. Le placer dans le document initial, sous forme de bloc dédié en tête de page, supprime cette incertitude. Cette recommandation vaut particulièrement pour les boutiques construites entièrement côté navigateur, où le balisage produit tardivement est le premier suspect quand rien ne s'affiche en résultat. La comparaison entre le code source envoyé par le serveur et le document après exécution répond en quelques secondes à cette question.

Contrôler et maintenir le balisage

Le contrôle se mène à trois niveaux et les trois sont nécessaires. L'outil de test officiel valide une adresse à la fois et indique les propriétés manquantes ou mal formées, ce qui convient parfaitement à la mise au point initiale sur un gabarit. Il ne dit rien de l'état du catalogue entier, ce qui en fait un outil de développement plutôt qu'un outil de surveillance. L'employer sur trois fiches représentatives, un produit simple, un produit à variantes et un produit en rupture, couvre l'essentiel des cas. Y ajouter une fiche en promotion et une fiche sans avis complète utilement l'échantillon lorsque le catalogue comporte ces situations.

Les rapports des outils pour webmasters donnent la vision d'ensemble : nombre de fiches valides, nombre d'avertissements, nombre d'erreurs, avec des exemples d'adresses concernées. Ces rapports se mettent à jour avec un décalage de plusieurs jours, ce qui impose de la patience après une correction. Ils constituent la source de référence pour mesurer l'effet d'une intervention sur un catalogue important, et leur consultation mensuelle suffit largement. Une hausse soudaine du nombre d'erreurs signale en général une mise à jour d'extension plutôt qu'une dérive progressive des données.

Une exploration complète du site avec extraction du balisage permet enfin de repérer les cas particuliers que les deux méthodes précédentes manquent. Les outils d'exploration savent extraire les blocs et les exporter dans un tableau, ce qui permet de trier par prix nul, par disponibilité manquante ou par note anormale. Cette vérification prend une heure sur un catalogue de plusieurs milliers de références et elle révèle presque toujours des anomalies concentrées sur une famille de produits mal alimentée. Ce regroupement est une bonne nouvelle : corriger la source d'alimentation de cette famille règle d'un coup plusieurs centaines de fiches.

La maintenance repose sur un principe simple : le balisage se génère depuis les mêmes données que l'affichage, jamais depuis une source parallèle. Dès qu'un champ est saisi deux fois, une fois pour la page et une fois pour le balisage, la divergence n'est plus qu'une question de temps. Sur les boutiques construites avec une extension de commerce, cette règle est respectée par construction et le travail consiste surtout à vérifier que rien ne vient s'y superposer. Sur un développement sur mesure, elle doit être posée explicitement dès la conception du gabarit produit. Écrire cette règle dans les conventions du projet évite qu'un intervenant ultérieur ne crée une seconde source de vérité par commodité.