Notions fondamentales des données structurées JSON-LD

Les données structurées sont des données JSON lisibles par machine qui décrivent le sujet de la page : un article, une recette, un produit ou un événement. Les moteurs de recherche les utilisent pour afficher des résultats enrichis (évaluations par étoiles, fiches de recettes, fils d'Ariane) plutôt que de simples liens bleus.

Le format privilégié par Google est JSON-LD : un seul bloc <script type="application/ld+json"> dans l'en-tête ou le corps, contenant un ou plusieurs objets schema.org. Il est indépendant du HTML visible : son ajout ou sa mise à jour ne nécessite donc pas de réécrire le modèle.

Chaque objet JSON-LD a besoin de @context (presque toujours "https://schema.org") et de @type (la classe schema.org : Article, Recipe, Product, FAQPage). @context indique aux analyseurs de quel vocabulaire proviennent les noms de propriétés.

Pour Article, fournissez headline, image (URL ou tableau), datePublished, dateModified, author (un objet Person ou Organization) et publisher (Organization avec un logo). Ce sont les champs minimum nécessaires pour que Google envisage d'inclure la page dans le carrousel des actualités principales.

Les pages de produits déclarent @type Product avec name, image, description, brand, sku et un sous-objet offers contenant price, priceCurrency et availability. Associé à aggregateRating, cet ensemble permet à Google d'afficher directement des évaluations par étoiles et des extraits de prix dans le résultat de recherche.

BreadcrumbList décrit la hiérarchie de navigation. Chaque itemListElement est un ListItem avec position, name et item (l'URL). Lorsqu'il est présent, Google remplace la ligne d'URL de l'extrait par le fil d'Ariane libellé, ce qui génère davantage de clics.

Les schémas de page FAQ et HowTo permettaient auparavant d’activer des modules de résultats enrichis dans le SERP. Google a depuis limité les résultats enrichis FAQ à quelques catégories de sites (gov, edu), mais le balisage reste utile pour les assistants vocaux et d’autres consommateurs : conservez-le sur les véritables pages FAQ.

Google pénalise le balisage qui ne correspond pas à ce que voient les utilisateurs. Ne déclarez pas une note de 5 étoiles qui n’apparaît pas sur la page ; n’indiquez pas un prix de 9,99 $ que l’utilisateur ne voit jamais. Les données structurées doivent décrire fidèlement le contenu rendu.

Le test de résultats enrichis de Google (search.google.com/test/rich-results) analyse toute URL ou tout code collé, répertorie les types de schémas détectés et signale les propriétés obligatoires manquantes. Exécutez-le avant de déployer toute modification des données structurées.

Vous pouvez déclarer plusieurs blocs JSON-LD sur la même page (Article + BreadcrumbList + Organization, par exemple) ou les regrouper dans un seul tableau @graph. Les deux formes sont valides ; choisissez celle qui est la plus facile à intégrer dans votre chaîne de traitement de génération.

JSON-LD se trouve dans une balise script distincte du contenu visible. Pour le mettre à jour, régénérez le bloc JSON — n’injectez jamais les données structurées uniquement au moyen de JavaScript côté client, car Googlebot n’exécute pas toujours JavaScript de manière fiable avant l’indexation.

Quelles sont les deux propriétés de premier niveau que tout objet JSON-LD doit inclure pour constituer des données structurées valides ?

JSON-LD déclare les données structurées dans un seul bloc de script application/ld+json, @context et @type identifiant chaque objet. Les schémas courants (Article, Product, BreadcrumbList) activent des résultats de recherche enrichis lorsque le balisage reflète fidèlement la page visible. Validez le tout avec le test de résultats enrichis avant le déploiement.