Voraussetzungen
- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. HPOS-kompatibel.
- Die Zip-Datei des Plugins, herunterzuladen auf der Seite Modules Ihres Kundenbereichs.
- Der Verbindungsschlüssel Ihrer Website.
Installation
- WordPress-Admin: Plugins > Add New > Upload Plugin.
- Laden Sie die Zip-Datei hoch, dann klicken Sie auf Activate.
Konfiguration
- Öffnen Sie Settings > DataFirefly Server-Side.
- Fügen Sie den Verbindungsschlüssel
dfss_...ein und klicken Sie auf Connect: Der Button aktiviert das vollständige Tracking und die Consent-Option und löst direkt ein Testereignis aus.
Das Plugin erkennt die folgenden Consent-Tools automatisch, ohne Einstellung: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Die PrestaShop- und Shopware-Module verwenden dieselbe Erkennung: was hier erkannt wird, wird überall erkannt.
Was das Plugin abdeckt
- Den gesamten Funnel: Navigation, Produktansicht, Warenkorb, Checkout, Kauf.
- Deduplizierung über die Bestellkennung: keine Doppelzählung zwischen Browser und Server.
- Automatische Wiederholungswarteschlange: Fehlgeschlagene Übertragungen werden erneut gesendet, Käufe zuerst (Details unten).
- Das Panel DataFirefly Activity im Admin zeigt die zuletzt gesendeten Ereignisse.
Überprüfen
- Das Testereignis muss im Monitoring Ihres Kundenbereichs als Delivered erscheinen.
- Geben Sie eine Testbestellung auf und finden Sie sie im Panel DataFirefly Activity wieder.
Wiederholungswarteschlange
Gilt ab Version 2.30.0.
- Eine fehlgeschlagene Übermittlung kommt in die Warteschlange und wird alle 5 Minuten per WP-Cron erneut gesendet.
- 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
- Nach jeder Konfigurationsänderung: Leeren Sie den Cache Ihrer Website. LiteSpeed Cache und Co. liefern sonst weiter das alte JavaScript aus.
- Wenn Sie eine Plugin-Version älter als 2.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