Integration · Shopsystem
Shopware 6
Shopware-App mit Storefront-Script und signierten Order-Webhooks.
So erreichen Events Shopware
Die Webhooks des Shops sind die verbindliche Quelle für Käufe und Erstattungen. Track prüft die Signatur, paart die Bestellung über die Bestellnummer mit dem Browser-Kauf und leitet erst dann weiter — Consent wird geerbt, nie angenommen.
- Browser — das Storefront-Script sendet Standard-Events mit Consent-Zustand und Click-IDs des Besuchers; der Kauf trägt die Bestellnummer für das Pairing.
- Server — die signierten Webhooks des Shops liefern bezahlte Bestellungen und Erstattungen mit Summen und Positionen; Track prüft jede Signatur, bevor ein Datensatz angenommen wird.
Was Track empfängt
Zwei sich ergänzende Pfade, im Ingest über die Bestellnummer gepaart.
- Bezahlte Bestellungen und Erstattungen aus den signierten Webhooks des Shops: Bestellnummer, Summen, Währung, Positionen und die Matching-Daten des Kunden — beim Ingest gehasht.
- Standard-Browser-Events aus dem Storefront (Ansicht, In den Warenkorb, Checkout, Kauf) mit Consent-Datensatz und erfassten Click-IDs des Besuchers.
- Die Bestellnummer auf beiden Pfaden, damit der verifizierte Shop-Datensatz den Browser-Kauf ohne Doppelzählung ersetzt.
Nie angenommen
- Marketing-Consent: Ein Shop-Webhook trägt keinen eigenen Consent. Ohne gepaarten Browser-Kauf bleibt der Datensatz operativ und erreicht nur Destinationen, die keinen Consent benötigen.
- Kundendaten im Klartext in Werbeplattformen — Matching-Daten werden vor dem Speichern gehasht.
- Unsignierte oder nicht prüfbare Webhooks — eine fehlgeschlagene Signaturprüfung wird protokolliert und verworfen.
Technische Fakten
- Pairing-Schlüssel
order_id— order id- Consent-Zweck
- Notwendig
- Umsetzungsstatus
- Umgesetzt · mit signierten, aufgezeichneten Webhook-Payloads getestet
- Anbieter-Dokumentation
- Track-Dokumentation
Was du brauchst
Öffentliche Kennungen kannst du im Chat oder Assistenten eingeben; Geheimnisse gehen über die sichere Zugangsdaten-Karte oder OAuth und werden verschlüsselt gespeichert.
Öffentliche Kennungen
- shop_domain
- Shop-Domain
- default_currency
- Fallback-Währung
- purchase_on
- Kaufzeitpunkt (bezahlt oder bestellt) (optional)
Zugangsdaten
- Webhook-Secret
webhook_secret— im verschlüsselten Tresor gespeichert
Consent
Shop-Webhooks tragen keinen eigenen Consent. Eine verifizierte Bestellung erbt den Consent-Datensatz des gepaarten Browser-Kaufs; ohne ihn wird sie als operativer Datensatz gespeichert und erreicht nie eine Werbeplattform.
Einrichtung in wenigen Schritten
Die detaillierten Prüfungen übernimmt der Assistent. Du siehst die Meilensteine, die eine Entscheidung von dir brauchen.
Shop verbinden
Shop-Domain und Fallback-Währung eingeben. Track erzeugt Webhook-URL und Secret — einmalig sichtbar.
Shop-Seite installieren
Pixel-Extension, Plugin oder App installieren und die Webhooks mit dem erzeugten Secret registrieren.
Mit Testbestellung prüfen
Der erste signierte Webhook schaltet die Verbindung auf verbunden; beobachtete Topics und letzter Webhook werden live angezeigt.
Aus Tracking Knowledge
Leitfäden vom Team, das diesen Connector baut.
Shopware 6 Tracking richtig implementieren: eine App mit signierten Webhooks, die bezahlte Transaktion als Kauf und das Storefront-Snippet
Wie sich die Track-Shopware-App registriert, welche Bestellereignisse auf purchase und refund abgebildet werden, wie die shopware-shop-signature verifiziert wird, warum der Transaktionsstatus „bezahlt“ die aufgegebene Bestellung schlägt und wo das Snippet im Theme hingehört.
Tutorial · 3 Min. Lesezeit
Fragen
Brauche ich den Browser-Kauf trotzdem?
Er ist optional, aber wertvoll: Er trägt Consent-Datensatz und Click-IDs des Besuchers, die der Server nicht kennen kann. Der verifizierte Shop-Datensatz ersetzt ihn bei Wert und Positionen.
Wird dieselbe Bestellung doppelt gezählt?
Nein. Browser-Kauf, Server-API und Shop-Webhook teilen die aus der Bestellnummer abgeleitete Event-ID, und der Conversion-Datensatz hält eine Zeile pro Bestellung.
Was passiert, wenn die Plattform einen Webhook erneut sendet?
Wiederholte Zustellungen erzeugen deterministische Event-IDs und laufen in den Dedup-Schutz auf Eventebene; nichts wird erneut gezählt.
Shopware verbinden
Mit dem geführten Assistenten einrichten oder den Chat-Assistenten machen lassen.