JSON-LD je formát zápisu strukturovaných dat založený na JSON, kterým stránce přidáte strojově čitelný popis obsahu, například firmy, produktu, akce nebo článku. Zapisuje se do značky <script type="application/ld+json"> v kódu stránky a návštěvník ho nevidí.
Truhlářství popíše firmu typem Organization na domovské stránce. Google u něj žádnou vlastnost nevyžaduje a doporučuje uvést všechny, které se firmy týkají; na každou stránku webu ho dávat nemusíte.
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Organization",
"@id": "https://www.example.cz/#organizace",
"name": "Truhlářství Novák",
"url": "https://www.example.cz/",
"logo": "https://www.example.cz/img/logo.png",
"telephone": "+420 600 000 000",
"address": {
"@type": "PostalAddress",
"streetAddress": "Dlouhá 12",
"addressLocality": "Tábor",
"postalCode": "390 01",
"addressCountry": "CZ"
},
"sameAs": ["https://www.facebook.com/truhlarstvinovak"]
}
</script>
Název, telefon a adresa jsou zároveň vidět v patičce stránky, takže data odpovídají obsahu.
Specifikaci JSON-LD 1.1 vydalo W3C jako doporučení 16. 7. 2020, typy a vlastnosti se berou ze slovníku schema.org. Google podporuje tři formáty strukturovaných dat – JSON-LD, Microdata a RDFa – a doporučuje JSON-LD, protože se nejsnáz zavádí a udržuje. Blok můžete vložit do <head> i <body> a Google přečte i JSON-LD, který do stránky vloží JavaScript nebo modul redakčního systému. Klíč @context určuje slovník, @type typ objektu a @id jeho jednoznačný identifikátor, přes který na sebe objekty mohou odkazovat. Data musí odpovídat viditelnému obsahu: Google zakazuje označovat, co čtenář na stránce nevidí, a za spam ve strukturovaných datech hrozí ruční opatření, které stránce vezme nárok na rozšířené výsledky, pozice ve vyhledávání ale nezmění. Kód ověříte v Testu bohatých výsledků (Rich Results Test) a po nasazení sledujete přehledy rozšířených výsledků v Search Console. Pro Přehledy od AI ani Režim AI Google žádná zvláštní strukturovaná data nevyžaduje.
Časté chyby
- Ve strukturovaných datech je údaj, který na stránce není vidět, například hodnocení nebo cena.
- Syntaktická chyba, jako čárka za poslední položkou nebo typografické uvozovky zkopírované z textového editoru, znehodnotí celý blok.
- Očekávání, že JSON-LD samo zaručí rozšířený výsledek nebo místo mezi zdroji AI odpovědi.