Štruktúrované dáta JSON-LD: príklady pripravené na použitie a generátor PHP

Štruktúrované dáta JSON-LD predstavujú spôsob, ako povedať vyhľadávačom v strojovo čitateľnej forme, čo je stránka: článok, produkt s cenou, spoločnosť s kontaktnými údajmi, zoznam otázok a odpovedí. Pre návštevníkov je neviditeľný, nenahrádza dobrý obsah a sám o sebe nezvyšuje hodnotenie. Robí to tak, že robí stránku vhodnou na zobrazovanie bohatých výsledkov, pomáha nástrojom prepojiť vaše stránky so správnou entitou a poskytuje vyhľadávaniu založenému na AI čistejší zdroj na čítanie. Generujeme ho na každej stránke integrono.com a na našich ďalších stránkach a táto príručka je praktickou verziou tejto práce.

JSON-LD vs Microdata vs RDFa

Slovník Schema.org môže byť vložený do troch syntaxí. Microdata a RDFa vkladajú atribúty do vašich značiek HTML, čo spája značky so šablónami. JSON-LD žije v jednom bloku skriptov, oddelene od rozloženia, takže je jednoduchšie ho generovať, testovať a meniť. Google uvádza, že odporúča JSON-LD a práve to používame všade.

Princípy pred príkladmi

• Opíšte viditeľný obsah. Ak na stránke nie je uvedená cena, hodnotenie alebo často kladené otázky, neuvádzajte ich do označenia.
• Použite absolútne adresy URL a kanonickú adresu URL stránky.
• Vyplňte požadované vlastnosti a pridajte odporúčané, keď budete mať skutočné údaje.
• Na prepojenie entít použite @id. Autorom článku je organizácia definovaná raz pomocou @id, nie zakaždým nová kópia.
• Použite dátumy v ISO 8601 (2026-10-28 alebo s časom a pásmom).
• Nevymýšľajte si recenzie ani hodnotenia. Falošné údaje AggregateRating sú častou príčinou ručných akcií.

Príklad 1. Organizácia (a webová lokalita)

Umiestnite to na domovskú stránku alebo do celowebového grafu. Definuje entitu, na ktorú sa vzťahuje iné označenie.

{
  "@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"
  ]
}

Príklad 2. BreadcrumbList

Značenie v strúhanke umožňuje Googlu vo výsledkoch zobraziť cestu stránky namiesto nespracovanej adresy URL. Musí zodpovedať viditeľnej strúhanke.

{
  "@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"}
  ]
}

Príklad 3. Článok

Pre blogové príspevky a návody. Vlastnosti, na ktorých záleží: nadpis, dátumy, autor, vydavateľ, obrázok a adresa URL stránky.

{
  "@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}
}

Zmeniť dateModified iba vtedy, keď sa obsah skutočne zmení. Narážať naň pri každom nasadení je tichý spôsob, ako stratiť dôveru.

Príklad 4. Produkt s ponukou

Pre produktové stránky s viditeľnou cenou. Zahrňte dostupnosť a menu; aggregateRating alebo review pridajte iba vtedy, ak sa na stránke zobrazujú skutočné recenzie.

{
  "@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"
  }
}

Príklad 5. Služba s ponukou

Pre platené služby, ako je audit s pevnou cenou alebo hodinová konzultácia. Tento vzor používame na našich vlastných servisných stránkach.

{
  "@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"
  }
}

Príklad 6. FAQPage

Označenie FAQ popisuje zoznam otázok a odpovedí, ktoré sú viditeľné na stránke. Uvedomte si, že od roku 2023 Google zobrazuje rozšírené výsledky častých otázok iba pre obmedzenú skupinu dôveryhodných stránok, takže vo výsledkoch nečakajte rozšíriteľné odpovede. Označenie je stále platné, stále čitateľné inými vyhľadávacími nástrojmi a systémami AI a udržiava FAQ štruktúrované tak, aby stroje mohli citovať.

{
  "@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."}
    }
  ]
}

Skombinujte všetko do jedného @grafu

Stránka má zriedka len jednu entitu. Vložte ich všetky do jedného skriptu pomocou @graph a odkazujte na zdieľané entity pomocou @id:

{
  "@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": []}
  ]
}

Bezpečné generovanie JSON-LD v PHP

Nespájajte JSON ručne. Citát v názve rozbije celý scenár a vyhľadávač ho ticho ignoruje. Vytvorte pole PHP a zakódujte ho. Na dvoch príznakoch záleží: udržiavajte čitateľnosť Unicode a chráňte kontext HTML vynechaním lomiek a značiek.

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 zmení značky < a > na sekvencie escape, takže používateľský obsah nemôže značku skriptu predčasne zavrieť. Napájajte generátor z rovnakých údajov, ktoré vykresľujú stránku (názov, cena, dátumy), aby sa označenie a viditeľný obsah nemohli oddeliť. Na viacjazyčnej stránke preložte textové polia a nastavte inLanguage podľa miestneho nastavenia; takto sa vyrábajú články a často kladené otázky na tomto blogu.

Overiť a monitorovať

1. Rich Results Test na vhodnosť typov multimediálnych výsledkov Google.
2. Schema Markup Validator pre všeobecnú syntax schema.org akéhokoľvek typu.
3. Prehľady vylepšenia Search Console (úryvky, produkty, časté otázky atď.) o chybách a upozorneniach vo veľkom rozsahu, keď Google prehľadal vaše stránky.
4. Test jednotky, ktorý vykresľuje každú šablónu a kontroluje, či JSON-LD analyzuje a obsahuje požadované kľúče, zabraňuje regresii po refaktoroch.

Chyby, ktoré vás stoja

• Označenie pre obsah, ktorý nie je na stránke (skryté často kladené otázky, vymyslené hodnotenia, ceny, ktoré sa líšia od viditeľnej ceny).
• Niekoľko konfliktných blokov z doplnku a šablóny, každý s inou Organization.
• Relatívne adresy URL, nesprávne dátumy alebo chýbajúci @id.
• Zlomený JSON z manuálneho vytvárania reťazcov a neescapovaných úvodzoviek.
• Zaobchádzanie so schémou ako s hodnotiacim trikom. Je to nástroj prehľadnosti; stránka si stále musí zaslúžiť hodnotenie.

Ako môžeme pomôcť

Štruktúrované dáta sú jednou súčasťou našej technickej SEO práce: navrhneme schému pre vaše šablóny, implementujeme generátor do vášho zásobníka a nastavíme validáciu tak, aby zostala správna aj po vydaní. Ak chcete získať prehľad o tom, čo je na vašej stránke nesprávne, začnite s naším kontrolným zoznamom technického SEO auditu alebo si objednajte konzultáciu.