Fehlerbehebung

Die tatsächlichen Ursachen von Störungen, in der Reihenfolge, in der man ihnen begegnet. Beginnen Sie immer mit dem Button „Diagnose my connection“ auf der Seite Ihrer Website.

„Nichts kommt an“

Die drei Ursachen, in der Reihenfolge ihrer Wahrscheinlichkeit:

  1. Der Consent. Wenn die Option „Require consent“ aktiv ist und Ihre Website kein CMP-Banner hat, oder wenn der Besucher nicht eingewilligt hat, geht kein Ereignis raus: Das ist das erwartete Verhalten, keine Störung. Das untrügliche Indiz: Der Button Send test event funktioniert (er umgeht den Consent), aber sonst kommt nichts an.
  2. Die Website wurde nie aktiviert. Ziele nicht gespeichert, oder der Button „Activate my tracking“ wurde nie geklickt: Das Modul erhält 401-Antworten.
  3. Das Tracking ist im Modul deaktiviert. Auf PrestaShop und Shopware ist „Enable tracking“ standardmäßig OFF.

Die 401-Fehler

FehlerUrsache und Abhilfe
unknown_tenantWebsite wartet auf Aktivierung, oder falsche Site ID
invalid_signatureDer Body wurde zwischen Signatur und Versand erneut encodiert: Signieren Sie exakt die gesendeten Bytes
timestamp_out_of_windowTimestamp in Millisekunden statt Sekunden, oder Server-Uhr nicht synchronisiert (NTP)

Nach einer Rotation des HMAC-Schlüssels

Die Erfassung bleibt unterbrochen, bis der neue Schlüssel in das Modul eingefügt ist. Das ist gewollt: Die Rotation dient genau dazu, den alten Schlüssel ungültig zu machen.

Shopify

WordPress / WooCommerce

Leeren Sie nach jeder Konfigurationsänderung den Cache der Website: LiteSpeed Cache und andere Cache-Erweiterungen liefern sonst weiter das alte JavaScript aus.

GA4

„Delivered“, aber wenig Attribution

Ein zugestelltes Ereignis wird nicht zwangsläufig attribuiert: Die Attribution hängt von der Matching-Qualität ab. Reichern Sie die gesendeten Nutzerdaten an: E-Mail, Telefon, IP und User Agent, Cookies fbp und gclid. Die DataFirefly-Module übertragen sie automatisch, wenn sie verfügbar sind und der Consent es erlaubt.

Nachholfenster

Bevor DataFirefly ein Ereignis an eine Plattform sendet, prüft es dessen Alter. Die Regel gilt gleichermaßen für Live-Ereignisse, für Ereignisse, die ein Modul erneut sendet, und für Ereignisse, die nach einer Kontingentpause im kostenlosen Tarif freigegeben werden.

Ein Ereignis, das das Fenster eines Ziels überschritten hat, wird an dieses Ziel nicht gesendet. Der Inspector zeigt es als Not sent: too late an: Beim Senden war das Ereignis bereits älter als das Annahmefenster dieser Plattform.

Die Warteschlange des Moduls

Erreicht der Shop DataFirefly nicht, legt das Modul die Ereignisse in eine Warteschlange und sendet sie erneut (siehe die Anleitungen für PrestaShop, WooCommerce und Shopware). Die Seite Ihrer Website im Kundenbereich zeigt diese Warteschlange: wartende Ereignisse, Alter des ältesten, Zeitpunkt der letzten Meldung des Moduls.

ZustandBedeutung
Noch keine MeldungDas Modul hat noch nichts gemeldet. Versionen vor PrestaShop 1.29.0, WooCommerce 2.30.0 und Shopware 1.23.0 bleiben in diesem Zustand: Aktualisieren Sie, um die Warteschlange zu sehen.
OKNichts zu melden.
VerspätetDas älteste Ereignis wartet seit mehr als einer Stunde.
StummEs warteten Ereignisse, und das Modul hat seit 2 Stunden keine Meldung gesendet.

Braucht die Warteschlange Aufmerksamkeit, erhalten Sie eine E-Mail, höchstens eine alle 24 Stunden. Geraten viele Websites gleichzeitig in Verzug, liegt die Störung sehr wahrscheinlich bei DataFirefly: Die E-Mails an Kunden werden dann zurückgehalten, und nur unser Betriebsteam wird alarmiert.

Immer noch blockiert?

Schreiben Sie uns: [email protected], und fügen Sie das Ergebnis des Buttons „Diagnose my connection“ bei. Wir antworten innerhalb eines Werktags.

Aktualisiert: 1. September 2026