Heureka feed: najčastejšie chyby a ako ich opraviť

Prečo na feede záleží

Heureka je pre mnohé e-shopy významný zdroj zákazníkov. Ponuky sa na nej zobrazujú presne podľa toho, čo je vo vašom XML feede: cena, dostupnosť, doba dodania aj kategória. Zlá hodnota znamená nesprávne zobrazenú cenu, nižšiu pozíciu v porovnaní, alebo vôbec žiadnu ponuku.

Feed navyše slúži aj pre ďalšie služby, napríklad Heureka Košík alebo Overené zákazníkmi. Chyby sa preto prejavia na viacerých miestach naraz.

Ako vyzerá správny feed

Feed je súbor XML v kódovaní UTF-8. Koreňový prvok je SHOP, každý predajný produkt alebo variant je jeden prvok SHOPITEM. Názvy prvkov sa píšu veľkými písmenami. Slovenská Heureka používa rovnakú štruktúru ako česká, líši sa len menou: ceny sa uvádzajú v eurách. Podľa oficiálnej špecifikácie Heureky sú povinné štyri prvky:

• ITEM_ID: jedinečný identifikátor položky, najviac 36 znakov (písmená bez diakritiky, číslice, lomka, podčiarkovník, pomlčka). Musí zostať rovnaký aj pri zmene URL.
• PRODUCTNAME: názov produktu, najviac 200 znakov. Bez darčekov a doplnkov zadarmo. Rozdiely medzi variantmi (farba, veľkosť) patria do názvu.
• URL: adresa produktu, jedinečná, najviac 300 znakov. Stránka musí ukazovať cenu v eurách a možnosť vložiť do košíka.
• PRICE_VAT: konečná cena v eurách vrátane DPH, s poplatkami (autorský, recyklačný). Najviac dve desatinné miesta.

Dôležité sú aj ďalšie prvky. CATEGORYTEXT je celá cesta kategórie, ideálne podľa stromu Heureky. IMGURL je hlavný obrázok. DELIVERY_DATE je počet dní do odoslania (0 znamená skladom, prázdna hodnota zobrazí „informácie v obchode“), prípadne dátum pri predobjednávkach. MANUFACTURER slúži na filtrovanie. EAN je povinný len pri vybraných kategóriách, napríklad knihy, filmy alebo hudba, inak je voliteľný a akceptuje sa len formát EAN-13. Vždy si overte aktuálne znenie v pomocníkovi Heureky, špecifikácia sa mení.

Kontrola feedu krok za krokom

1. Otvorte feed v prehliadači

   Skopírujte adresu feedu z administrácie e-shopu alebo Heureky a otvorte ju. Ak sa zobrazí chyba namiesto XML, alebo prehliadač hlási „XML parsing error“, feed je poškodený a Heureka ho nespracuje.

2. Skontrolujte počet a štruktúru

   Nájdite niekoľko položiek SHOPITEM a overte, že každá má všetky štyri povinné prvky a že názvy prvkov sú veľkými písmenami. Počet položiek by mal zodpovedať počtu predajných produktov, ktoré chcete mať na Heureke.

3. Porovnajte cenu a dostupnosť so stránkou

   Vyberte tri až päť produktov, aj tie so zľavou, a porovnajte PRICE_VAT a DELIVERY_DATE so stránkou. Rozdiel znamená, že feed zaostáva, alebo používa inú cenu (bez DPH, bez zľavy).

4. Pozrite sa do administrácie Heureky

   V administrácii Heureky overte, kedy sa feed naposledy stiahol a aké chyby alebo upozornenia hlási. Konkrétna podoba prehľadu sa líši podľa typu účtu a verzie rozhrania. Heureka sťahuje feed pravidelne, v platenom režime častejšie než v bezplatnom.

5. Overte jednotlivé produkty na Heureke

   Vyhľadajte niekoľko produktov na Heureke a porovnajte ponuku s feedom. Ak produkt chýba, hľadajte pri ňom chybu v ITEM_ID, URL alebo v cene.

Najčastejšie chyby

• Neescapované znaky &, < a > v názve alebo popise. Jediný takýto znak môže rozbiť celý súbor. Správne je &, alebo obsah vložiť do bloku CDATA.
• ITEM_ID, ktoré sa mení: generuje sa z poradia alebo z URL. Heureka potom stráca históriu cien a spárovanie.
• Chýbajúci alebo nesprávny CATEGORYTEXT, takže produkty skončia v nesprávnej kategórii alebo nie sú porovnateľné.
• Cena bez DPH alebo bez poplatkov v PRICE_VAT.
• Feed generovaný raz denne, hoci sa ceny a sklad menia priebežne.
• Produkty, ktoré nie sú skladom a nemajú očakávaný dátum dodania, ale zostali vo feede.
• Duplicitní dopravcovia v prvkoch DELIVERY alebo príliš veľa špeciálnych služieb. Heureka ich potom nezobrazí.
• Obrázky s vodoznakom alebo s promo textami, prípadne adresa obrázka s diakritikou a medzerami.

Čo robiť, keď sa to nedá opraviť nastavením

Väčšina e-shopových platforiem generuje feed pre Heureku automaticky. Ak je ale chyba v dátach (chýbajúce kategórie, EAN, názvy), treba opraviť zdroj. Úpravy výstupu feedu a hromadné opravy dát pre vás zabezpečíme. Súvisí s tým aj feed pre Google, pozrite si návod Zamietnuté produkty v Google Nákupoch. Pre túto službu platí cena od 200 € bez DPH, pevná cena je v reporte vopred.