Rozbité štruktúrované dáta: ako nájsť a opraviť chyby

Štruktúrované dáta sú jediná časť SEO, kde sa chyba prejaví okamžite a viditeľne: hviezdičky vo výsledkoch zmiznú, cena sa prestane zobrazovať, produkt vypadne z rozšírených výsledkov. Ranking sa nezmení, ale to, ako výsledok vyzerá v Google, áno. A to sa ráta na CTR.

Nižšie je prehľad chýb, ktoré nachádzam na weboch najčastejšie, kde ich uvidíte a ako ich opraviť tak, aby sa neopakovali.

Čo znamená „rozbité" štruktúrované dáta

Sú tri rôzne stavy a je dobré ich nemiešať:

1. Neplatný kód — JSON-LD sa vôbec nedá spracovať. Chýba zátvorka, je tam neescapovaná úvodzovka, do JSON-u sa dostal HTML kód. Google značkovanie ignoruje celé.
2. Platný kód, chýbajúce povinné vlastnosti — schéma sa spracuje, ale Google ju nepoužije na rozšírený výsledok, lebo nemá to, čo požaduje. Napríklad Product bez offers.
3. Platný kód, ktorý nesúhlasí so stránkou — v značkovaní je cena 19 €, na stránke 24 €. To už nie je technická chyba, ale porušenie pravidiel, ktoré vie viesť k manuálnemu opatreniu.

Tretí prípad je najnepríjemnejší, pretože validátor ho nenahlási. Nájdete ho len porovnaním značkovania s obsahom stránky.

Kde chyby uvidíte

Rich Results Test

search.google.com/test/rich-results je najbližšie k tomu, čo naozaj vidí Google. Otestuje jednu URL alebo vložený kód a povie, pre ktoré typy rozšírených výsledkov je stránka spôsobilá. Dôležité: testuje len typy, ktoré Google podporuje. Ak používate Recipe na stránke o službách, nedozviete sa nič.

Test zobrazí aj vyrenderovaný HTML kód. Tam sa dá overiť, či sa vaše JSON-LD do stránky vôbec dostalo — časté pri značkovaní generovanom cez JavaScript alebo vkladanom cez tag manager.

Schema Markup Validator

validator.schema.org kontroluje syntax a platnosť podľa slovníka schema.org, bez ohľadu na to, čo z toho Google používa. Používam ho vtedy, keď Rich Results Test „nič nenašiel" a treba zistiť, či je značkovanie zlé alebo len nepodporované.

Search Console → Vylepšenia

Toto je jediný zdroj, ktorý pracuje na celom webe, nie na jednej URL. V sekcii Vylepšenia sa objavia typy, ktoré Google na vašom webe našiel — Produkty, Navigačné cesty, Články. Ku každému je zoznam chýb a upozornení s počtom zasiahnutých URL a príkladmi.

Dôležitý detail: dáta sú spracované s odstupom a zoznam príkladov nie je úplný. Ak Search Console hlási 1 200 stránok s chybou, ukáže vám ich desiatky. Vzor sa dá odvodiť, ale úplný zoznam nie.

Chyby, ktoré nachádzam najčastejšie

Dva pluginy generujú ten istý typ

Klasika na WordPresse a WooCommerce: SEO plugin vypisuje Product, šablóna k tomu pridá vlastný microdata blok a plugin na recenzie tretí. Google potom vidí tri produkty na jednej stránke, každý s inou cenou alebo bez offers.

Oprava nie je „opraviť jeden z nich", ale vypnúť dva a nechať jeden zdroj pravdy. V praxi to znamená vypnúť schému v šablóne alebo v SEO plugine, podľa toho, ktorý má úplnejšie dáta.

Cena ako text so symbolom meny

``json "offers": { "@type": "Offer", "price": "1 299,00 €", "priceCurrency": "EUR" } ``

Toto neprejde. price má byť číslo bez symbolu meny, bez medzier ako oddeľovača tisícov a s desatinnou tečkou. Menu nesie samostatná vlastnosť priceCurrency v tvare ISO 4217. Správne:

``json "offers": { "@type": "Offer", "price": 1299.00, "priceCurrency": "EUR", "availability": "https://schema.org/InStock", "url": "https://example.sk/produkt" } ``

Podobne availability musí byť plná URL hodnoty zo schema.org, nie "in stock" alebo "Na sklade".

Chýbajúce povinné vlastnosti

Najčastejšie:

• Product bez offers, review alebo aggregateRating — bez aspoň jedného z nich nie je nárok na rozšírený výsledok.
• Product v obchodnom výpise bez image alebo bez sku/gtin/mpn.
• Article bez headline alebo bez image.
• BreadcrumbList, kde prvkom chýba position alebo name.
• LocalBusiness bez address s vyplnenými časťami adresy.

Typický zdroj: produkt bez ceny (na dopyt), variantné produkty s cenovým rozsahom, alebo importované položky s prázdnym poľom.

Neplatný JSON

Stane sa vždy, keď sa do JSON-LD dostane text z databázy bez escapovania. Popis produktu obsahuje úvodzovky alebo <br> a celý blok sa rozpadne. Prejav: Rich Results Test hlási „Nenašli sa žiadne položky", pritom kód v stránke vidíte.

Oprava je na strane šablóny — hodnoty escapovať a HTML tagy z popisu odstrániť.

Relatívne URL

"image": "/wp-content/uploads/produkt.jpg" je chyba. Všetky URL v štruktúrovaných dátach majú byť absolútne, vrátane protokolu. To isté platí pre url, logo a item v navigačnej ceste.

Dátumy v nesprávnom formáte

datePublished a dateModified musia byť v ISO 8601 — 2024-05-12 alebo 2024-05-12T09:30:00+02:00. Formát 12.5.2024 je neplatný. A dateModified nemá byť dnešný dátum len preto, že sa stránka vygenerovala dnes; ak ste obsah nezmenili, dátum sa nemá hýbať.

Značkovanie, ktoré Google už nezobrazuje

Od roku 2023 Google výrazne obmedzil zobrazovanie FAQ rozšírených výsledkov — v praxi ich vidno len u úzkej skupiny autoritatívnych stránok — a prestal zobrazovať HowTo. Značkovanie nie je chybné, len z neho nič nebude. Ak ho na webe máte, nechajte ho, ale nečakajte od neho zmenu v SERP-e a nerobte kvôli nemu ďalšiu prácu.

Rovnako platí, že Google nezobrazuje recenzie, ktoré si firma napísala sama o sebe alebo o svojich produktoch bez nezávislého zdroja.

Značkovanie nesúhlasí s obsahom

Cena v JSON-LD z cache, kým na stránke je akčná cena. Hodnotenie 4,9 z 218 recenzií, pričom na stránke nie je ani jedna. Dostupnosť InStock u vypredaného produktu. Toto sú chyby, ktoré validátor neodhalí a ktoré vás môžu stáť viac než chýbajúce značkovanie.

Chyba verzus upozornenie

Search Console rozlišuje Chyby (červené) a Platné s upozornením (žlté). Chyba znamená, že stránka nie je spôsobilá na rozšírený výsledok. Upozornenie znamená, že spôsobilá je, ale chýba odporúčaná vlastnosť.

Poradie práce je jednoduché: najprv chyby na šablónach s najväčším počtom URL (kategórie, detail produktu), potom upozornenia tam, kde ide o obchodné dáta — brand, sku, aggregateRating, shippingDetails. Upozornenia na starých blogových článkoch riešte naposledy alebo nikdy.

Jedna oprava v šablóne zvyčajne vyrieši tisíce URL. Preto nemá zmysel opravovať jednotlivé produkty ručne — treba nájsť šablónu, ktorá chybu generuje.

Ako opravu overiť

1. Opravte značkovanie na jednej reprezentatívnej URL.
2. Prejdite ju cez Rich Results Test — ak testujete kód, ktorý vzniká cez JavaScript, testujte URL, nie vložený kód.
3. Nasaďte na celú šablónu.
4. V Search Console dajte pri chybe Overiť opravu. Google spustí prehodnotenie vzorky URL. Trvá to dni až týždne, podľa veľkosti webu.
5. Sledujte, či sa v SERP-e objavili rozšírené výsledky, a porovnajte CTR na zasiahnutých URL.

Posledný bod je ten, na ktorý sa najčastejšie zabúda. Cieľom nie je zelená fajka v Search Console, ale to, aby výsledok v Google vyzeral lepšie a viac ľudí naň kliklo.

Ako to riešim ja

Pri prechode webu kontrolujem štruktúrované dáta na každej stránke, ktorú prejdem — či sa JSON-LD dá spracovať, či typ zodpovedá obsahu stránky, či nechýbajú povinné vlastnosti a či sa duplikuje. Pri nálezoch, ktoré sa dajú opraviť, nenapíšem radu typu „doplňte offers", ale hotový blok JSON-LD s vašimi dátami, pripravený na vloženie. Vy ho schválite a nasadí sa cez WordPress plugin, API alebo export do CSV.

Po nasadení meriam dopad 28 dní pred a po, aby bolo vidieť, či sa niečo naozaj zmenilo. Prvý prechod webu trvá približne 3 minúty od zadania adresy.

Čo nesľubujem: že po oprave štruktúrovaných dát pôjdete v pozíciách nahor. Štruktúrované dáta nie sú ranking faktor. Menia vzhľad výsledku a tým aj mieru klikov — a to je dôvod, prečo sa nimi zaoberať.

Zhrnutie

• Chyby hľadajte v Search Console (celý web) a overujte v Rich Results Test (jedna URL).
• Najčastejšie príčiny: dva zdroje značkovania, cena ako text, chýbajúce offers, relatívne URL, neescapované hodnoty.
• Opravujte v šablóne, nie na jednotlivých produktoch.
• Značkovanie musí súhlasiť s tým, čo je na stránke viditeľné.
• Úspech merajte na CTR a vzhľade výsledku, nie na pozíciách.