Was die Conversion API macht
Eine Conversion API (CAPI) sendet Conversion-Ereignisse direkt vom Storeep-Server an die Werbeplattform und umgeht dabei den Browser des Käufers. Da sie serverseitig läuft, wird sie nicht von Adblockern, Browsereinstellungen zum Datenschutz oder iOS-Tracking-Einschränkungen beeinflusst und überträgt gehashte Kundendaten, um die Zuordnung für Smart Bidding und Lookalike Audiences zu verbessern. Informationen zu clientseitigen Pixeln findest du im zugehörigen Artikel Browser-Pixel.
Du kannst gleichzeitig ein Browser-Pixel und eine CAPI für dieselbe Plattform nutzen. Storeep versieht beide mit einer gemeinsamen Event-ID, die aus dem Ereignistyp und der Bestellnummer gebildet wird, sodass die Plattform sie zu einer einzigen Conversion zusammenfasst und nicht doppelt zählt.
Für welche Plattformen gibt es eine CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X und Google Ads bieten in Storeep keine serverseitige Conversion API an, sondern nur clientseitige.
Was gesendet wird
Bei jeder qualifizierten Bestellung sendet Storeep den Bestellwert und die Währung, die Produktpositionen sowie die Kundensignale: gehashte E-Mail, gehashte Telefonnummer, eine gehashte Kunden-ID (external_id), die IP-Adresse, den User Agent und für Facebook und Snapchat das gehashte Marktland. Außerdem werden alle in den Cookies des Käufers gefundenen Ad-Click-IDs weitergeleitet (Facebook _fbc und _fbp, TikTok ttclid, Snapchat ScCid), damit die Plattform die Conversion dem ursprünglichen Klick zuordnen kann.
Conversion-Ereignistypen
- Facebook: Nur Lead oder Purchase. Die Facebook CAPI sendet keine Add-to-Cart- oder Checkout-Ereignisse.
- TikTok: Lead, Purchase, Place an order oder Complete payment.
- Snapchat: Purchase oder Reserve.
Währung und Bestellungen mit Wert Null
Jedes Ereignis verwendet die Währung der jeweiligen Bestellung, sofern die Plattform dies unterstützt, andernfalls wird der Wert in USD umgerechnet. Die Facebook CAPI überspringt Bestellungen mit einem Gesamtwert von 0, da Meta Conversions ohne Wert ablehnt. Das entspricht dem Verhalten des Facebook-Browser-Pixels.
Abgebrochene Bestellungen (Gating)
Das ist das wichtigste Verhalten. Eine ganz neue Bestellung löst immer das Senden per CAPI aus. Eine abgebrochene Bestellung ist anders: Sie wird nur gesendet, wenn du die Umschaltung Abgebrochene Bestellungen für diesen CAPI-Eintrag aktivierst und nur in dem Moment, in dem sich der Bestellstatus von "abgebrochen" auf einen anderen Status ändert.
- Ist Abgebrochene Bestellungen deaktiviert, werden wiederhergestellte abgebrochene Bestellungen nie an die Plattform weitergeleitet.
- Ist sie aktiviert, wird das Ereignis ausgelöst, sobald die Bestellung den Status "abgebrochen" verlässt, egal ob du den Status manuell änderst oder die Automator-App dies automatisch erledigt.
- Wenn Automator nicht installiert ist, musst du den Status selbst ändern, damit das Ereignis ausgelöst wird.
- Die Umschaltung gilt pro Eintrag, sodass du das Tracking abgebrochener Bestellungen für eine Pixel-ID aktivieren und für eine andere deaktivieren kannst.
Eine CAPI und ihre Felder installieren
- Öffne Apps im linken Menü.
- Finde die gewünschte Conversion API-App und klicke auf Installieren, dann bestätige.
- Öffne die App erneut und klicke auf Neues Pixel hinzufügen, um einen Eintrag zu erstellen.
Jeder Eintrag hat diese Felder:
- Aktivieren: Ist dies eingeschaltet, werden Conversion-Ereignisse serverseitig gesendet. Standardmäßig aktiviert.
- Abgebrochene Bestellungen: Die oben beschriebene Umschaltung. Standardmäßig deaktiviert.
- Werbekonto-Name: Ein Label nur für deine eigene Übersicht.
- Pixel-ID: Deine Meta-, TikTok- oder Snapchat-Pixel-ID.
- Märkte: Die Store-Märkte, die dieser Eintrag abdeckt. Wähle einen oder mehrere aus.
- Conversion-Ereignistyp: Die oben aufgeführten Plattformoptionen.
- Zugriffstoken: Das Conversions API-Zugriffstoken, das du im Event Manager der Plattform generierst. Erforderlich.
- Testmodus aktivieren: Ist dies eingeschaltet, werden Ereignisse als Testereignisse gesendet.
- Testcode: Der Test-Event-Code der Plattform, zum Beispiel TEST_1234. Erforderlich, wenn der Testmodus aktiviert ist.
Testmodus
Mit aktiviertem Testmodus erscheinen Ereignisse in der Testansicht der Plattform, sodass du die Integration prüfen kannst, ohne Live-Daten zu beeinflussen. Testereignisse fließen nicht in das Bidding oder die Optimierung ein. Deaktiviere den Testmodus, bevor du Live-Kampagnen startest.
Wie Märkte eine CAPI eingrenzen
Ein CAPI-Eintrag wird nur für Bestellungen ausgelöst, die in den von dir ausgewählten Märkten getätigt wurden. Eine Bestellung in einem nicht ausgewählten Markt löst diesen Eintrag nicht aus. So kannst du für jedes Land eine eigene Pixel-ID und ein eigenes Zugriffstoken im selben Store nutzen.
Worauf du achten solltest
- Nutze dieselbe Pixel-ID für dein Browser-Pixel und deine CAPI, damit die Plattform beide Lieferungen zu einer Conversion zusammenfasst.
- Wenn Ereignisse nicht mehr im Event Manager der Plattform erscheinen, ist dein Zugriffstoken möglicherweise abgelaufen. Erstelle ein neues und aktualisiere den Eintrag.
- Jeder Eintrag ist unabhängig. Du kannst pro Plattform mehrere Einträge mit jeweils eigener Pixel-ID, Zugriffstoken, Märkten, Ereignistyp und Einstellung für abgebrochene Bestellungen anlegen.
- Denke daran, den Testmodus zu deaktivieren, bevor du live gehst, sonst werden echte Conversions nicht gezählt.