Pro koho je Heureka#
Heureka je srovnávač zboží — uživatelé hledají produkt, Heureka jim ukáže e-shopy, které ho prodávají. Pro e-shop je to zdroj placené i organické návštěvnosti.
Jak se napojuje#
Heureka nepoužívá OAuth. V Heureka administraci si vygenerujete API klíč pro Conversion Measurement API a vložíte ho do Margly.
Přihlaste se do Heureka administrace
Pro CZ: sluzby.heureka.cz Pro SK: sluzby.heureka.sk
Přihlašujte se účtem, který má přístup k vašemu Heureka eshopu.
Vygenerujte API klíč
V levém menu rozbalte Statistiky a reporty a klikněte na API měření konverzí. Vpravo se zobrazí stránka „API měření konverzí" se sekcí 1. Získání API klíče — vygenerujete nebo zkopírujete klíč z políčka Váš API klíč.
Heureka administrace: v levém menu rozbalte Statistiky a reporty a klikněte na API měření konverzí. Klíč zkopírujete tlačítkem Zkopírovat klíč. Pokud sekci API měření konverzí v Heureka administraci nevidíte, kontaktujte Heureka podporu — některé starší smlouvy mívají API přístup vypnutý a je třeba ho povolit.
Vložte klíč do Margly
V Margly otevřete Napojení → Heureka. Na kartě jsou dvě samostatné sekce — Heureka CZ a Heureka SK. Do sekce odpovídající vašemu trhu vložte API klíč a klikněte na Připojit Heureku CZ (nebo Připojit Heureku SK). Margly klíč ihned otestuje proti Heureka API.
Pokud máte e-shop pro oba trhy, vraťte se v Heureka administraci do druhého trhu, vygenerujte si tam samostatný API klíč a vložte ho do druhé sekce v Margly stejným způsobem.
Margly stáhne historická data
Po ověření klíče Margly začne stahovat historická konverzní data. Margly se snaží stáhnout až 2 roky zpět (Heureka data zpětně omezuje sama, takže reálná historie bývá kratší). Stahování běží den po dni a u dvouleté historie trvá řádově několik minut až desítky minut podle velikosti e-shopu.
Pak se data automaticky aktualizují podle vašeho tarifu (Starter 1×/den, Professional 2×/den, Business / Enterprise / Trial 4×/den).
Co Margly z Heureky reálně načítá#
Margly volá výhradně Heureka Conversion Measurement API (/v1/reports/conversions). Z něj získává denní konverzní data rozdělená do dvou úrovní detailu:
Souhrn za den (jeden řádek per den × země)#
Návštěvy, útrata, objednávky a tržby — s důležitým rozdělením na placené a organické pozice:
| Metrika | Co znamená |
|---|---|
| Návštěvy celkem | Všechny kliky z Heureky na váš e-shop |
| Placené návštěvy (bidded) | Kliky z pozic, kde jste dražili (= za ně platíte Heurece) |
| Organické návštěvy (free) | Kliky z bezplatných pozic |
| Návštěvy bez nabídky (not bidded) | Kliky z pozic, kde se nedražilo |
| Útrata | Vaše náklady na Heuereku — Heureka API vrací obě varianty (s DPH i bez DPH), Margly obě ukládá. Účtují se jen placené pozice; za organické (free) kliky neplatíte. |
| Objednávky | Stejné rozdělení (celkem / placené / organické / bez nabídky) — kolik objednávek přišlo z které pozice |
| Tržby | Stejné rozdělení — hodnota objednávek z které pozice |
Detail per produkt (jeden řádek per produkt × den × země × zdroj kliku)#
Stejné metriky, ale rozpadlé na úroveň jednotlivého produktu v Heureka katalogu — ID a název produktu z vašeho e-shopu, ID kategorie Heureka portálu, zdroj kliku (např. vyhledávání), a vlajka, jestli šlo o draženou pozici.
Měna a DPH#
- Heureka CZ vrací data v CZK, Heureka SK v EUR
- Pokud má váš e-shop jinou základní měnu, Margly útratu i tržby přepočítá kurzem ECB do měny vašeho e-shopu (uloží si i původní hodnotu i přepočet)
- DPH řešit nemusíte — Heureka API rovnou vrací obě varianty (s DPH i bez DPH), Margly obě ukládá a v dashboardu zobrazí podle vaší volby v Fakturace → Zobrazovat ceny s DPH
Časté chyby#
- „API klíč neověřen / 401" — klíč byl smazaný nebo přepsaný v Heureka administraci. Vygenerujte nový a vložte do Margly znovu.
- „Tento Heureka API klíč už používá jiný účet v Margly" — stejný klíč nelze přiřadit dvěma účtům Margly. Nejdřív ho odpojte u starého.
- „Heureka je dostupná pouze pro e-shopy v ČR a SR" — máte v Margly nastavenou jinou zemi podnikání než CZ nebo SK. Heureka napojení podporuje jen tyto dvě země.
- „Heureka nevrací data" — napojení proběhlo, ale API vrací prázdné odpovědi. Buď nemáte aktivní měření konverzí v Heureka administraci, nebo API klíč patří k jinému e-shopu / k druhému trhu (SK klíč nasazený do sekce Heureka CZ nebo naopak).
Co dál#
- Napojení Sklik — druhá hlavní česká reklamní platforma (přes API token)
- AI Poradce — porovnává výnosnost placených pozic na Heurece s ostatními reklamními kanály