Apprendre
Erreurs de données structurées : corriger JSON-LD, schema markup et rich results
Un guide pratique des erreurs de données structurées : ce qui bloque les rich results contre ce qui n’est qu’un avertissement, les erreurs JSON-LD courantes et comment valider la correction.
Lancez un audit DomainLens frais et utilisez le rapport comme liste de priorités.
Ce que font les données structurées et où elles échouent
Les données structurées sont un balisage lisible par machine — presque toujours du JSON-LD — qui dit aux moteurs de quoi parle la page : un produit avec un prix, un article avec un auteur, une recette avec un temps de cuisson. Valides et cohérentes avec le contenu visible, elles rendent la page éligible aux rich results : étoiles, prix, FAQ, breadcrumbs et autres résultats enrichis.
Elles échouent de deux façons. Techniquement, le JSON-LD peut être malformé ou manquer de propriétés requises, empêchant Google de l’analyser. Éditorialement, le balisage peut décrire ce que la page ne montre pas, une violation des consignes pouvant déclencher une action manuelle. Les deux suppriment l’éligibilité, mais se déboguent très différemment.
Erreurs vs avertissements : ce qui bloque les rich results
Le test des résultats enrichis et Search Console séparent les problèmes en erreurs et avertissements, et la distinction compte :
- Les erreurs sont des propriétés requises manquantes (ex. un Product sans name, un Offer sans price). Elles rendent l’élément inéligible — corrigez-les d’abord.
- Les avertissements sont des propriétés recommandées manquantes (ex. pas d’aggregateRating, pas d’image). L’élément reste éligible, mais un résultat plus complet peut gagner la place.
- Les valeurs invalides — mauvais types, formats de date incorrects, prix en texte — sont traitées comme des erreurs pour le champ concerné.
- Une page peut avoir une syntaxe valide et rester inéligible si le type d’élément n’est pas pris en charge par Google pour les rich results.
Les erreurs JSON-LD les plus courantes
- Un balisage qui ne correspond pas à la page visible — une note ou un prix en JSON-LD que l’utilisateur ne voit pas est une violation.
- Champs requis manquants : Product sans offers/price, Article sans headline, BreadcrumbList sans position sur chaque élément.
- Mauvais types : prix ou note en chaîne avec symbole monétaire, dates hors ISO 8601, URLs relatives au lieu d’absolues.
- Plusieurs blocs contradictoires — deux Organization ou deux Product sur une page avec des valeurs différentes.
- JSON-LD injecté par JavaScript qui ne survit pas dans le HTML rendu indexé par le crawler.
Comment trouver et corriger les erreurs de schema
- Passez l’URL dans le test des résultats enrichis de Google sur la page en direct et lisez chaque erreur et avertissement par élément.
- Recoupez avec le Schema Markup Validator (schema.org) pour les problèmes purement de syntaxe et de vocabulaire.
- Dans Search Console, utilisez les rapports d’améliorations (Produits, Breadcrumbs, FAQ) pour voir les erreurs à l’échelle des templates.
- Corrigez d’abord les propriétés requises, alignez chaque valeur sur ce que la page affiche, puis ajoutez les propriétés recommandées.
- Si le balisage est injecté par JS, confirmez qu’il existe dans le HTML rendu, ou passez-le côté serveur.
Les erreurs qui font rétrograder ou retirer les rich results
- Baliser du contenu non visible, ou ajouter du balisage d’avis à des pages qui n’en sont pas — les deux peuvent déclencher une action manuelle.
- Corriger un template produit et supposer tout le catalogue propre ; les erreurs de schema sont par template et se multiplient vite.
- Chasser les avertissements en ignorant la seule erreur qui rend l’élément inéligible.
- Ajouter du schema pour des types que Google ne rend pas, puis s’étonner de l’absence de rich result.
Comment valider le schema markup
Après correction, relancez le test des résultats enrichis sur l’URL en direct et confirmez zéro erreur pour le type voulu, puis suivez le rapport d’améliorations dans Search Console au déploiement sur les templates les jours suivants.
Dans DomainLens, les données structurées sont vérifiées dans le même audit que titres, canoniques et rendu — un bloc Product ou Article malformé, manquant ou présent seulement après JavaScript apparaît avec le reste du SEO technique, pas dans un silo à part.