Ein JSON-basiertes Format zur Darstellung verknüpfter strukturierter Daten, das meist in ein Script-Element eingebettet wird. So kann eine Seite Entitäten und Beziehungen beschreiben, ohne das sichtbare HTML zu verändern.
Die Entscheidung und ihre Grenze
JSON-LD ist eine Möglichkeit, verknüpfte Daten in JSON zu serialisieren. Auf Webseiten steht es oft in einem Script-Element und nutzt das Vokabular von Schema.org, um dieselben Entitäten zu beschreiben, die ein Leser sieht: einen Artikel, ein Produkt, eine Organisation, einen Breadcrumb oder ein Event. JSON-LD ist ein Darstellungsformat, kein Versprechen auf ein Rich-Suchergebnis. Der Graph muss syntaktisch gültig sein und zu den sichtbaren, aktuellen Fakten der Seite passen.
Was zu prüfen ist
Lesen Sie das gerenderte HTML aus, statt anzunehmen, dass die Quellvorlage nach dem Deployment unverändert ist. Parsen Sie das JSON-LD, identifizieren Sie jeden Knoten mit seinen Kennungen und vergleichen Sie wichtige Eigenschaften mit der sichtbaren Seite. Prüfen Sie, ob URLs aufgelöst werden, Verweise auf die beabsichtigten Entitäten zeigen und Werte wie Datum, Preis, Verfügbarkeit, Autor und Bild nicht veraltet sind. Werten Sie Warnungen des Validators im Kontext aus: Eine Meldung ist ein Hinweis zur Prüfung, kein automatischer Defekt.
Ein praktischer Umsetzungsweg
Wählen Sie den kleinsten passenden Schema.org-Typ, modellieren Sie zuerst die Hauptentität und ergänzen Sie verknüpfte Entitäten nur dort, wo die Seite ihre Fakten zeigt. Erzeugen Sie die Werte möglichst aus derselben strukturierten Quelle, die auch das sichtbare Template nutzt. Validieren Sie nach dem Release eine repräsentative gerenderte Seite und legen Sie danach Regressionsprüfungen für Templates an, die viele Seiten erzeugen. Halten Sie Sitemap-, Canonical- und robots-Prüfungen getrennt von der JSON-LD-Validierung.
Fehler und Grenzen der Messung
Der typische Fehler ist Schema-Theater: Vokabular hinzufügen, das die Seite nicht stützt, in der Hoffnung, ein Suchfeature zu erzwingen. Versteckte, erfundene oder widersprüchliche Eigenschaften erhöhen den Wartungsaufwand und machen den Graphen weniger vertrauenswürdig. Ich validiere strukturierte Daten zuerst gegen die sichtbare Seite und prüfe danach den Graphen. Ich korrigiere echte Vokabular- oder Verweisfehler, nicht nur das, was den Checker ruhig stellt.
Umsetzungsbeispiel. Beginnen Sie bei einem redaktionellen Artikel mit dem sichtbaren Datensatz: Überschrift, Byline, Veröffentlichungsdatum, Titelbild, kanonische URL und Identität des Herausgebers. Modellieren Sie den Artikel in JSON-LD aus denselben Inhaltsfeldern, die auch die Seite rendern. Geben Sie dem Artikel eine stabile Kennung und verlinken Sie Herausgeber und Bild nur, wenn diese Entitäten echt sind und sich auflösen lassen. Fehlen Autor, Datum oder Bild auf der sichtbaren Seite, erfinden Sie sie nicht im Graphen, nur um einen Validator zufriedenzustellen.
Prüfkriterien. Rufen Sie nach dem Deployment das gerenderte HTML ab, extrahieren Sie jedes JSON-LD-Script und parsen Sie jeden Graphen. Vergleichen Sie Überschrift, Datum, Bild, URL und Autor mit der für Menschen sichtbaren Seite. Prüfen Sie, dass Kennungen und URLs auf die beabsichtigten Ressourcen zeigen und ein Artikel nicht versehentlich eine andere Entität des Templates beschreibt. Führen Sie den passenden Test für strukturierte Daten aus, ordnen Sie die Befunde aber ein: Ein Parsing-Fehler, eine Abweichung im Vokabular, eine fehlende optionale Empfehlung und ein Hinweis zur Eignung für ein Suchfeature sind verschiedene Dinge.
Häufige Fehler. Fügen Sie keinen generischen Schema-Block in jede Seite ein und markieren Sie Dienstleistung, Kategorie und Produkt nicht als dieselbe Hauptentität. Verwenden Sie JSON-LD nicht, um Preise, Bewertungen, Lagerbestand, Rezensionen oder Autoren zu verbergen, die Nutzer nicht sehen können. Ein Rich-Results-Test kann Canonical, robots, Sitemap oder die inhaltliche Richtigkeit nicht prüfen, deshalb gehören diese Punkte in die Release-Prüfung. JSON-LD hilft, eine Seite zu beschreiben. Es kann keine unzugängliche oder unhilfreiche Seite ausgleichen.