Jak upravit XML feed pro Heureka.cz a Heureka.sk

Než začnete: co se s feedem na Heurece děje

Cesta produktu má tři kroky a vyplatí se je znát, protože každý problém se dá zařadit právě do jednoho z nich.

Nejdřív Heureka feed stáhne. V režimu PPC si ho bere každé dvě hodiny, v režimu FREE každé čtyři (Heureka, specifikace XML souboru). Když potřebujete hlásit změny dostupnosti a cen rychleji, slouží k tomu samostatný dostupnostní feed, který se načítá každých deset minut (Heureka, dostupnostní feed).

Pak přijde párování. Heureka se pokouší vaši nabídku připojit k existující produktové kartě v katalogu, případně jí kartu založí. Rozhoduje o tom hlavně název, kategorie a EAN. Párovací proces má svůj rytmus — po změně názvu, adresy nebo kategorie trvá zhruba čtyři pracovní dny, než se to na Heurece projeví. Když tedy něco opravíte a druhý den se nic nezměnilo, není to chyba, jen se čeká.

Teprve nakonec se nabídka zobrazí. A tady se ukáže zbytek feedu. Parametry, tedy vlastnosti zboží jako barva, velikost nebo příkon, rozhodují o filtrech. Dárek a záruka o tom, čím se lišíte od ostatních. Cena za proklik pak o pořadí v žebříčku e-shopů.

Obecné základy feedů — z čeho se skládá, jak vzniká a čím se liší XML od CSV — rozebírá samostatný článek Produktový feed pro e-shop: základy XML a CSV srozumitelně. Tady jdeme rovnou do heurecké specifiky.

Povinné minimum: bez čeho se produkt nezobrazí

Než začnete cokoli ladit, vyplatí se ověřit základ. Většina produktů, které se na Heurece neukazují, na tom není kvůli chybějícímu dárku nebo špatné ceně za proklik, ale proto, že jim chybí něco z tohohle minima. Čtyři elementy jsou nepodkročitelné a bez nich Heureka nabídku nezpracuje:

• ITEM_ID — jednoznačný identifikátor produktu, maximálně 36 znaků, bez diakritiky. Musí zůstat stejný i po změně adresy produktu, protože podle něj se drží historie párování.
• PRODUCTNAME — název, maximálně 200 znaků.
• PRICE_VAT — koncová cena s DPH, nejvýš dvě desetinná místa. Musí odpovídat ceně po uplatnění případného slevového kódu.
• URL — adresa produktu, maximálně 300 znaků. Na cílové stránce musí být vidět cena a možnost vložit zboží do košíku.

Vedle nich jsou dva elementy formálně nepovinné, prakticky ale bez nich nic nefunguje. CATEGORYTEXT rozhoduje o zařazení do katalogu a IMGURL o tom, jestli má nabídka obrázek. U obrázku si přitom Heureka hlídá tři věci:

• rozměry od 20 × 50 px do 4096 × 4096 px, doporučeně 175 × 175 px,
• velikost souboru do 2 000 kB,
• formát webp, jpeg, png nebo bmp.

Ještě jedno pravidlo, na kterém se pravidelně padá: názvy značek se píší velkými písmeny. Tedy , ne . A speciální znaky se musí ošetřit — z ampersandu je &, z lomených závorek < a >, případně se obsah zabalí do CDATA.

Kategorie: CATEGORYTEXT a strom Heureky

Kategorie je nejsilnější signál pro párování. Uvádí se jako celá cesta stromem Heureky, jednotlivé úrovně oddělené svislítkem, a začíná se od kořene:

Heureka.cz | Velké spotřebiče | Pračky a sušičky | Pračky

Aktuální strom si Heureka udržuje ve veřejném souboru na adrese https://www.heureka.cz/direct/xml-export/shops/heureka-sekce.xml (Heureka, strom kategorií).

Když pro produkt vhodnou kategorii nenajdete, existují ještě parametrické kategorie. Ty ve stromu nejsou a produkt se do nich dostane vyplněním parametrů. Počítejte ale s tím, že párování pak trvá déle a zařazení bývá méně přesné.

Přepisovat kvůli tomu kategorie přímo v e-shopu by ale znamenalo podřídit celý katalog jednomu srovnávači. Proto se převod dělá až ve feedu: v Conviu k tomu slouží pravidlo hromadný přepis CATEGORYTEXT, kde vám našeptávač nabízí platné kategorie ze stromu. Vaše kategorie v e-shopu tak zůstanou beze změny a přeloží se až na výstupu pro Heureku.

Modelový příklad. E-shop s reklamními předměty má jedinou kategorii „Propagační materiály“ a jsou v ní hrnky, propisky i bloky. Heureka pro takovou směs žádnou kategorii nemá, takže by se produkty nespárovaly. Řešením je pravidlo, které kategorii odvodí z názvu: obsahuje-li název slovo „propiska“, nastaví se Pera a propisky, obsahuje-li „hrnek“, nastaví se Hrnky a šálky. Pravidlo platí i do budoucna, takže nově založený produkt se zařadí sám.

Název produktu: PRODUCTNAME a PRODUCT

Název je po kategorii druhý nejsilnější párovací signál. Heureka od něj čeká jen popis samotného produktu — žádné dárky, slevy ani doplňky. Varianta patří do názvu vždy, takže barva, velikost nebo vzor musí být vidět.

Každá kategorie má vlastní strukturu názvu a Heureka je drží v samostatném seznamu (Heureka, povinné názvy). Digitální fotoaparát chce „Výrobce | Řada | Produktové číslo | Barva“, pračka „Výrobce | Produktové číslo“, počítačová hra úplný název včetně edice. Nedodržení doporučené struktury může být podle Heureky důvodem k zablokování produktu v kategorii, takže se to nevyplatí odhadovat.

Jedna výjimka z pravidla „jen produkt“ přesto platí: nestandardní balení do názvu patří. Když prodáváte tutéž věc ve vánočním balení nebo jako dárkovou sadu, má to být v názvu vidět — třeba „Vánoční balení“ nebo „Dárková sada“. Jinak se nabídka spáruje s kartou běžného balení a zákazník dostane něco jiného, než čekal.

Vedle toho stojí element PRODUCT. Ten obsahuje název plus informaci o distribuci nebo osobním odběru — třeba „Whirlpool WBA 43983 NFC IX – osobní odběr v Praze“ — a zobrazuje se v žebříčku e-shopů na produktové kartě. Informace o záruce ani doplňkových službách sem nepatří, na ty jsou samostatné elementy.

Protože má každá kategorie vlastní pravidla, ruční přepisování názvů u většího katalogu nikam nevede. V Conviu proto název skládáte z proměnných pravidlem Upravit element, takže nemusíte přepisovat produkty jeden po druhém. Zápis %manufacturer% %productname% %param-value-objem% z názvu „Ultra Lotio SPF25“ udělá „Daylong Ultra Lotio SPF25 200 ml“. Název na e-shopu přitom zůstane, jaký byl — mění se jen to, co odchází na Heureku.

Když potřebujete zasáhnout do stovek názvů ručně, hodí se hromadná úprava přes tabulku. Z Conviu si vygenerujete CSV, upravíte ho v Excelu a nahrajete zpět; první sloupec musí zůstat ITEM_ID, protože podle něj se řádky spárují. Pro název tedy stačí tři sloupce: ITEM_ID; PRODUCTNAME; PRODUCT. Alternativou je tabulka v Google Sheets, kterou v pravidle nasdílíte — výhoda je, že na ní může pracovat víc lidí najednou.

Parametry: bez nich vás filtr přeskočí

Parametry jsou to, čím zákazník na Heurece zužuje výběr. Když je ve feedu nemáte, produkt se ve filtrovaném výpisu prostě neobjeví, i kdyby jinak vyhovoval.

Zapisují se dvojicí: PARAM_NAME s názvem parametru a VAL s hodnotou. Názvy parametrů nejsou libovolné — Heureka pro ně vede vlastní seznam a v některých kategoriích jsou parametry povinné.

Vyplňovat je ručně u tisíců produktů ale nedává smysl, a proto se doplňují pravidlem. V Conviu k tomu slouží tvorba PARAM, a to podmíněně: podle kategorie, výrobce nebo obsahu názvu. Barvu tak vytáhnete z názvu produktu jedním pravidlem pro celý katalog. Pokročilejší je pak práce s regulárními výrazy, tedy zápisem, kterým se hledají vzory v textu — u velkého katalogu se vyplatí, protože jedno pravidlo zastane tisíce ručních úprav.

Dostupnost, doprava a varianty

Tahle trojice rozhoduje o tom, jestli se zákazník k nákupu vůbec dostane. Dostupnost a doprava vstupují do porovnání ještě před cenou — kdo má zboží skladem a doveze ho levněji, vyhrává i s vyšší cenou. A varianty rozhodují o tom, jestli se z jednoho trička ve čtyřech velikostech stane jedna nabídka, nebo čtyři, které si navzájem konkurují.

Dostupnost se hlásí elementem DELIVERY_DATE. Hodnota 0 znamená skladem, číslo udává počet dní do odeslání, a u předobjednávek se dá uvést konkrétní datum ve tvaru 2026-08-15.

Doprava se zapisuje blokem DELIVERY, který se opakuje pro každého dopravce — jeden dopravce smí být u produktu jen jednou. Uvnitř bloku je DELIVERY_ID z předdefinovaného seznamu Heureky, DELIVERY_PRICE bez dobírky a nepovinně DELIVERY_PRICE_COD s dobírkou. Ceny musí sedět s tím, co má zákazník v košíku na e-shopu. V Conviu se blok skládá pravidlem Přidat element s vnořenou strukturou.

Varianty drží pohromadě element ITEMGROUP_ID. Všechny velikosti jednoho trička dostanou stejnou hodnotu, každá varianta si ale ponechá vlastní ITEM_ID a vlastní adresu. Díky tomu se z jedné velikosti nestane samostatný produkt a zákazník na Heurece může vybírat mezi variantami u jedné nabídky.

Čím nabídku odlišíte: dárek, sleva, záruka a služby

Na produktové kartě stojí e-shopy pod sebou v žebříčku a zákazník kouká hlavně na cenu. Jenže cenou hýbat vždycky nejde — třeba když máte s dodavatelem dohodnutou prodejní cenu. Pořád ale zbývá druhá cesta, jak vypadat líp než soused: dát k nabídce něco navíc a říct to Heurece elementem, který na to má.

Všechny elementy z téhle kapitoly se zapisují uvnitř , tedy u konkrétního produktu, a všechny se v Conviu doplňují pravidlem Přidat element. U těch, které mají uvnitř další značky, se zvolí vnořená struktura.

Dárek — GIFT

Dárek je z těchhle možností nejviditelnější, protože se ukáže přímo u vaší nabídky v žebříčku e-shopů. Dobře funguje sezónně a u zboží s dostatečnou marží, kde drobnost navíc nebolí.

Popis dárku smí mít nejvýš 250 znaků a element se dá u produktu uvést vícekrát. Podmínka je jediná, zato tvrdá: dárek musí dostat každý. Nesmí být vázaný na nákup více kusů, na registraci ani na nic dalšího — jinak ho Heureka nepřijme.

<GIFT>Potítko Nike Swoosh</GIFT>

V Conviu se dárek dá omezit časově a přidat jen tomu, komu chcete — třeba produktům jedné značky nebo nad určitou cenu. Sezónní akci tak nastavíte dopředu a sama skončí.

Slevový kód — SALES_VOUCHER

Slevový kód se chová jinak než dárek. Heureka ho ukáže u nabídky a zákazník ho uplatní až v košíku. Pozor ale na to, co z toho plyne pro cenu: PRICE_VAT už musí být cena po slevě. Kód tedy není skrytý bonus navíc, ale způsob, jak zákazník k avizované ceně dojde.

Kód se skládá ze tří částí. CODE je samotný kód, nejvýš 24 znaků. DESC popisuje slevu, nejvýš 128 znaků. EXPIRATION_DATE je nepovinné datum platnosti.

<SALES_VOUCHER>
	<CODE>LETO25</CODE>
	<DESC>Sleva 10 % na celý nákup</DESC>
	<EXPIRATION_DATE>2026-08-31</EXPIRATION_DATE>
</SALES_VOUCHER>

Stejně jako u dárku platí, že kód musí být uplatnitelný všemi a bez dalších podmínek.

Prodloužená záruka — EXTENDED_WARRANTY

Prodloužená záruka je argument u dražšího zboží, kde zákazník váhá — spotřebiče, elektronika, nářadí. Heureka ji ale zobrazí jen tehdy, když ji dostane tímhle elementem. Napsat ji do popisu nebo přilepit k názvu produktu nestačí, a v názvu je to dokonce chyba.

Element má dvě části: VAL s počtem měsíců a DESC s popisem do 128 znaků. Hodnota nad 999 znamená doživotní záruku.

<EXTENDED_WARRANTY>
	<VAL>36</VAL>
	<DESC>Záruka 36 měsíců</DESC>
</EXTENDED_WARRANTY>

V Conviu se záruka obvykle nastavuje podmíněně, protože ji nemáte na celém katalogu stejnou — třeba jen na jednu značku nebo na produktovou řadu.

Doplňkové služby — SPECIAL_SERVICE

U velkých spotřebičů a nábytku rozhodují služby často víc než stokoruna na ceně. Kdo mi to vynese do patra, kdo to zapojí, kdo odveze starý spotřebič a obal. Přesně tyhle věci patří do SPECIAL_SERVICE.

Element se pro každou službu opakuje a jeden popis smí mít nejvýš 128 znaků. Služby smí být nejvýš pět. Při šesté Heureka element vůbec nezpracuje a u produktu se nezobrazí ani jedna služba, takže se nevyplatí sem vypisovat všechno, co vás napadne — radši vyberte to, co zákazníka opravdu zajímá.

<SPECIAL_SERVICE>Instalace spotřebiče zdarma</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Montáž spotřebiče zdarma</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Odvoz obalového materiálu</SPECIAL_SERVICE>
<SPECIAL_SERVICE>Vynesení do patra</SPECIAL_SERVICE>

Vedle instalace, montáže, vynesení a odvozu obalu sem patří i servis zdarma, prodloužený záruční i pozáruční servis a delší lhůta na vrácení zboží. Nepatří sem naopak nic z tohoto:

• doprava zdarma — ta patří do DELIVERY,
• informace o dostupnosti — ta patří do dostupnostního feedu,
• označení autorizovaného prodejce,
• možnost splátkového prodeje,
• osobní odběr na pobočkách,
• jakákoli forma slevy, ať už okamžitá sleva, akční cena nebo bonus na další nákup.

Většina z toho má vlastní místo jinde ve feedu, takže tím o nic nepřicházíte — jen to musí jít správnou cestou.

Příslušenství — ACCESSORY

Příslušenství není nabídka navíc, ale propojení. Heureka se díky němu dozví, že tahle nabíječka nebo tohle pouzdro patří k tomuhle konkrétnímu produktu, a umí je nabídnout k němu. Element obsahuje ITEM_ID příslušenství, tedy jeho identifikátor z vašeho feedu, a u jednoho produktu jich smí být nejvýš deset.

<ACCESSORY>NAB-1234</ACCESSORY>
<ACCESSORY>POUZ-5678</ACCESSORY>

Údaje o výrobci: co do feedu přidalo GPSR

S evropským nařízením o obecné bezpečnosti výrobků přibyly do feedu kontaktní údaje výrobce. Vedle elementu MANUFACTURER, který slouží k filtrování podle značky, jsou to MANUFACTURER_POSTAL_ADDRESS s poštovní adresou a MANUFACTURER_ELECTRONIC_ADDRESS s e-mailem nebo odkazem na kontaktní formulář.

Tyhle údaje bývají největší bolestí celého feedu, protože je e-shop obvykle nemá — leží u dodavatele. Řešením je doplnit je jednou k dodavateli nebo ke značce a nechat je pravidlem propsat na všechny jeho produkty, ne je vypisovat u každého zboží zvlášť.

Bidding: element HEUREKA_CPC

Pořadí e-shopů u produktu není náhodné ani abecední. Rozhoduje o něm cena, kterou jste ochotní zaplatit za jeden proklik, a tomu se říká bidding. Vyšší pozice znamená víc prokliků, ale taky vyšší náklad, takže jde o to najít hranici, kde se to ještě vyplácí.

Ve feedu se cena za proklik nastavuje elementem HEUREKA_CPC. Maximum je 1 000 Kč, desetinná místa se oddělují čárkou, a když u produktu bidovat nechcete, element se prostě vůbec neuvádí — nulou to nejde.

Minimální cena za proklik se přitom odvíjí od kategorie a cenového pásma produktu, takže jedna univerzální částka pro celý katalog nedává smysl. Buď se tedy cena nastavuje pravidlem podle segmentu — výrobce, kategorie, cena, dostupnost — nebo se práce přenechá automatickému biddingu, který ceny přepočítává podle statistik několikrát denně.

Jak sestavit bidovací strategii, stanovit cílové PNO a katalog rozumně rozdělit na segmenty, rozebírá do hloubky článek Automatický bidding na Heurece a Zboží.cz.

Heureka Marketplace: co musí feed umět navíc

Marketplace je režim, ve kterém zákazník nakupuje přímo na Heurece a ta objednávku zprostředkuje. Neplatíte za proklik, ale provizi z hodnoty nákupu včetně DPH (Heureka, výše provize).

Na feed to klade tři požadavky navíc:

• PRICE_VAT zaokrouhlená na celé koruny. Haléřové ceny se pro Marketplace nepoužívají.
• Kompletní DESCRIPTION. V běžném výpisu se z popisu zobrazuje jen prvních 200 znaků, pro Marketplace ale musí být popis úplný.
• Element VAT u snížených sazeb. Zapisuje se jako procentní hodnota, tedy třeba 12%, a je povinný u zboží, které nemá základní sazbu DPH.

Varianty produktu jde v Marketplace koupit jen tehdy, když jsou popsané ve feedu — tedy když máte v pořádku ITEMGROUP_ID a varianty rozlišené v názvu. Napojení Conviu na tuhle část Heureky najdete na stránce integrace Heureka Marketplace.

Heureka.sk: co všechno se musí přeložit

Slovenská Heureka běží na stejné specifikaci, jen chce feed ve slovenštině. Chyba, na které se to obvykle zadrhne, není v názvech a popisech — na ty si každý vzpomene. Zapomíná se na parametry, protože se překládá jméno parametru i jeho hodnota, a dál na dárky, popisy záruk a doplňkových služeb.

V Conviu se překlad nastavuje jako pravidlo a na výběr jsou tři překladače — DeepL, Google Translate a Microsoft Bing — takže se dá volit podle jazykové dvojice. Text se přeloží jednou a dál se drží, takže se za stejný obsah neplatí opakovaně. Detailně to rozebírá stránka automatického překladače.

Jak si ověřit, že se produkty spárovaly

Feed můžete mít podle specifikace a stejně se část produktů neukáže. Dobrá zpráva je, že vám Heureka sama řekne kde a proč — stačí se podívat na správné místo.

Zpětnou vazbu dává přehled spárovanosti v administraci Heureky. Ukáže, kolik produktů je spárovaných, kolik čeká, kolik je ignorovaných a kolik se nespárovalo.

Každý stav ukazuje na jinou příčinu a řeší se jinde ve feedu:

• Ignorovaná kategorie — kategorie neodpovídá stromu Heureky. Opravuje se v CATEGORYTEXT.
• Nespárovaný produkt — název neodpovídá tomu, co Heureka v kategorii čeká. Opravuje se v PRODUCTNAME, případně doplněním EAN.
• Produkt nelze zařadit — chybí povinný parametr kategorie. Doplní se přes PARAM.

Párování s katalogem umí Conviu i navrhovat: párovač produktů vezme nespárované nabídky, najde k nim odpovídající karty na Heurece a vy jen potvrdíte, co sedí. Odpárovat nebo skrýt nerelevantní návrh jde kdykoli.

A ještě jedna drobnost, která ušetří starosti: produkty, které dlouhodobě nemáte skladem nebo je kvůli nízké marži nechcete propagovat, nemusíte z e-shopu mazat. Stačí je z výstupu pro Heureku skrýt.

Nejčastější chyby napříč feedy — od kódování přes duplicitní identifikátory po neaktuální ceny — jsme sepsali v článku Typické chyby ve feedu e-shopu a jak je opravit.

Kam s tím dál

Heurecký feed se dá zvládnout jedním pravidlem po druhém a většina úprav je jednorázová — jednou nastavený převod kategorií nebo skládání názvů platí i pro produkty, které teprve založíte.

Všechny úpravy popsané výše se dělají v editoru datových feedů Conviu, tedy mimo váš e-shop: data se načtou, upraví podle pravidel a odešlou na Heureku v podobě, kterou čeká. Souvislosti kolem srovnávačů obecně najdete v tématu Zbožové srovnávače pro e-shop.

Pokud na to nemáte čas nebo si nejste jistí, kde začít, pomůžeme vám s feedem i s jeho správou.