DataFirefly Server-Side — Vollständige Anleitung

DataFirefly Server-Side ist der kostenlose WooCommerce-Konnektor für den Dienst DataFirefly Server-Side Tracking. Das Plugin erfasst die Ereignisse Ihres Shops und signiert sie; der Dienst liefert sie serverseitig an Ihre Werbe- und Analyseplattformen aus. Diese Anleitung behandelt Installation, Verbindung, die Funktionsweise des Client-+-Server-Funnels, die Deduplizierung, den serverseitigen Kauf, das Einwilligungsmanagement, die Zuverlässigkeit und das Abo.

Voraussetzungen

• WordPress 5.8 oder höher
• WooCommerce 5.0 oder höher (HPOS-kompatibel — High-Performance Order Storage)
• PHP 7.4 oder höher
• Ein funktionierender WordPress-Cron (oder ein echter System-Cron) für die Wiederholungswarteschlange und den verzögerten Versand
• Ein DataFirefly-Server-Side-Abo, um Ihren Verbindungsschlüssel zu erhalten

Installation

1. Laden Sie datafirefly-serverside-2_0_1.zip aus Ihrem DataFirefly-Kundenbereich herunter.
2. Gehen Sie im WordPress-Backend zu Plugins → Installieren → Plugin hochladen, wählen Sie die ZIP-Datei und klicken Sie auf Jetzt installieren.
3. Aktivieren Sie das Plugin. Ein neues Menü DataFirefly Server-Side erscheint in der Verwaltung.

Verbindung mit einem Schlüssel

Das Plugin wird mit einem einzigen Verbindungsschlüssel konfiguriert, der Client- und Server-Tracking gleichzeitig aktiviert.

1. Kopieren Sie aus Ihrem DataFirefly-Kundenbereich den Verbindungsschlüssel (er beginnt mit dfss_).
2. Fügen Sie ihn in das dafür vorgesehene Feld auf dem Verbindungs-Bildschirm des Plugins ein.
3. Klicken Sie auf Verbinden. Das Plugin aktiviert Client- und Server-Tracking, sendet ein Testereignis an den Dispatcher und richtet die Client-Tags für die konfigurierten Ziele ein.
4. Prüfen Sie, ob der Status auf Verbunden ✓ wechselt, und nutzen Sie die Schaltfläche Ereignis testen, um die Zustellung zu bestätigen.

Erweiterter Modus (manuelle Eingabe)

Wenn Sie den einzelnen Schlüssel nicht verwenden möchten, erlaubt der erweiterte Modus die manuelle Eingabe von Tenant, Secret und Endpoint. Behalten Sie ihn für besondere Konfigurationen: der Ein-Schlüssel-Modus deckt nahezu alle Fälle ab.

Vollständiger Client-+-Server-Funnel

Das Plugin verfolgt den gesamten Funnel im Browser, während die Kauf-Conversion vom Server ausgeht.

• Im Browser: page_view, view_content (Produktansicht), add_to_cart, initiate_checkout und add_payment_info.
• Auf dem Server: purchase, ausgelöst von den WooCommerce-Bestell-Hooks.

Beide Ebenen teilen dieselbe Ereigniskennung, um die Deduplizierung zu ermöglichen.

Deduplizierung per event_id

Für jede Bestellung tragen das Client-Ereignis und das Server-Ereignis dieselbe event_id, gebunden an die Bestell-ID (zum Beispiel order_1042). Meta, GA4 und die anderen Plattformen nutzen sie, um jede Conversion nur einmal zu zählen. So gewinnen Sie die Conversions zurück, die der Browser entwischen lässt, ohne Doppelzählung.

Serverseitiger Kauf: zuverlässig und nicht fälschbar

Die Kauf-Conversion wird von den WooCommerce-Bestell-Hooks ausgelöst (Zahlung abgeschlossen, in Bearbeitung, abgeschlossen), idempotent: eine Sperre (_dfss_sent) stellt sicher, dass derselbe Kauf nie zweimal gesendet wird, selbst wenn mehrere Hooks feuern.

• Da das Ereignis vom Server kommt, kann kein Ad-Blocker und kein ITP es verhindern.
• Umgekehrt schließt der öffentliche Erfassungs-Endpoint (Beacon) das purchase-Ereignis bewusst aus: niemand kann einen falschen Kauf aus dem Browser einschleusen, um Ihren Meta- oder GA4-Umsatz aufzublähen.
• Der Ereigniskontext (Wert, Währung, Produkte) ist auf dem Server autoritativ: der Browser rät nichts.

Einwilligungsmanagement

Das Einwilligungs-Gate ist standardmäßig aktiv: nichts wird gesendet, bis die Marketing-Einwilligung erteilt ist.

Native Kompatibilität mit Cookie Consent v2

Das Plugin erkennt nativ das Modul DataFirefly Cookie Consent — DSGVO & Google Consent Mode v2 und liest dessen Einwilligungs-Cookie (dfcc_consent) direkt auf dem Server. Wird die Kategorie Marketing abgelehnt, wird das Ereignis verworfen, was auch immer der Browser behauptet. Das ist die empfohlene Kombination: Banner, Consent Mode v2 und serverseitiges Tracking sprechen dieselbe Sprache.

Andere Einwilligungslösungen

Ohne Cookie Consent v2 unterstützt das Plugin auch WP Consent API, Complianz, Cookiebot und IAB TCF v2. Sie können Ihr aktuelles Banner behalten und das Tracking daran koppeln.

Zuverlässigkeit: Wiederholungswarteschlange und Aktivitätsprotokoll

Ein Ereignis, das nicht zugestellt werden konnte, ist nicht verloren: es wird in die Warteschlange gestellt und alle 5 Minuten von einem Cron automatisch erneut zugestellt.

Das Aktivitätsprotokoll zeigt in Echtzeit und ohne Fachjargon, was zugestellt wurde, was in der Warteschlange ist und was abgelehnt wurde, mit HTTP-Code und Anzahl der Versuche. Es ist Ihr erster Diagnoseschritt.

Sicherheit

• Kein Secret im Browser: nur öffentliche Kennungen (Pixel, Measurement-ID) werden clientseitig offengelegt.
• Das Signatur-Secret und Ihre Ziel-Zugangsdaten bleiben auf dem Server.
• Jedes Ereignis wird per HMAC signiert, bevor es den Dispatcher erreicht, der in der EU (Deutschland) gehostet wird.

Abo des Dienstes DataFirefly Server-Side

Das Plugin erfasst und signiert; der Dienst DataFirefly Server-Side Tracking nimmt auf und liefert serverseitig an fünf Ziele aus: Meta CAPI, GA4 (Measurement Protocol), TikTok Events API, Pinterest Conversions API und Google Ads. Der Dispatcher wird in Deutschland gehostet, die Ingestion ist HMAC-signiert, personenbezogene Daten werden maskiert und das Auslösen respektiert die Einwilligung. Eine Integration, eine konsolidierte Rechnung, mehrere Sites möglich.

Entdecken Sie die Tarife und abonnieren Sie auf server-side.datafirefly.com:

• Starter — 39 €/Monat: 1 Site, bis zu 500 K Ereignisse
• Growth — 119 €/Monat: 5 Sites, bis zu 2 M Ereignisse
• Scale — 349 €/Monat: 20 Sites, bis zu 10 M Ereignisse

Fehlerbehebung

Der Status bleibt auf „Nicht verbunden“

Prüfen Sie, ob der Schlüssel mit dfss_ beginnt und vollständig kopiert wurde. Ein Schlüssel, der auf eine andere Domain als datafirefly.com (HTTPS) zeigt, wird abgelehnt. Versuchen Sie die Schaltfläche Ereignis testen erneut.

Der Kauf wird nicht erfasst

Der Kauf geht von den Bestell-Hooks aus: stellen Sie sicher, dass die Bestellung einen Zahlungsstatus erreicht (abgeschlossen / in Bearbeitung / fertig). Prüfen Sie im Aktivitätsprotokoll, ob das Ereignis in der Warteschlange oder abgelehnt ist, und prüfen Sie den Cron, wenn sich Ereignisse stauen.

Conversions doppelt gezählt

Prüfen Sie, ob kein anderes Tracking-Plugin bereits einen konkurrierenden purchase ohne gemeinsame event_id sendet. Mit DataFirefly Server-Side allein garantiert die bestellbasierte event_id die Deduplizierung.

Nichts wird gesendet, obwohl die Einwilligung erteilt scheint

Das Gate ist standardmäßig aktiv. Prüfen Sie, ob die Kategorie Marketing in Ihrer Einwilligungslösung tatsächlich akzeptiert ist und ob diese Lösung erkannt wird (Cookie Consent v2, WP Consent API, Complianz, Cookiebot oder IAB TCF v2).