JSON-LD

Co to je

JSON-LD je způsob, jak do stránky vložit strojově čitelný popis jejího obsahu. Člověk vidí produktovou stránku s fotkou, cenou a tlačítkem Koupit. Vyhledávač díky JSON-LD navíc dostane stejné údaje v přesné struktuře: tohle je produkt, stojí 1 290 Kč, je skladem.

Formát standardizuje W3C. Aktuální verze JSON-LD 1.1 je doporučením W3C od 16. července 2020. Samotný JSON-LD je jen „obálka". Význam pojmů (co je Product, co je price) určuje slovník, na webu téměř vždy Schema.org.

Google podporuje tři formáty strukturovaných dat: JSON-LD, Microdata a RDFa. Všechny jsou pro něj platné, ale ve své dokumentaci doporučuje JSON-LD. Důvod je praktický: data jsou v samostatném bloku, nemíchají se do HTML šablony a snáz se udržují.

Jak to funguje

JSON-LD se vkládá do stránky jako skript typu application/ld+json, nejčastěji do hlavičky nebo na konec stránky. Prohlížeč ho nezobrazí, vyhledávač ho přečte.

Klíčové prvky zápisu:

• @context — odkaz na slovník, typicky "https://schema.org".
• @type — typ objektu, například Product, Offer, Organization, BreadcrumbList.
• @id — volitelný identifikátor, přes který se na objekt dá odkázat z jiného bloku.
• vlastnosti — dvojice klíč a hodnota podle slovníku, například name, sku, gtin13, offers.

Ukázka: produkt s nabídkou

Minimální zápis produktu s cenou a dostupností vypadá takto (zkráceno na jeden řádek):

{"@context": "https://schema.org", "@type": "Product", "name": "Trekové boty Horizont", "image": "https://www.example.com/img/horizont.jpg", "sku": "HOR-42", "gtin13": "8591234567890", "offers": {"@type": "Offer", "price": "1290.00", "priceCurrency": "CZK", "availability": "https://schema.org/InStock", "url": "https://www.example.com/horizont"}}

Na co v ukázce myslet:

Google pro výpis produktu (product snippet) vyžaduje název a alespoň jednu z vlastností review, aggregateRating nebo offers. U prodejních stránek (merchant listings) navíc cenu a další údaje nabídky. Aktuální seznam povinných a doporučených vlastností je v dokumentaci Google Search Central.

JSON-LD může vzniknout i JavaScriptem až v prohlížeči. Bezpečnější je generovat ho na serveru přímo ze stejných dat, ze kterých se vykresluje stránka.

Nejčastější chyby

• Nesoulad s obsahem stránky. Cena nebo dostupnost v JSON-LD neodpovídá tomu, co vidí zákazník. Google vyžaduje, aby strukturovaná data odpovídala viditelnému obsahu.
• Natvrdo vložený kód. Někdo vloží JSON-LD ručně do šablony a po změně ceny nebo vyprodání zůstanou v kódu stará data.
• Duplicitní bloky. Šablona i SEO plugin generují každý svůj Product s jinými hodnotami.
• Syntaktické chyby. Chybějící čárka nebo uvozovka zneplatní celý blok.
• Očekávání, že značkování zlepší pozice. Strukturovaná data pomáhají vyhledávači pochopit stránku a umožňují rozšířené výsledky, ale zobrazení rozšířeného výsledku Google nezaručuje.

Ověření: Test rozšířených výsledků ukáže, jaké rozšířené výsledky Google ze stránky umí vyčíst, validátor na validator.schema.org zkontroluje zápis obecně. Dlouhodobě sledujte přehledy ve Search Console.

Jak to řešíme v Převeďshopu

Strukturovaná data řešíme jako součást technického SEO v rámci služby SEO pro e-shopy:

1. Audit — projdeme typy stránek (produkt, kategorie, homepage, články) a zkontrolujeme, co platforma generuje, kde chybí data a kde se bloky duplikují.
2. Implementace — JSON-LD napojíme na data e-shopu, aby se cena, dostupnost a hodnocení aktualizovaly samy. Podle platformy přes šablonu, doplněk nebo vlastní kód.
3. Kontrola po migraci a redesignu — strukturovaná data se při změně šablony ztrácejí nejčastěji. Hlídáme je v rámci každé migrace.

Jaké typy a vlastnosti značkovat, rozebíráme v článku Schema.org pro e-commerce. Jak se značkování projeví ve výsledcích vyhledávání, popisujeme v článku Rich snippets pro produkty.