Für wen Heureka ist#
Heureka ist ein Preisvergleicher — Benutzer suchen ein Produkt, Heureka zeigt ihnen E-Shops, die es verkaufen. Für einen E-Shop ist es eine Quelle bezahlten und organischen Traffics.
Wie die Verbindung erfolgt#
Heureka verwendet kein OAuth. In der Heureka-Administration generieren Sie einen API-Schlüssel für die Conversion Measurement API und fügen ihn in Margly ein.
Melden Sie sich in der Heureka-Administration an
Für CZ: sluzby.heureka.cz Für SK: sluzby.heureka.sk
Melden Sie sich mit einem Konto an, das Zugriff auf Ihren Heureka-E-Shop hat.
Generieren Sie den API-Schlüssel
Klappen Sie im linken Menü Statistiky a reporty auf und klicken Sie auf API měření konverzí. Rechts erscheint die Seite „API měření konverzí" mit dem Bereich 1. Získání API klíče — Sie generieren oder kopieren den Schlüssel aus dem Feld Váš API klíč.
Heureka-Administration: Klappen Sie im linken Menü Statistiky a reporty auf und klicken Sie auf API měření konverzí. Den Schlüssel kopieren Sie mit der Schaltfläche Zkopírovat klíč. Wenn Sie den Bereich API měření konverzí in der Heureka-Administration nicht sehen, kontaktieren Sie den Heureka-Support — manche älteren Verträge haben den API-Zugriff abgeschaltet und müssen ihn aktivieren lassen.
Fügen Sie den Schlüssel in Margly ein
Öffnen Sie in Margly Verbindungen → Heureka. Auf der Karte gibt es zwei separate Bereiche — Heureka CZ und Heureka SK. Fügen Sie in den Bereich, der Ihrem Markt entspricht, den API-Schlüssel ein und klicken Sie auf Heureku CZ verbinden (oder Heureku SK verbinden). Margly testet den Schlüssel sofort gegen die Heureka-API.
Wenn Sie einen E-Shop für beide Märkte haben, kehren Sie in der Heureka-Administration zum zweiten Markt zurück, generieren Sie dort einen separaten API-Schlüssel und fügen Sie ihn auf gleiche Weise in den zweiten Bereich in Margly ein.
Margly lädt historische Daten herunter
Nach der Schlüsselverifizierung beginnt Margly, historische Konversionsdaten herunterzuladen. Margly versucht, bis zu 2 Jahre zurück herunterzuladen (Heureka begrenzt die Daten rückwirkend selbst, sodass die tatsächliche Historie kürzer ausfällt). Das Herunterladen läuft Tag für Tag und dauert bei einer zweijährigen Historie größenordnungsmäßig einige Minuten bis Dutzende von Minuten je nach E-Shop-Größe.
Dann werden die Daten automatisch nach Ihrem Tarif aktualisiert (Starter 1×/Tag, Professional 2×/Tag, Business / Enterprise / Testphase 4×/Tag).
Was Margly aus Heureka tatsächlich lädt#
Margly ruft ausschließlich die Heureka Conversion Measurement API (/v1/reports/conversions) auf. Daraus erhält es tägliche Konversionsdaten, aufgeteilt in zwei Detailebenen:
Zusammenfassung pro Tag (eine Zeile pro Tag × Land)#
Besuche, Ausgaben, Bestellungen und Umsätze — mit wichtiger Aufteilung in bezahlte und organische Positionen:
| Metrik | Was sie bedeutet |
|---|---|
| Besuche insgesamt | Alle Klicks von Heureka auf Ihren E-Shop |
| Bezahlte Besuche (bidded) | Klicks aus Positionen, auf die Sie geboten haben (= dafür zahlen Sie Heureka) |
| Organische Besuche (free) | Klicks aus kostenlosen Positionen |
| Besuche ohne Gebot (not bidded) | Klicks aus Positionen, auf die nicht geboten wurde |
| Ausgaben | Ihre Kosten für Heureka — die Heureka-API gibt beide Varianten zurück (inkl. MwSt. und exkl. MwSt.), Margly speichert beide. Es werden nur bezahlte Positionen abgerechnet; für organische (free) Klicks zahlen Sie nicht. |
| Bestellungen | Gleiche Aufteilung (insgesamt / bezahlt / organisch / ohne Gebot) — wie viele Bestellungen aus welcher Position kamen |
| Umsätze | Gleiche Aufteilung — Wert der Bestellungen aus welcher Position |
Detail pro Produkt (eine Zeile pro Produkt × Tag × Land × Klickquelle)#
Gleiche Metriken, aber aufgeschlüsselt auf die Ebene einzelner Produkte im Heureka-Katalog — ID und Name des Produkts aus Ihrem E-Shop, ID der Kategorie des Heureka-Portals, Klickquelle (z. B. Suche) und Flag, ob es sich um eine geboten Position handelte.
Währung und MwSt.#
- Heureka CZ gibt Daten in CZK zurück, Heureka SK in EUR
- Wenn Ihr E-Shop eine andere Basiswährung hat, rechnet Margly Ausgaben und Umsätze zum EZB-Kurs in die Währung Ihres E-Shops um (speichert auch den Originalwert und die Umrechnung)
- Um die MwSt. müssen Sie sich nicht kümmern — die Heureka-API liefert direkt beide Varianten (inkl. MwSt. und exkl. MwSt.), Margly speichert beide und zeigt im Dashboard nach Ihrer Wahl in Abrechnung → Preise inkl. MwSt. anzeigen an
Häufige Fehler#
- „API-Schlüssel nicht verifiziert / 401" — der Schlüssel wurde in der Heureka-Administration gelöscht oder überschrieben. Generieren Sie einen neuen und fügen Sie ihn erneut in Margly ein.
- „Dieser Heureka-API-Schlüssel wird bereits von einem anderen Konto in Margly verwendet" — derselbe Schlüssel kann nicht zwei Margly-Konten zugeordnet werden. Trennen Sie ihn zuerst beim alten.
- „Heureka ist nur für E-Shops in CZ und SK verfügbar" — Sie haben in Margly ein anderes Geschäftsland als CZ oder SK eingestellt. Die Heureka-Verbindung unterstützt nur diese beiden Länder.
- „Heureka liefert keine Daten zurück" — die Verbindung wurde hergestellt, aber die API gibt leere Antworten zurück. Entweder haben Sie kein aktives Konversionsmessen in der Heureka-Administration, oder der API-Schlüssel gehört zu einem anderen E-Shop / zum zweiten Markt (SK-Schlüssel im Bereich Heureka CZ oder umgekehrt).
Wie geht's weiter#
- Verbindung Sklik — die zweite tschechische Werbe-Hauptplattform (über API-Token)
- KI-Berater — vergleicht die Rentabilität bezahlter Positionen auf Heureka mit anderen Werbekanälen