Strukturovaná data JSON-LD: příklady připravené k použití a generátor PHP

Strukturovaná data JSON-LD jsou způsob, jak vyhledávačům ve strojově čitelné podobě sdělit, co je stránka: článek, produkt s cenou, společnost s kontaktními údaji, seznam otázek a odpovědí. Pro návštěvníky je neviditelný, nenahrazuje dobrý obsah a sám o sobě nezvyšuje hodnocení. Jeho úkolem je vytvořit stránku způsobilou pro rozšířené výsledky, pomoci vyhledávačům propojit vaše stránky se správnou entitou a poskytnout vyhledávání založenému na umělé inteligenci čistší zdroj ke čtení. Generujeme jej na každé stránce integrono.com a na našich dalších stránkách a tato příručka je praktickou verzí této práce.

JSON-LD vs Microdata vs RDFa

Slovní zásobu Schema.org lze vložit do tří syntaxí. Microdata a RDFa vkládají atributy do vašich značek HTML, což zamotává označení se šablonami. JSON-LD žije v jednom bloku skriptu, odděleně od rozvržení, takže je jednodušší ho generovat, testovat a měnit. Google uvádí, že doporučuje JSON-LD, a to je to, co všude používáme.

Principy před příklady

• Popište viditelný obsah. Pokud na stránce není cena, hodnocení nebo FAQ, neuvádějte je do označení.
• Použijte absolutní adresy URL a kanonickou adresu URL stránky.
• Uveďte požadované vlastnosti a přidejte doporučené, až budete mít skutečná data.
• K propojení entit použijte @id. Autorem článku je organizace definovaná jednou @id, nikoli pokaždé nová kopie.
• Použijte data v ISO 8601 (2026-10-28 nebo s časem a zónou).
• Nevymýšlejte si recenze ani hodnocení. Falešná data AggregateRating jsou častou příčinou ručních zásahů.

Příklad 1. Organizace (a webová stránka)

Umístěte to na domovskou stránku nebo do grafu pro celý web. Definuje entitu, na kterou se ostatní označení odkazuje.

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

Příklad 2. BreadcrumbList

Drobečková navigace umožňuje Googlu ve výsledcích zobrazovat cestu ke stránce namísto nezpracované adresy URL. Musí odpovídat viditelné strouhance.

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

Příklad 3. Článek

Pro blogové příspěvky a průvodce. Vlastnosti, na kterých záleží: nadpis, data, autor, vydavatel, obrázek 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}
}

Změna dateModified pouze tehdy, když se obsah skutečně změní. Narážet na něj při každém nasazení je tichý způsob, jak ztratit důvěru.

Příklad 4. Produkt s nabídkou

Pro produktové stránky s viditelnou cenou. Zahrnout dostupnost a měnu; přidat aggregateRating nebo review pouze v případě, že se na stránce zobrazují skutečné recenze.

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

Příklad 5. Služba s nabídkou

U placených služeb, jako je audit za pevnou cenu nebo hodinová konzultace. Tento vzor používáme na našich vlastních stránkách služeb.

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

Příklad 6. FAQPage

Označení FAQ popisuje seznam otázek a odpovědí, které jsou viditelné na stránce. Uvědomte si, že od roku 2023 Google zobrazuje rozšířené výsledky častých dotazů pouze pro omezenou skupinu důvěryhodných webů, takže ve výsledcích neočekávejte rozšiřitelné odpovědi. Označení je stále platné, stále čitelné pro jiné vyhledávače a systémy AI a udržuje FAQ strukturované tak, aby stroje mohly citovat.

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

Spojte vše v jednom @grafu

Stránka má zřídka jen jednu entitu. Všechny je vložte do jednoho skriptu pomocí @graph a odkazujte na sdílené entity pomocí @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é generování JSON-LD v PHP

Nezřetězujte JSON ručně. Citát v názvu naruší celý scénář a vyhledávač ho tiše ignoruje. Vytvořte pole PHP a zakódujte jej. Důležité jsou dva příznaky: zachovat čitelnost Unicode a chránit kontext HTML escapováním lomítek a značek.

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 přemění < a > na sekvence escape, takže uživatelský obsah nemůže značku skriptu předčasně zavřít. Napájejte generátor ze stejných dat, která vykreslují stránku (název, cena, data), takže označení a viditelný obsah se nemohou oddělit. Na vícejazyčném webu přeložte textová pole a nastavte inLanguage podle národního prostředí; takto vznikají články tohoto blogu a označení FAQ.

Potvrďte a sledujte

1. Rich Results Test způsobilosti typů rozšířených výsledků Google.
2. Schema Markup Validator pro obecnou syntaxi schema.org jakéhokoli typu.
3. Poté, co Google projde vaše stránky, hlásí vylepšení Search Console (drobečková navigace, produkty, časté dotazy atd.) ohledně chyb a varování ve velkém měřítku.
4. Test jednotky, který vykresluje každou šablonu a kontroluje, zda JSON-LD analyzuje a obsahuje požadované klíče, zabraňuje regresi po refaktorech.

Chyby, které vás stojí

• Označení obsahu, který není na stránce (skryté často kladené dotazy, vymyšlená hodnocení, ceny, které se liší od viditelné ceny).
• Několik konfliktních bloků z pluginu a šablony, každý s jinou Organization.
• Relativní adresy URL, nesprávná data nebo chybějící @id.
• Poškozený JSON z ručního vytváření řetězců a neescapovaných uvozovek.
• Zacházení se schématem jako s klasifikačním trikem. Je to nástroj pro přehlednost; stránka si stále musí zasloužit hodnocení.

Jak můžeme pomoci

Strukturovaná data jsou jednou součástí naší technické SEO práce: navrhneme schéma pro vaše šablony, implementujeme generátor do vašeho zásobníku a nastavíme ověření tak, aby zůstalo správné i po vydání. Pokud chcete mít přehled o tom, co je na vašem webu špatně, začněte s naším kontrolním seznamem technického SEO auditu nebo si objednejte konzultaci.