Shopify verbinden

Kein Modul zu installieren: Shopify überträgt Bestellungen über signierte Webhooks, und das DataFirefly-Pixel deckt die Navigation ab.

1. Den Bestell-Webhook anlegen

  1. Shopify-Admin: Einstellungen > Benachrichtigungen, dann Webhooks.
  2. 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 Sie IHRE-SITE-ID durch die exakte Site ID von der Seite Ihrer Website ersetzen.
  3. 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

  1. Unten auf der Webhooks-Seite zeigt Shopify das Signing Secret an: Kopieren Sie es.
  2. 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

  1. Shopify-Admin: Einstellungen > Kundenereignisse, dann ein benutzerdefiniertes Pixel hinzufügen.
  2. Fügen Sie das Snippet aus dem Shopify-Leitfaden Ihres Kundenbereichs ein (Seite Modules).
  3. 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

  1. Geben Sie eine bezahlte Testbestellung auf: Sie muss im Monitoring als Delivered erscheinen.
  2. Der Button „Diagnose my connection“ bestätigt den Empfang der letzten Ereignisse.

Wenn etwas nicht funktioniert

Aktualisiert: 1. September 2026