Comment vérifier vos données structurées : erreurs JSON-LD, propriétés manquantes et résultats à attendre

Les données structurées sont des informations sur une page lisibles par les machines (il s'agit d'un article avec tel titre et tel auteur, d'un produit à tel prix, d'une entreprise à telle adresse), rédigées avec le vocabulaire schema.org. Les moteurs de recherche s'en servent pour comprendre le contenu et, pour certains types, pour afficher des résultats enrichis comme le prix d'un produit ou un fil d'Ariane.

Google recommande le JSON-LD : un bloc <script type="application/ld+json"> contenant un objet JSON, distinct du HTML visible. C'est le format le plus simple à ajouter et à vérifier, et celui sur lequel porte ce guide.

À quoi ressemble un JSON-LD valide

Un article minimal : {"@context": "https://schema.org", "@type": "Article", "headline": "How to check structured data", "datePublished": "2026-09-26", "author": {"@type": "Organization", "name": "Example Team"}}. Chaque objet possède un @type ; les éléments imbriqués (l'auteur) sont des objets dotés de leur propre type ; les dates suivent la norme ISO 8601 ; les URL sont absolues.

Les erreurs qui rendent les données structurées inutilisables

1. Un JSON impossible à analyser

Une seule erreur de syntaxe, et les moteurs de recherche ignorent le bloc entier. Les causes habituelles : une virgule en trop après la dernière propriété, des guillemets typographiques courbes collés depuis un traitement de texte, un guillemet double ou un saut de ligne non échappé à l'intérieur d'une valeur, et des variables de gabarit qui ne produisent rien et laissent "name": ,. Si le JSON provient d'un champ de CMS, une balise HTML égarée à l'intérieur a le même effet.

2. Des propriétés clés manquantes

Chaque fonctionnalité de recherche documente des propriétés obligatoires (sans elles, la page n'est pas éligible à cette fonctionnalité) et des propriétés recommandées (elles l'améliorent). Une Organization sans name, un Product sans offers, review ni aggregateRating, ou un élément de fil d'Ariane sans position sont incomplets. La documentation de la galerie de recherche de Google précise les exigences de chaque fonctionnalité ; elles évoluent de temps à autre : consultez-la donc plutôt que de vous fier à votre mémoire.

3. Des URL invalides

url, logo et image doivent être des URL absolues et fonctionnelles. Les chemins relatifs, les valeurs factices comme # et les noms d'hôte de préproduction sont fréquents dans les gabarits.

4. Des blocs en double ou contradictoires

Un thème et une extension SEO qui produisent tous deux un bloc Organization ou WebSite, avec des noms ou des logos différents, c'est au mieux source de confusion. Ne générez chaque type qu'une seule fois.

5. Un balisage qui ne correspond pas à la page

Les données structurées doivent décrire ce que les visiteurs peuvent voir : des avis absents de la page, des prix différents du prix affiché ou des réponses de FAQ qui n'apparaissent pas enfreignent les consignes de Google et peuvent entraîner une action manuelle. Aucun outil de vérification automatisé ne peut en juger à votre place.

Ce que recherche l'outil de vérification SEO de Rudra

L'outil gratuit de vérification SEO lit chaque bloc JSON-LD présent dans le HTML envoyé par votre serveur (y compris les blocs entourés de commentaires HTML ou de sections CDATA, et ceux dont le type précise un charset). Il signale :

• les blocs impossibles à analyser, avec l'erreur de l'analyseur (un avertissement qui coûte des points, car le balisage est inutilisable) ;
• un même @type déclaré plusieurs fois ;
• les valeurs url, logo ou image qui ne sont pas des URL absolues valides ;
• les propriétés clés manquantes pour un ensemble volontairement restreint de types courants : name et url pour Organization et WebSite ; headline, datePublished et author pour Article, BlogPosting et NewsArticle ; name et address pour LocalBusiness ; name ainsi que l'une des propriétés offers, review ou aggregateRating pour Product ; des questions dotées d'un name et d'une réponse text pour FAQPage ; et des éléments dotés d'une position et d'un name ou d'un item pour BreadcrumbList.

Il s'agit de minimums raisonnables, pas d'une copie des exigences de chaque moteur de recherche : pour certaines fonctionnalités, Google en demande davantage, et pour Article, il classe ces propriétés parmi les recommandées plutôt que parmi les obligatoires. L'outil ne lit que le HTML avant l'exécution de JavaScript : les données structurées injectées par un gestionnaire de balises ne seront donc pas vues. Considérez ses constats comme un premier passage, puis confirmez-les avec les outils ci-dessous.

Les autres outils à utiliser

• Le test des résultats enrichis de Google montre à quelles fonctionnalités Google une page est éligible et les erreurs qui l'en empêchent. Il exécute JavaScript et voit donc aussi le balisage injecté.
• Le Schema Markup Validator (validator.schema.org) confronte tout balisage schema.org au vocabulaire, indépendamment des fonctionnalités de Google.
• Les rapports d'améliorations de la Search Console affichent les erreurs et les avertissements de chaque type de données structurées sur l'ensemble des pages explorées par Google.

Ce que les données structurées ne peuvent pas promettre

Un balisage valide et complet rend une page éligible aux résultats enrichis. Il ne les garantit pas : les moteurs de recherche décident, requête par requête, de les afficher ou non, et les fonctionnalités évoluent. Ainsi, en 2023, Google a réservé les résultats enrichis de type FAQ à un petit nombre de sites gouvernementaux et de santé faisant autorité, et a cessé d'afficher les résultats enrichis HowTo. Les données structurées ne sont pas non plus un raccourci vers un meilleur classement ; leur intérêt est d'aider les moteurs de recherche à comprendre votre contenu avec exactitude.

Une méthode de travail simple

1. Générez le JSON-LD depuis votre CMS ou vos gabarits, à partir des données qui servent à afficher la page, pour que les deux ne puissent pas diverger.
2. Ne produisez chaque type qu'une seule fois par page.
3. Après chaque modification de gabarit, vérifiez une page de chaque gabarit avec l'outil de vérification SEO et le test des résultats enrichis.
4. Après chaque déploiement, surveillez l'apparition de nouvelles erreurs dans les rapports d'améliorations de la Search Console.