Pre koho je Heureka#
Heureka je porovnávač tovaru — používatelia hľadajú produkt, Heureka im ukáže e-shopy, ktoré ho predávajú. Pre e-shop je to zdroj platenej aj organickej návštevnosti.
Ako sa napája#
Heureka nepoužíva OAuth. V Heureka administrácii si vygenerujete API kľúč pre Conversion Measurement API a vložíte ho do Margly.
Prihláste sa do Heureka administrácie
Pre CZ: sluzby.heureka.cz Pre SK: sluzby.heureka.sk
Prihlasujte sa účtom, ktorý má prístup k vášmu Heureka eshopu.
Vygenerujte API kľúč
V ľavom menu rozbaľte Štatistiky a reporty a kliknite na API meranie konverzií. Vpravo sa zobrazí stránka „API meranie konverzií" so sekciou 1. Získanie API kľúča — vygenerujete alebo skopírujete kľúč z políčka Váš API kľúč.
Heureka administrácia: v ľavom menu rozbaľte Štatistiky a reporty a kliknite na API meranie konverzií. Kľúč skopírujete tlačidlom Skopírovať kľúč. Pokiaľ sekciu API meranie konverzií v Heureka administrácii nevidíte, kontaktujte Heureka podporu — niektoré staršie zmluvy mávajú API prístup vypnutý a je potreba ho povoliť.
Vložte kľúč do Margly
V Margly otvorte Napojenia → Heureka. Na karte sú dve samostatné sekcie — Heureka CZ a Heureka SK. Do sekcie zodpovedajúcej vášmu trhu vložte API kľúč a kliknite na Pripojiť Heureku CZ (alebo Pripojiť Heureku SK). Margly kľúč ihneď otestuje proti Heureka API.
Pokiaľ máte e-shop pre oba trhy, vráťte sa v Heureka administrácii do druhého trhu, vygenerujte si tam samostatný API kľúč a vložte ho do druhej sekcie v Margly rovnakým spôsobom.
Margly stiahne historické dáta
Po overení kľúča Margly začne sťahovať historické konverzné dáta. Margly sa snaží stiahnuť až 2 roky späť (Heureka dáta spätne obmedzuje sama, takže reálna história býva kratšia). Sťahovanie beží deň po dni a pri dvojročnej histórii trvá rádovo niekoľko minút až desiatok minút podľa veľkosti e-shopu.
Potom sa dáta automaticky aktualizujú podľa vášho tarifu (Starter 1×/deň, Professional 2×/deň, Business / Enterprise / Trial 4×/deň).
Čo Margly z Heureky reálne načíta#
Margly volá výhradne Heureka Conversion Measurement API (/v1/reports/conversions). Z neho získava denné konverzné dáta rozdelené do dvoch úrovní detailu:
Súhrn za deň (jeden riadok per deň × krajina)#
Návštevy, útrata, objednávky a tržby — s dôležitým rozdelením na platené a organické pozície:
| Metrika | Čo znamená |
|---|---|
| Návštevy celkom | Všetky kliky z Heureky na váš e-shop |
| Platené návštevy (bidded) | Kliky z pozícií, kde ste dražili (= za ne platíte Heureke) |
| Organické návštevy (free) | Kliky z bezplatných pozícií |
| Návštevy bez ponuky (not bidded) | Kliky z pozícií, kde sa nedražilo |
| Útrata | Vaše náklady na Heureku — Heureka API vracia obe varianty (s DPH aj bez DPH), Margly obe ukladá. Účtujú sa len platené pozície; za organické (free) kliky neplatíte. |
| Objednávky | Rovnaké rozdelenie (celkom / platené / organické / bez ponuky) — koľko objednávok prišlo z ktorej pozície |
| Tržby | Rovnaké rozdelenie — hodnota objednávok z ktorej pozície |
Detail per produkt (jeden riadok per produkt × deň × krajina × zdroj kliku)#
Rovnaké metriky, ale rozpadnuté na úroveň jednotlivého produktu v Heureka katalógu — ID a názov produktu z vášho e-shopu, ID kategórie Heureka portálu, zdroj kliku (napr. vyhľadávanie), a vlajka, či šlo o draženú pozíciu.
Mena a DPH#
- Heureka CZ vracia dáta v CZK, Heureka SK v EUR
- Pokiaľ má váš e-shop inú základnú menu, Margly útratu aj tržby prepočíta kurzom ECB do meny vášho e-shopu (uloží si aj pôvodnú hodnotu aj prepočet)
- DPH riešiť nemusíte — Heureka API rovno vracia obe varianty (s DPH aj bez DPH), Margly obe ukladá a v dashboarde zobrazí podľa vašej voľby v Fakturácia → Zobrazovať ceny s DPH
Časté chyby#
- „API kľúč neoverený / 401" — kľúč bol zmazaný alebo prepísaný v Heureka administrácii. Vygenerujte nový a vložte do Margly znova.
- „Tento Heureka API kľúč už používa iný účet v Margly" — rovnaký kľúč nemožno priradiť dvom účtom Margly. Najprv ho odpojte pri starom.
- „Heureka je dostupná iba pre e-shopy v ČR a SR" — máte v Margly nastavenú inú krajinu podnikania než CZ alebo SK. Heureka napojenie podporuje len tieto dve krajiny.
- „Heureka nevracia dáta" — napojenie prebehlo, ale API vracia prázdne odpovede. Buď nemáte aktívne meranie konverzií v Heureka administrácii, alebo API kľúč patrí k inému e-shopu / k druhému trhu (SK kľúč nasadený do sekcie Heureka CZ alebo naopak).
Čo ďalej#
- Napojenie Sklik — druhá hlavná česká reklamná platforma (cez API token)
- AI Poradca — porovnáva výnosnosť platených pozícií na Heureke s ostatnými reklamnými kanálmi