Test rozšírených výsledkov od Google: ako ho spustiť a čítať chyby
Test rozšírených výsledkov je nástroj Google, ktorý overí, či štruktúrované údaje na stránke spĺňajú požiadavky na zobrazenie s hviezdičkami, cenou alebo navigačnými omrvinkami. Návod podľa dokumentácie Google ukazuje, ako test spustiť pre adresu aj pre kód, ako čítať jeho výsledok, čím sa líši od Schema Markup Validator a ako po nasadení sledovať prehľady rozšírených výsledkov v Search Console.
1. Čo Test rozšírených výsledkov overuje a čo nie
Test rozšírených výsledkov (Rich Results Test) je nástroj Google na adrese search.google.com/test/rich-results, ktorý zistí, či štruktúrované údaje na stránke spĺňajú požiadavky na rozšírené výsledky vo vyhľadávaní, teda pre zobrazenie s hviezdičkami, cenou, navigačnými omrvinkami alebo dátumom udalosti. Podľa pomocníka Search Console test ukáže, ktoré typy rozšírených výsledkov na stránke našiel, a k nim chyby aj návrhy na zlepšenie. Podporuje všetky tri formáty, ktoré Google číta: JSON-LD, RDFa a Microdata (Google: Rich Results Test).
Dôležité je vedieť, čo test nezaručí. Všeobecné pravidlá Google rozlišujú technické pravidlá, ktoré Test rozšírených výsledkov spolu s nástrojom Kontrola webovej adresy zachytí vo väčšine prípadov, a pravidlá kvality, ktoré sa automatickým nástrojom otestovať nedajú. Porušenie pravidla kvality môže zabrániť zobrazeniu aj syntakticky správnych údajov a v horšom prípade sa údaje označia ako spam (Google: General structured data guidelines). Zelený výsledok testu preto znamená, že kód je technicky v poriadku, nie že Google rozšírený výsledok naozaj zobrazí.
Test pozná len typy, ktoré Google vo vyhľadávaní podporuje, a ich zoznam sa mení. V pomocníkovi je dnes okrem iných Article, Breadcrumb, Event, Local business, Organization, Product snippet, Merchant listings, Recipe, Review snippet a Video (Google: Rich Results Test, Supported rich result types). Typ HowTo Google z testu odstránil v roku 2023, keď prestal tieto výsledky zobrazovať, a rozšírené výsledky FAQ odvtedy ukazuje len známym autoritatívnym webom štátnej správy a zdravotníctva (Google: Changes to HowTo and FAQ rich results). Od 9. septembra 2025 zmizli z testu aj typy Course Info, Claim Review, Estimated Salary, Learning Video, Special Announcement a Vehicle Listing (Google: Simplifying the search results page). Keď test určitý typ nenájde, hoci ho na stránke máte, oplatí sa najprv overiť, či ho Google ešte podporuje. Čo štruktúrované údaje sú a ako ich do stránky pridať, vysvetľuje článok štruktúrované údaje.
2. Ako spustiť test: adresa stránky alebo kód
Test ponúka dva režimy. V režime adresy zadáte celú adresu stránky a nástroj si ju stiahne sám, pričom podľa pomocníka musia byť všetky zdroje stránky dostupné pre anonymného návštevníka z internetu. Stránku za firewallom, za heslom alebo na vlastnom počítači test nenačíta a Google v takej situácii odkazuje na sprístupnenie cez tunel (Google: Rich Results Test, Run the test). V režime kódu prepnete voľbu z URL na Kód, vložíte HTML alebo samotný blok JSON-LD a test spúšťate tlačidlom Spustiť test toľkokrát, koľko potrebujete.
Každý režim má iné využitie, a preto sa oplatí ich kombinovať podľa toho, v akej fáze práce ste:
| Režim | Kedy ho použiť | Na čo si dať pozor |
|---|---|---|
| Adresa (URL) | hotová stránka na živom webe, kontrola po nasadení šablóny | stránka nesmie byť blokovaná v robots.txt ani mať noindex, inak sa otestovať nedá |
| Kód | vývoj, úprava JSON-LD pred nasadením, skúšanie rôznych vlastností | test ignoruje komentáre v JSON-LD, hoci štandard ich nepovoľuje, takže pred zverejnením ich treba odstrániť |
| Voľba robota | porovnanie mobilnej a počítačovej verzie | predvolený je smartfón, počítač treba zvoliť ručne |
Poznámka o komentároch je v pomocníku uvedená výslovne: test komentáre v blokoch JSON-LD prehliadne, no podľa štandardu JSON-LD nie sú povolené a v ostrej prevádzke môžu spôsobiť chyby (Google: Rich Results Test, Comment support). Pri vkladaní kódu zo šablóny alebo z generátora preto skontrolujte, či v ňom nezostali riadky začínajúce dvoma lomkami.
Výsledok testu si Search Console ukladá. Ak si po spustení uložíte adresu stránky s výsledkom do záložiek, získate históriu verzií kódu aj testov, ktorá sa uchováva približne 90 dní. Tlačidlom Zdieľať pošlete odkaz na výsledok komukoľvek a na zobrazenie nie sú potrebné žiadne oprávnenia (Google: Rich Results Test, Save and share). Pre zadanie programátorovi je to praktické, len majte na pamäti, že odkaz otvorí každý, kto ho dostane.
3. Ako čítať výsledok testu
Výsledok má niekoľko častí a čítať ich treba zhora, pretože keď zlyhá prvá, ďalšie nemajú zmysel. Časť o prehľadávaní hovorí, či Google stránku vôbec smel a vedel načítať: uvádza, či sa prehľadanie podarilo, akým robotom prebehlo (smartfón alebo počítač), či prehľadávanie nezakazuje pravidlo v robots.txt a či sa stránku podarilo stiahnuť. Ak prehľadávaniu bráni robots.txt alebo príkaz noindex, test stránku podľa pomocníka neotestuje vôbec (Google: Rich Results Test, Crawling).
Druhá časť vypisuje nájdené položky. Ukáže každú položku štruktúrovaných údajov, ktorú test na stránke našiel, a pri každej uvedie, či je v poriadku, či má upozornenia alebo chyby, alebo či sa nedala vôbec spracovať. Po rozkliknutí položky a kliknutí na popis chyby sa otvorí prehliadač kódu presne na mieste problému, pričom nástroj zobrazuje vykreslený zdrojový kód, teda stav po spustení JavaScriptu (Google: Rich Results Test, Review the results). Vďaka tomu test odhalí aj údaje, ktoré na stránku vkladá skript, čo sa pri webe postavenom na JavaScripte hodí. Súvislosti s vykresľovaním rozoberá článok JavaScript SEO.
Pri niektorých typoch ponúka test aj náhľad, ako by výsledok mohol vyzerať vo vyhľadávaní, a to zvlášť pre mobil a počítač. Google pri náhľade upozorňuje, že nezaručuje, že sa stránka zobrazí presne takto, ani že sa niektorý zo zobrazených vzhľadov vôbec použije, pretože výsledok prispôsobuje histórii vyhľadávania, polohe a ďalším premenným (Google: Rich Results Test, Preview). Náhľad je teda ukážka možností, nie prísľub.
4. Chyby a upozornenia: čo opraviť najskôr
Google rozlišuje dva druhy problémov a od toho sa odvíja poradie práce. Kritický problém robí položku neplatnou, takže nemôže byť zobrazená ako rozšírený výsledok. Nekritický problém zobrazenie nezablokuje a v prehľadoch Search Console patrí do časti o zlepšení vzhľadu položky (Google: Rich result status reports). Najčastejšou príčinou kritického problému je chýbajúca povinná vlastnosť, lebo položky bez povinných vlastností podľa všeobecných pravidiel nie sú na rozšírené výsledky spôsobilé (Google: Completeness).
| Čo test hlási | Čo to znamená | Čo urobiť |
|---|---|---|
| chyba (kritický problém) | položka je neplatná a rozšírený výsledok nedostane | doplniť chýbajúcu povinnú vlastnosť alebo opraviť jej hodnotu podľa dokumentácie daného typu |
| upozornenie (nekritický problém) | položka je platná, chýba jej odporúčaná vlastnosť | doplniť, ak máte k dispozícii presný a úplný údaj |
| nespracovateľné údaje | syntaktická chyba, kód sa nedá prečítať | skontrolovať čiarky, zátvorky a úvodzovky v JSON-LD |
| prehľadanie zlyhalo | Google sa na stránku nedostal | skontrolovať robots.txt, noindex, prihlásenie a firewall |
| nenašli sa žiadne položky | na stránke nie je podporovaný typ alebo sa údaje nevykreslili | overiť, či typ Google podporuje a či kód naozaj je vo vykreslenej stránke |
Pri upozorneniach netreba zbierať všetky odporúčané vlastnosti za každú cenu. Google síce uvádza, že viac odporúčaných vlastností spravidla zvyšuje šancu na rozšírené zobrazenie, no zároveň zdôrazňuje, že je dôležitejšie dodať menej vlastností, ktoré sú úplné a presné, než sa snažiť vyplniť každú možnú vlastnosť neúplnými, zle zapísanými alebo nepresnými údajmi (Google: Intro to structured data). Hodnotenie, ktoré na stránke nie je, alebo cenu, ktorá nesedí, preto nedopĺňajte len kvôli zelenej farbe v teste.
Platí to aj pre obsah samotných údajov. Podľa pravidiel kvality nesmú štruktúrované údaje opisovať niečo, čo čitateľ na stránke nevidí, ani obsahovať zavádzajúce údaje, napríklad falošné recenzie. Pri porušení môže prísť ručný postih, ktorý stránke vezme spôsobilosť na rozšírené výsledky, no podľa Google neovplyvní jej pozíciu vo výsledkoch webového vyhľadávania (Google: General structured data guidelines). Ako to vyzerá pri hviezdičkách, opisuje článok hviezdičky hodnotenia v Google.
5. Test verzus Schema Markup Validator a Kontrola webovej adresy
Na kontrolu štruktúrovaných údajov existujú tri nástroje a každý odpovedá na inú otázku. Pôvodný Structured Data Testing Tool Google presunul do komunity schema.org a z neho vznikol Schema Markup Validator na adrese validator.schema.org. Podľa Google slúži na kontrolu syntaxe a súladu so štandardmi schema.org, rozšírené výsledky Google Search však nekontroluje a na tie odporúča Test rozšírených výsledkov a Search Console (Google: An update on the Structured Data Testing Tool).
| Nástroj | Na akú otázku odpovedá | Kedy ho použiť |
|---|---|---|
| Test rozšírených výsledkov | Spĺňa kód požiadavky Google na rozšírený výsledok? | pri vývoji a po každej zmene šablóny |
| Schema Markup Validator | Je kód správny podľa slovníka schema.org? | pri typoch, ktoré Google nepodporuje, alebo pri kontrole celej schémy |
| Kontrola webovej adresy v Search Console | Videl Google štruktúrované údaje na zaindexovanej stránke? | po nasadení, pri overení konkrétnej adresy |
Rozdiel medzi prvými dvoma nástrojmi je v tom, čie pravidlá sledujú. Google vo svojej dokumentácii píše, že väčšina štruktúrovaných údajov používa slovník schema.org, no pre správanie Google Search treba za rozhodujúcu brať dokumentáciu Google Search Central, nie dokumentáciu schema.org (Google: Structured data vocabulary and format). Validátor teda môže hlásiť bezchybný kód, ktorému pre Google aj tak chýba povinná vlastnosť.
Kontrola webovej adresy je užitočná tam, kde test nestačí. Prehľady v Search Console ukazujú len vzorku položiek, a preto Google odporúča overiť adresy, ktoré v prehľade nie sú, práve týmto nástrojom (Google: Rich result status reports). Kontrola zároveň prezradí, či je stránka vôbec zaindexovaná, a to test nezistí. Postup krok za krokom nájdete v článku kontrola webovej adresy v Search Console.
6. Po nasadení: prehľady rozšírených výsledkov v Search Console
Google odporúča používať Test rozšírených výsledkov počas vývoja a po nasadení sledovať prehľady stavu rozšírených výsledkov, pretože údaje sa môžu pokaziť až po zverejnení vplyvom šablón alebo spôsobu, akým server stránky doručuje (Google: Intro to structured data). Prehľady nájdete v Search Console v časti Vylepšenia, pričom úryvky produktov a záznamy obchodníkov sú v časti Nákupy. Prehľad pre určitý typ sa zobrazí, len ak Google na webe nájde platné označenie podporovaného typu (Google: Find and open the report).
Pri čítaní prehľadu pomôže poznať niekoľko pravidiel z pomocníka, inak sa čísla ľahko vysvetlia zle:
- Čísla sú za položky, nie za stránky. Jedna stránka môže mať viac položiek a jedna položka viac problémov, preto súčet problémov môže prevyšovať počet neplatných položiek.
- Prehľad je vzorka. Nejde o úplný zoznam položiek na webe, takže súčet platných a neplatných položiek môže byť nižší, než koľko ich Google naozaj pozná.
- Tabuľka príkladov má najviac 1 000 riadkov. Pri rozsiahlom probléme v nej nebudú všetky dotknuté adresy.
- Dátum prvého zistenia sa nemení. Ak sa vyriešený problém znova objaví do 90 dní, prehľad uvedie pôvodný dátum prvého zistenia.
Všetky body vychádzajú z pomocníka k prehľadom stavu rozšírených výsledkov (Google: Rich result status reports). Ak v prehľade očakávané položky chýbajú alebo ich počet klesol, Google uvádza ako možné príčiny vzorkovanie, nespracovateľné údaje so syntaktickou chybou, nezaindexované stránky, oneskorenie prehľadávania a blokovanie prístupu cez prihlásenie, robots.txt alebo noindex. Postup podľa Google je overiť indexovanie Kontrolou webovej adresy, otestovať údaje Testom rozšírených výsledkov, opraviť chyby a požiadať o nové indexovanie (Google: Debug missing structured data).
Opravu treba vždy urobiť v kóde webu, lebo Search Console údaje len číta a tlačidlo na automatickú opravu nemá, ako vysvetľuje aj pomocník. Pri e-shope sa väčšina chýb opakuje v šablóne produktu, takže jedna oprava šablóny vyrieši všetky dotknuté stránky naraz. Ktoré vlastnosti sú pri produktoch povinné, rozoberá článok štruktúrované údaje produktu.
Časté otázky
Ako dlho platí odkaz na výsledok testu?
Podľa pomocníka Google je odkaz na výsledok platný približne 90 dní a na jeho zobrazenie nie sú potrebné žiadne oprávnenia. Rovnako dlho, teda približne 90 dní, sa uchováva história testov uložená v záložkách.
Znamená bezchybný test, že sa mi zobrazia hviezdičky alebo cena?
Nie. Test overí technické požiadavky, no Google uvádza, že zobrazenie nezaručuje a pravidlá kvality, napríklad zhodu údajov s viditeľným obsahom stránky, automatický nástroj neotestuje.
Aký je rozdiel medzi chybou a upozornením v teste?
Chyba je kritický problém, kvôli ktorému je položka neplatná a rozšírený výsledok nedostane, najčastejšie pre chýbajúcu povinnú vlastnosť. Upozornenie je nekritický problém, keď chýba odporúčaná vlastnosť, a položka zostáva platná.
Prečo test nenájde moje štruktúrované údaje FAQ?
Typ FAQ nie je v aktuálnom zozname podporovaných typov testu a Google od roku 2023 zobrazuje rozšírené výsledky FAQ len známym autoritatívnym webom štátnej správy a zdravotníctva. Správnosť kódu podľa schema.org overíte v Schema Markup Validator.
Čím sa líši Test rozšírených výsledkov od Schema Markup Validator?
Test rozšírených výsledkov kontroluje požiadavky Google na rozšírené výsledky. Schema Markup Validator kontroluje syntax a súlad so slovníkom schema.org, no rozšírené výsledky Google nekontroluje.