Návody vysvětlují implementované kontroly. Jejich použití nezaručuje citaci ani doporučení v AI.
Kontrola TECH-FEED-016, verze navod-2026-09-19.v1. Datum vydání návodu je součástí verze.
Ověření: Vyberte položky, které nález jmenuje, a porovnejte jejich řádek ve feedu s uzlem Product v JSON-LD na stránce; hotovo je, když se cena, měna, dostupnost, název, adresa, obrázek a značka shodují a každá položka má na stránce stejný identifikátor jako ve feedu.
Omezení: Feed není na webu vidět, kontrola pracuje jen s dodaným exportem. Porovnává feed se strojovým zápisem stránky, ne s textem, který vidí zákazník. Způsobilost a zobrazení na kterékoli platformě se z ní neodvozuje.
Feed říká něco jiného než stránka
Produktový feed je soubor, kterým e-shop posílá katalog do nákupních služeb. Ta samá data má stránka produktu ve strojovém zápisu JSON-LD (uzel Product). Když se liší cena, dostupnost nebo měna, dostane platforma jeden údaj a zákazník na stránce jiný; Google to vede jako problém kvality dat [S34] a stejný požadavek na shodu má OpenAI ve své specifikaci feedu [S75]. Žádný feed nezakládá nárok na zobrazení produktu, o tom rozhoduje platforma [S34].
Kontrola páruje položky feedu s produkty na prioritních stránkách auditu podle identifikátoru (sku, productID, mpn, gtin) a náhradně podle adresy. U spárovaných porovnává sedm polí: název, adresu, obrázek, značku, dostupnost, cenu a měnu. Jmenovatel je počet položek ve feedu, ne počet spárovaných; nespárovaná položka je výsledek, ne chyba.
Co je potřeba dodat. Bez exportu feedu kontrola vyjde unknown, a to znamená chybějící podklad, ne vadu e-shopu. Do kontextového souboru zapište artifacts.feed_export s cestou k lokálnímu exportu (Merchant XML nebo CSV) ve složce evidence/. Adresu feedu ne: bývá za přihlášením a pověření se do adresy nepíše. Web bez prodeje zboží zapíše business_model_modules bez commerce a kontrola se na něj nevztahuje.
Údaj se liší (FEED_PAGE_MISMATCH)
Kdo to opraví: vývojář.
U spárovaných položek se aspoň jedno ze sedmi polí liší. Nález vypisuje identifikátor položky a pole, například cena: feed 1 290 CZK, stránka 1 190 CZK. Nejčastěji se liší cena a dostupnost, protože feed a JSON-LD vznikají z různých míst nebo v různou dobu.
- Najděte, odkud se údaj bere pro feed a odkud pro JSON-LD stránky. Rozdíl je skoro vždy v tom, že jsou to dvě různá místa.
- Sjednoťte je: cena, dostupnost a měna se počítají na jednom místě a do feedu i do JSON-LD jdou odtud.
- Sjednoťte slovník dostupnosti: feed píše
in_stock, JSON-LD https://schema.org/InStock; kontrola oba tvary přeloží, ale jiná hodnota (preorder proti InStock) je rozdíl. - Vygenerujte feed znovu a nechte kontrolu zopakovat. Změní-li se ceník, mění se obojí naráz.
Položky se nespárovaly (FEED_UNMATCHED_ITEMS)
Kdo to opraví: vývojář.
Spárované položky rozdíl nemají, ale část feedu se s žádnou stránkou nepotkala, například 12 z 40 položek. O těch kontrola netvrdí nic, a proto není výsledek pass: věta o shodě by pokrývala jen část katalogu. Dva důvody se pletou a mají různou opravu.
- Audit stáhl jen prioritní stránky, ne celý e-shop, a nespárované položky na ně prostě nevedou. Pak je oprava na straně auditu: rozšířit seznam prioritních adres o stránky těch položek a běh zopakovat.
- Stránka položky v seznamu je, ale JSON-LD nenese identifikátor, který má feed (
sku, productID, mpn, gtin13 nebo gtin), a adresa v poli url neodpovídá skutečné adrese stránky. Pak doplňte do uzlu Product stejný identifikátor, jaký má položka ve feedu, a pole url srovnejte s adresou stránky. - Položky, které parser feedu nezvládl, se nikdy nespárují; nález je vypisuje s důvodem. Opravte jejich tvar v exportu.
Co tahle kontrola neví
Nevidí, co s feedem platforma udělá: jestli položku přijme, zobrazí nebo odmítne, říká jen její vlastní validační log. Neporovnává text stránky, který vidí zákazník, jen strojový zápis; viditelnou shodu řeší TECH-SCHEMA-012. Pole, kde hodnotu nemá jedna ze stran, se neporovnává a nález to vypisuje jako počet polí z celkového počtu. Čerstvost feedu se bere z data souboru, ne z data, kdy ho platforma naposledy stáhla.
