# Fehlerbehebung

> DataFirefly Server-Side Fehler beheben: nichts kommt an, 401-Fehler, verschwundener Shopify-Webhook, GA4-Duplikate, Unassigned-Conversions.

- Originalseite: https://server-side.datafirefly.com/de/docs/troubleshooting.html
- Sprache: de
- Aktualisiert am: 2026-09-01
- Herausgeber: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/de/

---

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

| Fehler | Ursache und Abhilfe |
| --- | --- |
| `unknown_tenant` | Website wartet auf Aktivierung, oder falsche Site ID |
| `invalid_signature` | Der Body wurde zwischen Signatur und Versand erneut encodiert: Signieren Sie exakt die gesendeten Bytes |
| `timestamp_out_of_window` | Timestamp 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

- **Verschwundener Webhook**: von Shopify nach rund 48 Stunden voller Fehlschläge gelöscht. Prüfen Sie die Site ID in der URL und legen Sie den Webhook neu an.
- **Doppelte Bestellungen**: Ein Webhook „Order creation“ existiert noch neben „Order payment“. Löschen Sie ihn.

## 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

- **Doppelte Käufe**: Aktualisieren Sie das Modul (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). GA4 dedupliziert nur `purchase`, und nur über die `transaction_id`: Aktuelle Versionen senden den Kauf nicht mehr aus dem Browser.
- **„Unassigned“-Conversions**: Die gesendeten Ereignisse tragen die Session-Kennung und den Referrer, wodurch die Conversions ihrem Kanal zugeordnet werden. Die bereits von GA4 erfasste Historie wird nicht neu klassifiziert: Die Zuordnung gilt für den künftigen Traffic.

## „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.

- **Meta, ChatGPT Ads (OpenAI) und Microsoft Advertising**: 7 Tage.
- **GA4**: keine Grenze auf unserer Seite. GA4 nimmt ältere Ereignisse an und versieht sie mit einem neuen Datum; das ist eine bewusste Entscheidung.
- **Google Ads, TikTok und Pinterest**: keine Grenze auf unserer Seite, die Plattform entscheidet.

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](https://server-side.datafirefly.com/de/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/de/docs/woocommerce.html) und [Shopware](https://server-side.datafirefly.com/de/docs/shopware.html)). Die Seite Ihrer Website im Kundenbereich zeigt diese Warteschlange: wartende Ereignisse, Alter des ältesten, Zeitpunkt der letzten Meldung des Moduls.

| Zustand | Bedeutung |
| --- | --- |
| Noch keine Meldung | Das 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. |
| OK | Nichts zu melden. |
| Verspätet | Das älteste Ereignis wartet seit mehr als einer Stunde. |
| Stumm | Es 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: [support@datafirefly.com](https://server-side.datafirefly.com/de/contact.html), und fügen Sie das Ergebnis des Buttons „Diagnose my connection“ bei. Wir antworten innerhalb eines Werktags.

Aktualisiert: 1. September 2026
