Lyneon

Heureka feed: nejčastější chyby a jak je opravit

Produkty chybějí v Heurece, ceny jsou staré nebo se kvůli feedu nezobrazuje celá kategorie? Tady je přehled toho, co musí XML feed obsahovat, nejčastějších chyb a jak je ověříte.

Aktualizováno · 4 min čtení

Ve zkratce

  • Heureka feed negeneruje ani neopravuje, odpovídá za něj e-shop. Bez povinných prvků ITEM_ID, PRODUCTNAME, URL a PRICE_VAT se položka nezobrazí.
  • Nejčastější chyby: neescapované znaky v XML, nestabilní ITEM_ID, špatná cena, zastaralý feed a chybná kategorie v CATEGORYTEXT.
  • Kontrola je jednoduchá: otevřete feed v prohlížeči, ověřte, že je validní XML, a porovnejte několik produktů se stránkou e-shopu.

Proč na feedu záleží

Heureka je pro mnoho českých e-shopů významný zdroj zákazníků. Nabídky se na ní zobrazují přesně podle toho, co je ve vašem XML feedu: cena, dostupnost, doba dodání i kategorie. Špatná hodnota znamená nesprávně zobrazenou cenu, nižší pozici v porovnání, nebo vůbec žádnou nabídku.

Feed navíc slouží i pro další služby, například Heureka Košík nebo Ověřeno zákazníky. Chyby se proto projeví na více místech najednou.

Jak vypadá správný feed

Feed je soubor XML v kódování UTF-8. Kořenový prvek je SHOP, každý prodejný produkt nebo varianta je jeden prvek SHOPITEM. Názvy prvků se píší velkými písmeny. Podle oficiální specifikace Heureky jsou povinné čtyři prvky:

  • ITEM_ID: unikátní identifikátor položky, nejvýš 36 znaků (písmena bez diakritiky, číslice, lomítko, podtržítko, pomlčka). Musí zůstat stejný i při změně URL.
  • PRODUCTNAME: název produktu, nejvýš 200 znaků. Bez dárků a doplňků zdarma. Rozdíly mezi variantami (barva, velikost) patří do názvu.
  • URL: adresa produktu, unikátní, nejvýš 300 znaků. Stránka musí ukazovat cenu v Kč a možnost vložit do košíku.
  • PRICE_VAT: konečná cena v Kč včetně DPH, s poplatky (autorský, recyklační). Nejvýš dvě desetinná místa.

Důležité jsou i další prvky. CATEGORYTEXT je celá cesta kategorie, ideálně podle stromu Heureky. IMGURL je hlavní obrázek. DELIVERY_DATE je počet dní do odeslání (0 znamená skladem, prázdná hodnota zobrazí „informace v obchodě“), případně datum u předobjednávek. MANUFACTURER slouží k filtrování. EAN je povinný jen u vybraných kategorií, například knih, filmů nebo hudby, jinak je volitelný. Ověřte vždy aktuální znění v nápovědě Heureky, specifikace se mění.

Kontrola feedu krok za krokem

  1. Otevřete feed v prohlížeči

    Zkopírujte adresu feedu z administrace e-shopu nebo Heureky a otevřete ji. Pokud se zobrazí chyba místo XML, nebo prohlížeč hlásí „XML parsing error“, je feed poškozený a Heureka ho nezpracuje.

  2. Zkontrolujte počet a strukturu

    Najděte pár položek SHOPITEM a ověřte, že každá má všechny čtyři povinné prvky a že jsou názvy prvků velkými písmeny. Počet položek by měl odpovídat počtu prodejných produktů, které chcete na Heurece mít.

  3. Porovnejte cenu a dostupnost se stránkou

    Vyberte tři až pět produktů, včetně těch se slevou, a porovnejte PRICE_VAT a DELIVERY_DATE se stránkou. Rozdíl znamená, že feed zaostává, nebo používá jinou cenu (bez DPH, bez slevy).

  4. Podívejte se do administrace Heureky

    V administraci Heureky ověřte, kdy se feed naposledy stáhl a jaké chyby nebo upozornění hlásí. Konkrétní podoba přehledu se liší podle typu účtu a verze rozhraní. Heureka stahuje feed pravidelně, v placeném režimu častěji než v bezplatném.

  5. Ověřte jednotlivé produkty na Heurece

    Vyhledejte několik produktů na Heurece a porovnejte nabídku s feedem. Chybí-li produkt, hledejte u něj chybu v ITEM_ID, URL nebo v ceně.

Nejčastější chyby

  • Neescapované znaky &, < a > v názvu nebo popisu. Jediný takový znak může rozbít celý soubor. Správně je &amp;, nebo obsah vložit do bloku CDATA.
  • ITEM_ID, který se mění: generuje se z pořadí nebo z URL. Heureka pak ztrácí historii cen a spárování.
  • Chybějící nebo nesprávný CATEGORYTEXT, takže produkty skončí v nesprávné kategorii nebo nejsou srovnatelné.
  • Cena bez DPH nebo bez poplatků v PRICE_VAT.
  • Feed generovaný jednou denně, přestože se ceny a sklad mění průběžně.
  • Produkty, které nejsou skladem a nemají očekávané datum dodání, ale zůstaly ve feedu.
  • Duplicitní dopravci v prvcích DELIVERY nebo příliš mnoho speciálních služeb. Heureka je pak nezobrazí.
  • Obrázky s vodoznakem nebo s promo texty, případně adresa obrázku s diakritikou a mezerami.

Heureka.sk a Slovensko

Slovenská Heureka používá stejnou strukturu (SHOP, SHOPITEM, ITEM_ID, PRODUCTNAME, URL, PRICE_VAT), ceny se ale uvádějí v eurech a stránka produktu musí cenu v eurech ukazovat. EAN se akceptuje jen ve formátu EAN-13.

Co dělat, když to nejde opravit nastavením

Většina e-shopových platforem generuje feed pro Heureku automaticky. Pokud je ale chyba v datech (chybějící kategorie, EAN, názvy), je potřeba opravit zdroj. Úpravy výstupu feedu a hromadné opravy dat pro vás zařídíme. Souvisí s tím i feed pro Google, viz návod Zamítnuté produkty v Google Nákupech. Pro tuto službu platí cena od 4 990 Kč bez DPH, pevná cena je v reportu předem.

Časté otázky

Jak často Heureka stahuje feed?

Pravidelně, v placeném režimu častěji než v bezplatném. Aktuální intervaly uvádí nápověda Heureky. Než čekáte na změnu, ověřte, že je nová hodnota ve feedu a že ho Heureka už načetla.

Je EAN u každého produktu povinný?

Ne. Povinný je u vybraných kategorií, například knih, filmů nebo hudby. U ostatních je volitelný, ale pokud ho uvedete, musí to být oficiální EAN-13 od výrobce, ne interní číslo.

Proč se mi produkt na Heurece nezobrazuje?

Nejčastěji chybí povinný prvek, je neplatné XML, nefunguje URL, nebo je produkt označen jako nedostupný. Najděte položku ve feedu a ověřte ji proti seznamu povinných prvků.

Objednat audit zdarma

Vyplňte adresu e-shopu a e-mail. Report pošleme do dvou pracovních dnů. Vaše údaje použijeme jen k odpovědi na tuto žádost.

  • Bez přístupů a bez instalace
  • Report je váš, i když si nic neobjednáte
  • Odpovídá člověk, ne automat

Údaje použijeme jen k odpovědi na tuto žádost. Ochrana osobních údajů

Další návody