Validateur de balisage schema : vérifier les données structurées d'une page ou de tout un site
Les données structurées disent aux moteurs de recherche de quoi parle une page, sous une forme qu'ils lisent sans deviner : ceci est un produit, voici son prix, voici l'auteur. Un validateur de balisage schema lit ce balisage et vous dit s'il se parse, s'il utilise correctement le vocabulaire et s'il est assez complet pour une fonctionnalité de recherche. Une page se teste facilement. Un site avec des milliers de pages générées par des templates a besoin du même test partout.
Ce que vérifie un validateur de balisage schema
La validation se fait à quatre niveaux, et chacun attrape un type de problème différent :
- La syntaxe. Le JSON-LD se parse-t-il ? Chaque propriété microdata est-elle à l'intérieur d'un item ? Une virgule manquante ou un guillemet non échappé peut rendre tout un bloc illisible.
- Le vocabulaire. Les types et propriétés sont-ils de vrais termes Schema.org, utilisés sur les types auxquels ils appartiennent ? Une propriété mal orthographiée est du JSON valide mais ne veut rien dire.
- Les exigences des fonctionnalités. Google documente les propriétés obligatoires et recommandées pour chaque résultat enrichi qu'il prend en charge. Un balisage peut être du Schema.org valide et manquer quand même une propriété dont Google a besoin pour un extrait produit ou une fiche d'événement.
- La concordance avec la page. Les consignes de Google sur les données structurées demandent que le balisage décrive un contenu visible par les visiteurs. Un prix dans le balisage absent de la page, ou un titre différent du titre visible, est un problème de qualité qu'aucun contrôle de syntaxe ne trouvera.
La plupart des outils page par page couvrent les trois premiers. Le quatrième exige le balisage et la page rendue côte à côte.
Le validateur de Schema.org et le test des résultats enrichis de Google
Deux outils gratuits testent une page à la fois, et ils répondent à des questions différentes. L'introduction de Google aux données structurées recommande le test des résultats enrichis pendant la construction.
| Schema Markup Validator | Test des résultats enrichis | |
|---|---|---|
| Développé par | Schema.org | |
| Pages par test | 1 | 1 |
| URL ou code collé | ✓ | ✓ |
| JSON-LD, microdata, RDFa | ✓ | ✓ |
| Tout le vocabulaire Schema.org | ✓ | – |
| Éligibilité aux résultats enrichis Google | – | ✓ |
| Propriétés obligatoires manquantes | – | ✓ |
| Aperçu du résultat | – | ✓ |
Le Schema Markup Validator a remplacé l'ancien outil de test des données structurées de Google. Utilisez-le pour savoir si un balisage est du Schema.org correct, y compris pour des types qui alimentent les knowledge panels ou les réponses IA mais n'ont pas de résultat enrichi. Utilisez le test des résultats enrichis quand l'objectif est une fonctionnalité Google précise. Aucun des deux ne teste un site entier d'un coup. SEO ProCheck explique comment déboguer des résultats enrichis en échec avec les deux.
JSON-LD, microdata et RDFa
Google lit les trois formats et les considère comme également valables quand ils sont valides, mais recommande le JSON-LD parce qu'il tient dans un seul bloc script, à part du HTML, et qu'il est le plus facile à garder correct d'un template à l'autre. Un bloc Product minimal ressemble à ceci :
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Trail Running Shoe",
"image": "https://www.example.com/shoe.jpg",
"offers": {
"@type": "Offer",
"price": "89.00",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
</script>
Microdata et RDFa placent les mêmes faits dans des attributs du HTML visible. Cela garde le balisage près du contenu, mais une modification du HTML dans un template peut le casser sans bruit. Quel que soit votre choix, utilisez-en un seul par item ; décrire le même produit deux fois dans deux formats, c'est inviter les deux à se contredire.
Les erreurs courantes de données structurées
- JSON cassé. Une virgule en trop à la fin, un guillemet typographique collé depuis un document, ou un saut de ligne brut dans une chaîne.
- @context ou @type manquant. Sans eux, un parser ne sait pas ce que décrit le bloc.
- Propriétés obligatoires manquantes. Voir le tableau ci-dessous.
- Un balisage en désaccord avec la page. Un prix qui a changé sur la page mais pas dans le balisage.
- Des valeurs périmées. Une offre dont le priceValidUntil est dépassé, ou un dateModified antérieur au datePublished.
Les propriétés obligatoires de quelques fonctionnalités courantes, d'après la galerie de recherche de Google :
| Type | Exigé par Google |
|---|---|
| Extrait produit | name, plus offers, review ou aggregateRating |
| Event | name, startDate, location |
| Recipe | name, image |
| BreadcrumbList | itemListElement: name, position, item |
| Article | 0 (toutes recommandées) |
Certains balisages sont valides mais ne rapportent plus ce qu'ils rapportaient :
| Balisage | Changement | Depuis |
|---|---|---|
| data-vocabulary.org | Non pris en charge | 2021 |
| HowTo | Pas de résultat enrichi | Septembre 2023 |
| FAQPage | Sites gouvernementaux et de santé uniquement | Août 2023 |
| FAQPage | Pas de résultat enrichi | Mai 2026 |
Pourquoi une seule page ne suffit pas
Les données structurées sont presque toujours produites par des templates. Quand elles cassent, elles cassent sur chaque page que sert le template, ou sur le sous-ensemble où un champ est vide. Tester la fiche produit que vous ouvrez par hasard ne vous montrera pas que 300 produits n'ont pas de prix parce que leur champ prix est une fourchette, ou que les articles d'un auteur n'ont pas de balisage author.
Trois choses n'apparaissent qu'à l'échelle d'un site entier :
- La couverture. Quels groupes de pages portent un balisage, et quelles pages d'un groupe n'ont pas ce qu'ont leurs voisines.
- Les cas limites. Champs vides, caractères inhabituels et valeurs que seuls certains enregistrements contiennent.
- La dérive. Un balisage valide au lancement qui a cessé de l'être après une mise en production. La documentation de Google recommande de surveiller les rapports sur les résultats enrichis après chaque déploiement, précisément pour cette raison.
Comment valider le balisage schema sur tout un site
- Crawlez le site et extrayez les données structurées de chaque page HTML. Si une partie du balisage est injectée par JavaScript, rendez aussi les pages, comme décrit dans le guide du crawler SEO JavaScript.
- Corrigez d'abord les erreurs de syntaxe. Rien d'autre ne peut être vérifié sur un bloc qui ne se parse pas.
- Regroupez les pages par template et listez les types que porte chaque groupe. Cherchez les pages auxquelles manque un type que porte la majorité de leur groupe.
- Vérifiez les propriétés obligatoires des fonctionnalités que vous visez, puis les recommandées.
- Comparez le balisage au texte visible : noms, titres et prix doivent apparaître sur la page.
- Faites des vérifications ponctuelles dans le test des résultats enrichis, une page par template, pour confirmer ce que voit Google.
- Surveillez Search Console après chaque mise en production : les rapports sur les résultats enrichis et l'inspection d'URL montrent ce que Google a trouvé lors de son propre crawl.
Les données structurées sont une étape de la checklist d'audit SEO technique, et un balisage propre aide aussi les systèmes d'IA à lire une page, comme l'explique le guide du crawler SEO IA.
Validez les données structurées avec Neova
La catégorie Données structurées de Neova marque le balisage schema de chaque page comme valide, avec avertissements ou avec erreurs, ajoute une colonne Types Schema, et donne un verdict pour chaque type dans le panneau URL. Elle lit le JSON-LD, les microdonnées et le RDFa de chaque page HTML du crawl. Quelques-uns des checks :
- Données structurées avec erreurs de syntaxe, pour un JSON-LD qui ne se parse pas ou n'a pas de @context ni de @type
- Données structurées sans propriétés obligatoires ou différentes du texte visible, pour les fonctions documentées par Google
- Données structurées sans propriétés recommandées, qui signale aussi le balisage data-vocabulary.org
- Prix du produit dans les données structurées absent de la page HTML et Date priceValidUntil de l'Offer dépassée
- Dates en conflit entre données structurées, lastmod du sitemap ou Last-Modified
- Type de données structurées courant dans son groupe de pages absent et Page HTML sans le balisage de résultat enrichi que porte son groupe de pages
- Balisage Organization ou Person sans propriétés d'identification
- Page HTML sans données structurées, qui lit aussi le HTML rendu quand le crawl l'a rendu
- Résultat enrichi invalide, d'après l'inspection d'URL de Google Search Console
Comme Neova détermine les groupes de pages à partir du HTML, un problème de template apparaît comme un seul groupe avec le même flag plutôt que des milliers de lignes séparées. Les questions sur les types et les formats trouvent leur réponse dans la FAQ balisage schema de SEO ProCheck. Voir les fonctionnalités ou télécharger Neova ; l'offre Free crawle 1 000 URL avec tous les checks.
Questions
Qu'est-ce qu'un validateur de balisage schema ?
Un outil qui lit les données structurées d'une page, en JSON-LD, microdata ou RDFa, et vérifie qu'elles se parsent, qu'elles utilisent correctement les types et propriétés Schema.org et, pour certains outils, qu'elles contiennent ce qu'exige une fonctionnalité de recherche.
Quelle est la différence entre le Schema Markup Validator et le test des résultats enrichis ?
Le Schema Markup Validator, sur validator.schema.org, vérifie le balisage par rapport à tout le vocabulaire Schema.org. Le test des résultats enrichis de Google vérifie à quels résultats enrichis Google une page est éligible et quelles propriétés obligatoires ou recommandées manquent.
Des données structurées valides garantissent-elles un résultat enrichi ?
Non. Google indique qu'un balisage valide rend une page éligible, sans garantie. Il décide d'afficher ou non un résultat enrichi selon la requête, la page et ses consignes de qualité.
Peut-on valider le balisage schema sur tout un site ?
Pas avec les outils page par page. Un crawler qui extrait et vérifie les données structurées de chaque page révèle les problèmes de template, le balisage manquant et les pages qui diffèrent de leur groupe ; vous faites ensuite une vérification ponctuelle d'une page par template dans le test des résultats enrichis.
Quel format de données structurées utiliser ?
Google lit le JSON-LD, la microdata et le RDFa et recommande le JSON-LD, car il tient dans un seul bloc à part du HTML et c'est le plus facile à maintenir.