Voraussetzungen
- PrestaShop 1.7.6 oder neuer.
- Die Zip-Datei des Moduls, herunterzuladen auf der Seite Modules Ihres Kundenbereichs.
- Der Verbindungsschlüssel Ihrer Website.
Installation
- PrestaShop-Backoffice: Module > Modul-Manager > Modul hochladen.
- Laden Sie die Zip-Datei unverändert hoch, ohne sie zu entpacken.
- Klicken Sie auf Konfigurieren.
Konfiguration
- Tragen Sie Tenant ID, HMAC secret und Events endpoint ein: die drei Werte von der Seite Ihrer DataFirefly-Website.
- Option Require consent: Das Modul lässt ein Ereignis erst durch, wenn der Besucher Werbung akzeptiert hat. Es erkennt ohne Einstellung: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, im Browser wie auf dem Server, dieselbe Liste wie bei den WooCommerce- und Shopware-Modulen. Empfohlen, wenn Ihr Shop ein Consent-Banner hat.
- Stellen Sie Enable tracking auf Yes: Es ist standardmäßig deaktiviert.
- Speichern Sie, dann klicken Sie auf Send test event.
Noch kein Consent-Banner in Ihrem Shop? Das Modul Cookie Manager für PrestaShop liefert tarteaucitron einsatzbereit mit, inklusive Consent Mode v2.
Überprüfen
- Das Testereignis muss im Monitoring Ihres Kundenbereichs als Delivered erscheinen.
- Geben Sie eine Testbestellung auf: Das Modul sendet Käufe bei der Bestellbestätigung.
Wiederholungswarteschlange
Gilt ab Version 1.29.0.
- Eine fehlgeschlagene Übermittlung kommt in die Warteschlange und wird bei den Besuchen im Shop erneut gesendet: höchstens alle 30 Sekunden, nie zwei Durchläufe gleichzeitig, in Paketen von bis zu 20 Ereignissen, die parallel gesendet werden.
- Shop mit wenig Traffic: Eine optionale Cron-URL, durch ein Token geschützt und nur per https erreichbar, stößt die Wiederholung an, ohne auf einen Besuch zu warten.
- Käufe und Erstattungen gehen vor, danach die neuesten Ereignisse.
- Ein Ereignis verlässt die Warteschlange erst, wenn es älter als 7 Tage ist und seit mehr als 7 Tagen wartet. Es wird dann als abgelaufen gezählt: Nichts verschwindet stillschweigend.
- Antwortet DataFirefly nicht (Netzwerkfehler, HTTP 429 oder 5xx), sendet der Shop 60 Sekunden lang nicht mehr direkt und legt die Ereignisse sofort in die Warteschlange. Ein Ausfall bei uns bremst Ihren Shop und den Checkout also nie aus. Die Wiederholung versucht es weiter, und sobald sie gelingt, wird wieder direkt gesendet.
- Die Seite Ihrer Website im Kundenbereich zeigt den Zustand dieser Warteschlange. Die Zustände erklärt die Seite Fehlerbehebung.
Wenn etwas nicht funktioniert
- Logs: Erweiterte Einstellungen > Logs, filtern Sie nach dem Präfix
[DataFirefly SS]. - Wenn Sie eine Modulversion älter als 1.8.0 verwenden, aktualisieren Sie: Aktuelle Versionen beheben eine mögliche Doppelzählung der Käufe in GA4.
- Die weiteren häufigen Ursachen finden Sie im Leitfaden zur Fehlerbehebung.
Aktualisiert: 1. September 2026