Voraussetzungen
- Shopware 6.5, 6.6 oder 6.7.
- Die Zip-Datei des Plugins, herunterzuladen auf der Seite Modules Ihres Kundenbereichs.
- Der Verbindungsschlüssel Ihrer Website.
Installation
- Shopware-Admin: Extensions > My extensions > Upload extension, dann installieren und aktivieren Sie das Plugin.
- Oder per CLI:
bin/console plugin:install --activate DatafireflyServerSide
Konfiguration
- Öffnen Sie die Plugin-Konfiguration und fügen Sie den Verbindungsschlüssel
dfss_...ein. - Aktivieren Sie Enable tracking.
Das Modul erkennt die gängigen Consent-Tools selbst (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), im Browser wie auf dem Server, dieselbe Liste wie bei den WooCommerce- und PrestaShop-Modulen. Lassen Sie Consent cookie name leer für diese automatische Erkennung; füllen Sie es nur aus, um ein bestimmtes Cookie zu erzwingen (zum Beispiel CookieConsent und marketing:true), das dann Vorrang hat.
Überprüfen
- Führen Sie
bin/console datafirefly:serverside:testaus. - Das Testereignis muss im Monitoring Ihres Kundenbereichs als Delivered erscheinen.
Wiederholungswarteschlange
Gilt ab Version 1.23.0.
- Eine fehlgeschlagene Übermittlung kommt in die Warteschlange und wird alle 5 Minuten von einer geplanten Aufgabe (Scheduled Task) von Shopware 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
- Logs in
var/log/, Präfix[DataFirefly SS]. - Wenn Sie eine Plugin-Version älter als 1.9.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