Strukturierte JSON-LD Daten: gebrauchsfertige Beispiele und ein PHP-Generator

Strukturierte JSON-LD Daten sind eine Möglichkeit, Suchmaschinen in maschinenlesbarer Form mitzuteilen, was eine Seite ist: ein Artikel, ein Produkt mit Preis, ein Unternehmen mit Kontaktdaten, eine Liste mit Fragen und Antworten. Es ist für Besucher unsichtbar, ersetzt keinen guten Inhalt und erhöht nicht automatisch das Ranking. Dadurch wird eine Seite für Rich-Suchergebnisse geeignet, Suchmaschinen werden dabei unterstützt, Ihre Seiten mit der richtigen Entität zu verknüpfen, und die KI-basierte Suche erhält eine übersichtlichere, lesbare Quelle. Wir generieren es auf jeder Seite von integrono.com und unseren anderen Websites, und dieser Leitfaden ist die praktische Version dieser Arbeit.

JSON-LD vs. Microdata vs. RDFa

Das Vokabular von Schema.org kann in drei Syntaxen eingebettet werden. Microdata und RDFa fügen Attribute in Ihre HTML-Tags ein, wodurch Markup und Vorlagen verwickelt werden. JSON-LD befindet sich in einem Skriptblock, getrennt vom Layout, sodass es einfacher generiert, getestet und geändert werden kann. Google gibt an JSON-LD zu empfehlen, und wir verwenden es überall.

Prinzipien vor Beispielen

• Beschreiben Sie sichtbare Inhalte. Wenn der Preis, die Bewertung oder die FAQ nicht auf der Seite stehen, fügen Sie sie nicht in das Markup ein.
• Verwenden Sie absolute URLs und die kanonische URL der Seite.
• Geben Sie die erforderlichen Eigenschaften vollständig an und fügen Sie empfohlene Eigenschaften hinzu, wenn Sie über echte Daten verfügen.
• Verwenden Sie @id, um Entitäten zu verknüpfen. Der Autor des Artikels ist die Organisation, die einmal mit einer @id definiert wurde, nicht jedes Mal eine neue Kopie.
• Verwenden Sie Datumsangaben in ISO 8601 (2026-10-28 oder mit Uhrzeit und Zone).
• Erfinden Sie keine Rezensionen oder Bewertungen. Gefälschte AggregateRating Daten sind eine häufige Ursache für manuelle Aktionen.

Beispiel 1. Organisation (und Website)

Platzieren Sie dies auf der Startseite oder in einem Diagramm für die gesamte Website. Es definiert die Entität, auf die sich andere Markups beziehen.

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://example.com/#organization",
  "name": "Example Studio",
  "url": "https://example.com/",
  "logo": "https://example.com/images/logo.png",
  "email": "[email protected]",
  "sameAs": [
    "https://github.com/example",
    "https://www.linkedin.com/company/example"
  ]
}

Beispiel 2. BreadcrumbList

Mit dem Breadcrumb-Markup zeigt Google in den Ergebnissen den Seitenpfad anstelle einer Roh-URL an. Es muss mit den sichtbaren Semmelbröseln übereinstimmen.

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {"@type": "ListItem", "position": 1, "name": "Home", "item": "https://example.com/"},
    {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://example.com/blog"},
    {"@type": "ListItem", "position": 3, "name": "JSON-LD guide", "item": "https://example.com/blog/json-ld-guide"}
  ]
}

Beispiel 3. Artikel

Für Blogbeiträge und Anleitungen. Die Eigenschaften, auf die es ankommt: Überschrift, Datum, Autor, Herausgeber, Bild und die Seiten-URL.

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD structured data: examples",
  "description": "Short summary of the article.",
  "url": "https://example.com/blog/json-ld-guide",
  "mainEntityOfPage": "https://example.com/blog/json-ld-guide",
  "inLanguage": "en",
  "datePublished": "2026-08-23",
  "dateModified": "2026-10-28",
  "author": {"@id": "https://example.com/#organization"},
  "publisher": {"@id": "https://example.com/#organization"},
  "image": {"@type": "ImageObject", "url": "https://example.com/images/blog/json-ld.webp", "width": 1200, "height": 630}
}

dateModified ändern: Wird nur geändert, wenn sich der Inhalt tatsächlich ändert. Bei jedem Einsatz dagegen anzustoßen, ist eine stille Möglichkeit, das Vertrauen zu verlieren.

Beispiel 4. Produkt mit Angebot

Für Produktseiten mit sichtbarem Preis. Geben Sie Verfügbarkeit und Währung an; Fügen Sie aggregateRating oder review nur hinzu, wenn echte Bewertungen auf der Seite angezeigt werden.

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Example product",
  "description": "What it is and who it is for.",
  "image": ["https://example.com/images/product.webp"],
  "sku": "EX-001",
  "brand": {"@type": "Brand", "name": "Example"},
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/product/ex-001",
    "priceCurrency": "EUR",
    "price": "49.00",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}

Beispiel 5. Service mit Angebot

Für kostenpflichtige Leistungen, wie zum Beispiel ein Festpreisaudit oder eine stundenweise Beratung. Wir verwenden dieses Muster auf unseren eigenen Serviceseiten.

{
  "@context": "https://schema.org",
  "@type": "Service",
  "name": "Architecture review",
  "serviceType": "Software architecture analysis",
  "provider": {"@id": "https://example.com/#organization"},
  "areaServed": "Worldwide",
  "offers": {
    "@type": "Offer",
    "price": "200",
    "priceCurrency": "EUR",
    "url": "https://example.com/services/architecture-review"
  }
}

Beispiel 6. FAQ-Seite

FAQ-Markup beschreibt eine Liste von Fragen und Antworten, die auf der Seite sichtbar sind. Beachten Sie, dass Google seit 2023 FAQ-Rich-Suchergebnisse nur für eine begrenzte Anzahl maßgeblicher Websites anzeigt. Erwarten Sie daher keine erweiterbaren Antworten in den Ergebnissen. Das Markup ist weiterhin gültig, für andere Suchmaschinen und KI-Systeme weiterhin lesbar und sorgt dafür, dass die FAQ so strukturiert sind, dass Maschinen sie zitieren können.

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Do I need structured data to rank?",
      "acceptedAnswer": {"@type": "Answer", "text": "No. It is not a ranking requirement, but it can make pages eligible for rich results."}
    }
  ]
}

Kombinieren Sie alles in einem @graph

Eine Seite hat selten nur eine Entität. Fügen Sie alle mit @graph in einem Skript zusammen und verweisen Sie mit @id auf gemeinsam genutzte Entitäten:

{
  "@context": "https://schema.org",
  "@graph": [
    {"@type": "Organization", "@id": "https://example.com/#organization", "name": "Example Studio"},
    {"@type": "Article", "headline": "...", "author": {"@id": "https://example.com/#organization"}},
    {"@type": "BreadcrumbList", "itemListElement": []},
    {"@type": "FAQPage", "mainEntity": []}
  ]
}

JSON-LD sicher in PHP generieren

Verketten Sie JSON nicht manuell. Ein Zitat in einem Titel unterbricht das gesamte Skript und die Suchmaschine ignoriert es stillschweigend. Erstellen Sie ein PHP-Array und kodieren Sie es. Zwei Flags sind wichtig: Halten Sie Unicode lesbar und schützen Sie den HTML-Kontext, indem Sie Schrägstriche und Tags maskieren.

function jsonLdScript(array $graph): string
{
    $data = ['@context' => 'https://schema.org', '@graph' => $graph];
    $json = json_encode(
        $data,
        JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP | JSON_THROW_ON_ERROR
    );
    return '<script type="application/ld+json">' . $json . '</script>';
}

$graph = [
    ['@type' => 'Organization', '@id' => $site . '/#organization', 'name' => 'Example Studio', 'url' => $site . '/'],
    [
        '@type'         => 'Article',
        'headline'      => $title,
        'url'           => $canonical,
        'datePublished' => $published,
        'dateModified'  => $modified,
        'author'        => ['@id' => $site . '/#organization'],
    ],
];
echo jsonLdScript($graph);

JSON_HEX_TAG wandelt < und > in Escape-Sequenzen um, sodass Benutzerinhalte das Skript-Tag nie vorzeitig schließen können. Versorgen Sie den Generator mit denselben Daten, mit denen die Seite gerendert wird (Titel, Preis, Datum), sodass Markup und sichtbarer Inhalt nicht auseinanderdriften können. Übersetzen Sie in einer mehrsprachigen Site Textfelder und legen Sie inLanguage pro Gebietsschema fest. Auf diese Weise werden die Artikel und das FAQ-Markup dieses Blogs erstellt.

Validieren und überwachen

1. Rich Results Test die Eignung der Rich-Suchergebnistypen von Google.
2. Schema Markup Validator für allgemeine schema.org -Syntax jeglicher Art.
3. Berichte zur Verbesserung Search Console (Breadcrumbs, Produkte, FAQ usw.) für Fehler und Warnungen in großem Umfang, nachdem Google Ihre Seiten gecrawlt hat.
4. Ein Komponententest, der jede Vorlage rendert und prüft, ob das JSON-LD die erforderlichen Schlüssel analysiert und enthält, verhindert Regressionen nach Refaktorierungen.

Fehler, die Sie kosten

• Markup für Inhalte, die nicht auf der Seite sind (versteckte FAQ, erfundene Bewertungen, Preise, die vom sichtbaren Preis abweichen).
• Mehrere widersprüchliche Blöcke aus einem Plugin und einer Vorlage, jeweils mit einer anderen Organization.
• Relative URLs, falsche Daten oder eine fehlende @id.
• Defektes JSON durch manuelle Zeichenfolgenerstellung und Anführungszeichen ohne Escapezeichen.
• Schema als Ranking-Trick behandeln. Es ist ein Werkzeug zur Klarheit; Die Seite muss immer noch einen Rang verdienen.

Wie wir helfen können

Strukturierte Daten sind ein Teil unserer technischen SEO-Arbeit: Wir entwerfen das Schema für Ihre Vorlagen, implementieren den Generator in Ihrem Stack und richten die Validierung ein, damit sie nach der Veröffentlichung korrekt bleibt. Wenn Sie einen Überblick darüber erhalten möchten, was auf Ihrer Website nicht stimmt, beginnen Sie mit unserer technischen SEO-Audit-Checkliste oder vereinbaren Sie einen Beratungstermin.