Vérificateur de données structurées : lisez le JSON-LD d’une page

Comment utiliser l’outil

Collez l’adresse complète d’une page et cliquez sur « Vérifier ». L’outil télécharge la page comme le ferait un navigateur, suit les redirections jusqu’à la destination et ne garde du HTML que les blocs de données structurées : le serveur ne vous renvoie pas la page entière. Si la page est protégée, ou si vous voulez tester un balisage avant de le publier, ouvrez « Coller du JSON-LD ou du HTML à la place ».

Chaque bloc trouvé reçoit sa carte : état de la syntaxe, alertes de structure, puis un paragraphe par type avec les propriétés absentes, les obligatoires d’abord. L’arbre des propriétés, replié, montre ce que l’outil a réellement lu, utile pour repérer une valeur mal imbriquée. L’outil lit jusqu’à 60 blocs par page et une requête est comptée par adresse.

Les trois formats que l’outil lit

Google accepte trois formats : JSON-LD, microdonnées et RDFa. Il les juge équivalents tant que le balisage est valide et conforme à la documentation de la fonctionnalité visée, et recommande le JSON-LD : un bloc <script> séparé du texte visible, qui se prête bien aux données imbriquées et reste le plus simple à maintenir à grande échelle.¹ L’outil traite les trois de la même façon : il convertit les microdonnées (itemscope, itemtype, itemprop) et le RDFa (typeof, property) en objets de même forme que le JSON-LD, puis applique les mêmes contrôles.

Pour le JSON-LD, il relève en plus ce qui tient à la structure du bloc : un @context absent ou étranger à schema.org, un objet sans @type ni @graph, un @id défini deux fois, une référence à un @id que le bloc ne définit pas. Les références valides entre objets d’un même @graph sont résolues avant la comparaison : un auteur renvoyé par {"@id": "#moi"} compte comme présent avec les propriétés de l’objet visé.

Trouver la ligne d’une erreur de syntaxe

Une virgule en trop après la dernière propriété, un guillemet typographique, un commentaire : le JSON est strict, et un seul caractère fautif invalide tout le bloc. Quand le navigateur indique la position de l’erreur, l’outil la convertit en numéro de ligne et de colonne dans le bloc et affiche la ligne concernée. Le message d’origine du navigateur reste visible dessous, en anglais. Un bloc en erreur n’est pas comparé aux propriétés de Google : corrigez d’abord la syntaxe.

Ce que Google liste pour chaque type

Pour les types qui ouvrent un résultat enrichi, la documentation de Google distingue les propriétés obligatoires, sans lesquelles la page n’est pas éligible, et les propriétés recommandées, qui enrichissent l’affichage. Le tableau reprend ce que les pages de Google indiquent pour chaque type ; l’outil compare votre balisage à ces listes, chemins imbriqués compris.²

Trois précisions sur ce tableau. Article et Organization n’ont aucune propriété obligatoire : Google demande d’ajouter celles qui correspondent au contenu. Pour un fil d’Ariane, item peut être omis sur le dernier élément, Google prenant alors l’adresse de la page. Pour un Product, une seule des trois propriétés review, aggregateRating ou offers suffit.⁴⁷ Les sous-types de LocalBusiness, d’Organization et d’Article sont reconnus pour une liste courante (Restaurant, Store, NewsArticle, BlogPosting et quelques autres) ; le vocabulaire complet de schema.org en compte bien davantage.

Les limites de l’outil

Respecter la liste des propriétés ne garantit pas un affichage : Google demande aussi que le balisage décrive un contenu visible sur la page, que les informations soient à jour et que les avis soient de vrais avis d’utilisateurs. Un balisage qui enfreint ces règles s’expose à une action manuelle, qui retire l’éligibilité aux résultats enrichis sans modifier le classement dans la recherche web.² L’outil lit du code, il ne compare pas le balisage au contenu affiché.

Le test des résultats enrichis de Google reste la référence pour savoir si une page est éligible, et le validateur de schema.org contrôle le balisage contre le vocabulaire complet.¹¹² Utilisez l’outil pour balayer rapidement une page, lire l’arbre et repérer les trous, puis confirmez avec ces deux services.

Autre limite : l’outil lit le HTML tel que le serveur l’envoie, sans exécuter le JavaScript. Un balisage injecté par un script après le chargement n’apparaît pas ; copiez alors le code depuis l’inspecteur du navigateur et collez-le. Enfin, la FAQ ne figure plus dans la galerie des fonctionnalités de Google :¹³ un bloc FAQPage est lu et son arbre affiché, mais il n’a pas de tableau de propriétés.

Après la vérification

Pour écrire un balisage propre plutôt que corriger un balisage cassé, le générateur de données structurées produit le JSON-LD de LocalBusiness, d’Article, de fil d’Ariane et de FAQ avec les champs que Google attend. L’article sur les données structurées et les rich snippets explique quels types valent la peine d’être posés. Et quand un site entier est à reprendre, type par type et gabarit par gabarit, c’est le travail d’un consultant SEO.

Questions fréquentes