1. Den Bestell-Webhook anlegen
- Shopify-Admin: Einstellungen > Benachrichtigungen, dann Webhooks.
- Klicken Sie auf Webhook erstellen, wählen Sie das Event Order payment und das Format JSON, mit dem Ziel:
https://serverside.datafirefly.com/v1/shopify/IHRE-SITE-ID
wobei SieIHRE-SITE-IDdurch die exakte Site ID von der Seite Ihrer Website ersetzen. - Empfohlen: Fügen Sie auch Refund creation hinzu, damit Erstattungen ankommen. Checkout creation und Cart creation sind nur nützlich, solange das DataFirefly-Pixel noch nicht eingerichtet ist.
Wählen Sie unbedingt Order payment, niemals Order creation: Letzterer wird auch bei unbezahlten Bestellungen ausgelöst und führt zu Doppelzählungen.
2. Das Signing Secret einfügen
- Unten auf der Webhooks-Seite zeigt Shopify das Signing Secret an: Kopieren Sie es.
- Fügen Sie es in das Feld „Shopify webhook signing secret“ auf der Seite Ihrer DataFirefly-Website ein, dann speichern Sie.
3. Das DataFirefly-Pixel einrichten
- Shopify-Admin: Einstellungen > Kundenereignisse, dann ein benutzerdefiniertes Pixel hinzufügen.
- Fügen Sie das Snippet aus dem Shopify-Leitfaden Ihres Kundenbereichs ein (Seite Modules).
- Sobald das Pixel aktiv ist, löschen Sie die Webhooks Checkout creation und Cart creation: Das Pixel ersetzt sie.
ChatGPT Ads
Der Kauf wird über den signierten Order payment-Webhook vom Server gesendet. Die Referenz des Anzeigenklicks (oppref und obref) erfasst das DataFirefly-Pixel aus Schritt 3, das im Shopify-Admin (Einstellungen > Kundenereignisse) und nicht im Theme eingefügt wird: Es verknüpft die Referenz mit dem Checkout, und der Server ordnet sie dem Kauf zu. Sie wird nur mit Marketing-Einwilligung erfasst.
Wenn Sie zusätzlich ein eigenes OpenAI-Pixel betreiben, ersetzen Sie dessen Kaufaufruf durch den Code aus dem Shopify-Leitfaden Ihres Kundenbereichs, damit der Kauf im Browser dieselbe Event-ID trägt wie der Server-Kauf (shopify-order- gefolgt von der Bestellnummer). Andernfalls deaktivieren Sie das Kauf-Event Ihres eigenen OpenAI-Pixels.
Einwilligung
Das DataFirefly-Pixel richtet sich nach der in Shopify erfassten Marketing-Einwilligung. Lehnt ein Besucher Marketing ab, sendet das Pixel die Events dieses Besuchers als abgelehnt markiert und ohne Referenz auf einen Anzeigenklick an DataFirefly, und nichts davon wird an die Werbeplattformen weitergeleitet. Bestellungen gehen dagegen über signierte Webhooks ein, die kein Einwilligungssignal übermitteln: Für sie gilt die Einwilligungsrichtlinie Ihres Shops.
Überprüfen
- Geben Sie eine bezahlte Testbestellung auf: Sie muss im Monitoring als Delivered erscheinen.
- Der Button „Diagnose my connection“ bestätigt den Empfang der letzten Ereignisse.
Wenn etwas nicht funktioniert
- Ein Webhook, der rund 48 Stunden lang fehlschlägt, wird von Shopify automatisch gelöscht. Ist der Webhook verschwunden, prüfen Sie die Site ID in der URL, legen Sie ihn neu an und beobachten Sie das Monitoring.
- Doppelte Bestellungen? Stellen Sie sicher, dass kein Webhook Order creation übrig geblieben ist.
- Die weiteren häufigen Ursachen finden Sie im Leitfaden zur Fehlerbehebung.
Aktualisiert: 1. September 2026