Comment fonctionne cette vérification
Scanaris cherche dans le HTML de ta page toutes les balises <script type="application/ld+json">, tente d'interpréter chacune comme du JSON et vérifie que le résultat contient @context ou @type, ce qui distingue un bloc schema.org d'un JSON quelconque. Un seul bloc valide suffit pour qu'il n'y ait pas de constat. S'il n'y en a aucun, ou que ceux présents ne peuvent pas être interprétés (une virgule en trop, un guillemet non fermé), il ouvre un constat de sévérité faible. Il ne juge pas si le type choisi est le bon ni s'il manque des propriétés ; seulement s'il existe quelque chose que Google et les assistants IA peuvent lire.
Pourquoi c'est important
Les données structurées sont la façon de dire à une machine, sans ambiguïté, ce qu'est ta page : ceci est une organisation portant ce nom et ce logo, ceci est un article écrit par cette personne à cette date, ceci est un produit à ce prix avec ces notes. Google les utilise pour les résultats enrichis (étoiles, prix, questions dépliables, fil d'Ariane) et pour comprendre les entités. Les assistants IA les utilisent pour la même chose mais avec plus de poids, parce qu'elles leur évitent d'interpréter le HTML : une page avec Article et Organization bien définis a plus de chances d'être citée avec une attribution correcte qu'une page où le modèle doit deviner qui l'a écrite. C'est de sévérité faible parce que leur absence ne te retire d'aucun index ; elle te rend seulement plus difficile à comprendre.
Comment corriger
Sur l'accueil, au minimum Organization et WebSite :
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://tondomaine.com/#org",
"name": "Ton entreprise",
"url": "https://tondomaine.com/",
"logo": "https://tondomaine.com/logo.png",
"sameAs": ["https://github.com/tonentreprise", "https://www.linkedin.com/company/tonentreprise"]
},
{
"@type": "WebSite",
"url": "https://tondomaine.com/",
"name": "Ton entreprise",
"publisher": { "@id": "https://tondomaine.com/#org" }
}
]
}
</script>
- Par type de page :
ArticleouBlogPostingsur les articles (avecauthor,datePublished,dateModified) ;Productavecofferssur les fiches produit ;SoftwareApplicationsi tu vends du logiciel ;FAQPagelà où il y a de vraies questions et réponses ;BreadcrumbListpour le fil d'Ariane. - Nuxt :
useHead({ script: [{ type: 'application/ld+json', innerHTML: JSON.stringify(data) }] })sur chaque page, ou le module schema.org qui le génère à partir de composants. - Next.js : une balise
<script type="application/ld+json">dans le layout ou la page avec le JSON sérialisé. - WordPress : Yoast et Rank Math génèrent
Organization,WebSite,Articleet le fil d'Ariane sans toucher au code.
Les données doivent correspondre à ce qui est visible sur la page : Google pénalise le balisage de notes ou de prix qui n'existent pas. Et le sameAs vers tes profils publics est ce qui relie ton entité à ce que les modèles savent déjà de toi par d'autres sources.
Vérifie que c'est corrigé
curl -s https://tondomaine.com | grep -oE '<script type="application/ld\+json">[^<]*' | head -c 600
Ton JSON doit sortir. Colle-le ensuite dans le test des résultats enrichis de Google ou le validateur de schema.org : les deux te disent s'il est syntaxiquement correct et quelles propriétés recommandées manquent.
Questions fréquentes
JSON-LD ou microdonnées dans le HTML ?
JSON-LD. C'est le format que Google recommande, il va dans un bloc à part sans encombrer le gabarit et c'est le plus facile à générer depuis n'importe quel framework.
J'ai mis FAQPage et Google n'affiche pas les questions dépliables.
Depuis 2023, Google ne montre ce résultat enrichi qu'aux sites gouvernementaux et de santé. Le balisage reste utile pour que les assistants IA extraient tes questions et réponses, et c'est pour ça que cette vérification le mesure. Pourquoi certains sites sont cités et d'autres non est expliqué dans données structurées et citations par l'IA.
Est-ce que ça remplace le titre et la description ?
Non, ça les complète. Le titre et la meta description restent ce que Google affiche ; métadonnées SEO les mesure. Les données structurées sont ce que les machines comprennent en plus.