JSON-LD

Le JSON-LD est le format de données structurées recommandé par Google pour implémenter le vocabulaire Schema.org. Il s’intègre dans une balise script de type application/ld+json placée dans le code HTML, sans modifier l’apparence de la page.

Également appelé « JavaScript Object Notation for Linked Data ».

Pourquoi ce format plutôt qu’un autre

Les microdonnées et le RDFa imposaient d’entrelacer le balisage sémantique avec le HTML visible, ce qui rendait la maintenance pénible et les erreurs fréquentes. Le JSON-LD isole la déclaration dans un bloc unique, éditable sans toucher au contenu, et lisible d’un coup d’œil.

La notion de graphe

Un JSON-LD bien construit ne se contente pas d’empiler des blocs isolés. Il déclare un @graph dans lequel chaque nœud porte un identifiant stable (@id) et référence les autres. L’auteur d’un article pointe vers le nœud Person, qui pointe lui-même vers le nœud Organization. C’est cette structure de renvois croisés qui permet à une machine de reconstituer une entité complète plutôt qu’une collection de fiches.

Les erreurs qui invalident un balisage

• Des @id instables, qui changent d’une page à l’autre pour la même entité.
• Des propriétés déclarées mais absentes de la page visible.
• Des types mal choisis, par exemple Product pour une prestation de service.
• Une syntaxe JSON invalide, qui fait ignorer le bloc entier sans aucun message d’erreur.

Où ce terme intervient dans la méthode

Ce terme relève de la Phase 2, aligner votre entité de la méthode Passeport vers la Citation.