Was ist die Snapchat Conversions API?
Mit der Conversions API von Snap übergibt ein Server Web-Conversion-Events über eine Server-to-Server-Integration direkt an Snapchat, zusätzlich zu den Events, die das Snap-Pixel aus dem Browser des Käufers sendet. Snap empfiehlt Werbetreibenden im Web, sie zusammen mit dem Pixel zu nutzen.
Mit WeProfit erreicht ein Shopify-Kauf Snapchat als PURCHASE, gesendet von den Servern von WeProfit an das Snap-Pixel, das du verbindest. Snapchat ist in jedem Tarif von WeProfit enthalten, zusammen mit Meta, Google, TikTok, Pinterest, X Ads, Microsoft (Pilotprogramm), Reddit, LinkedIn und Taboola.
Verbinde Snapchat in WeProfit
Verbinde zuerst deinen Shopify-Shop. Für die Übermittlung an Snapchat brauchst du zwei Angaben: deine Snap-Pixel-ID und ein Token für die Conversions API. Nur ein „Organization Admin“ deines Unternehmens bei Snapchat kann dieses Token erstellen.
- Öffne im Snap Ads Manager das Menü oben links, wähle „Events Manager“ und klicke auf dein Pixel. Kopiere die Pixel-ID, die oben angezeigt wird: ein langer Code mit Bindestrichen.
- Um das Token zu erstellen, öffne das Menü im Ads Manager und wähle „Business Details“. Geh zu „Conversions API Tokens“, wähle „Generate Token“ und kopiere das Token.
- Verwende dieses Token für die Conversions API. Das Zugriffstoken, das im „Event Source Setup“ des Events Manager angezeigt wird, ist ein anderer Token-Typ und funktioniert für diese Verbindung nicht.
- Öffne in WeProfit „Werbenetzwerke > Snapchat“ und klicke auf „Ziel hinzufügen“. Gib die Snap-Pixel-ID und das Token für die Conversions API ein. Eine Bezeichnung ist optional und hilft, wenn du mehr als ein Pixel verbindest.
- Lass „Bedingungen“ leer, um jedes infrage kommende Event zu senden, oder füge Bedingungen wie Land, Event, Bestellwert oder Kampagne hinzu, um einzuschränken, was dieses Pixel erhält. Klicke dann auf „Snapchat verbinden“.
- Klicke auf „Test senden“. WeProfit sendet ein Test-Event an den Validierungs-Endpunkt von Snap, der prüft, ob ein Event korrekt aufgebaut ist, und zeigt dir, ob Snap es angenommen hat. Das Ziel für Snapchat in WeProfit hat keinen Test-Event-Code, daher gibt es keinen Testmodus für Events aus dem Live-Betrieb.
Käufe und Checkout-Events, die an Snapchat gehen
Aus einem Shopify-Shop sendet WeProfit deine Käufe an Snapchat und zwei Checkout-Schritte, die sein Web-Pixel erfasst: den Beginn des Checkouts und das Hinzufügen der Zahlungsinformationen. Käufe kommen aus dem Bestell-Webhook von Shopify, und der Kauf jeder Bestellung geht höchstens einmal an jedes verbundene Pixel.
WeProfit sendet ein Event nur dann an Snapchat, wenn es mindestens einen der Abgleichsschlüssel enthält, die Snap verlangt: eine gehashte E-Mail-Adresse, eine gehashte Telefonnummer oder sowohl eine IP-Adresse als auch einen User-Agent. Ein PURCHASE geht nur mit Wert und Währung hinaus. Events, denen diese Angaben fehlen, überspringt WeProfit, und ein übersprungenes Event bekommt keine Zeile im Übermittlungsprotokoll.
Die Liste der Standard-Events von Snap enthält kein Lead-Event, daher überspringt WeProfit Leads für Snapchat, statt sie unter einem anderen Namen zu senden. Eigene Events und Rückerstattungen werden nicht an Snapchat gesendet, und nichts zieht einen Kauf zurück, den Snapchat bereits erhalten hat.
Jeder Kauf enthält den Gesamtbetrag der Bestellung, wie Shopify ihn meldet, in der Währung der Bestellung, die Produkte mit ihren IDs, Mengen und Preisen, die Anzahl der Artikel und die Shopify-Bestell-ID als order_id.
| Shop-Event | Snapchat-Event |
|---|---|
| Checkout started | START_CHECKOUT |
| Payment information added | ADD_BILLING |
| Purchase | PURCHASE |
Kundendaten, die mit jedem Kauf gesendet werden
Damit Snapchat einen Kauf einem Snapchat-Nutzer zuordnen kann, sendet WeProfit Angaben aus der Shopify-Bestellung, gehasht mit SHA-256: die E-Mail-Adresse und die Telefonnummer des Käufers sowie Vor- und Nachname, Stadt, Bundesland, Postleitzahl und Land aus der Lieferadresse, ersatzweise aus der Rechnungsadresse. IP-Adresse und User-Agent gehen ungehasht an Snapchat. Wenn WeProfit sie hat, sendet es außerdem eine externe ID, einen SHA-256-Hash der Besucher-ID von WeProfit.
Wenn WeProfit sie hat, enthält der Kauf außerdem die Klick-ID und das Cookie von Snapchat: den Wert ScCid, den Snapchat an die URL deiner Landingpage anhängt, wenn jemand auf deine Anzeige klickt, gesendet als sc_click_id, und das Cookie _scid des Snap-Pixels, gesendet als sc_cookie1. WeProfit lädt das Snap-Pixel nicht, daher gibt es das Cookie _scid nur, wenn dein Shop das Pixel ausführt.
Snap-Pixel und Conversions API: doppelte Zählung vermeiden
Snap ordnet ein Event des Snap-Pixels einem Event der Conversions API für dieselbe Pixel-ID zu, wenn die client_dedup_id des Pixels der event_id des Servers entspricht und die Event-Namen übereinstimmen, innerhalb von 48 Stunden. Bei PURCHASE-Events kann Snap außerdem die transaction_id des Pixels mit der order_id des Server-Events abgleichen, bis zu 30 Tage lang.
WeProfit lädt das Snap-Pixel nicht. Es sendet die Events für Snapchat nur von seinem Server, jedes mit einer eigenen Event-ID. Ein Kauf geht als pur_ mit einem Shop-Code und der Shopify-Bestell-ID hinaus, etwa pur_a1b2c3d4-6012345678901, einmal pro Bestellung und Pixel, und ein Wiederholungsversuch verwendet dieselbe ID. Seine order_id ist die numerische ID der Shopify-Bestellung, etwa 6012345678901, nicht die Bestellnummer, die deine Kunden sehen.
Meldet auch ein Snap-Pixel Käufe für dieselbe Pixel-ID, etwa über eine App oder den Code deines Themes, stimmen seine Event-IDs nicht mit denen von WeProfit überein. Snap greift dann auf die Bestell-ID zurück: Die beiden Kopien lassen sich nur zuordnen, wenn das Pixel dieselbe Shopify-Bestell-ID als transaction_id meldet. Prüfe, wie dein Pixel Käufe meldet, behalte pro Snap-Pixel nur einen Sender für Käufe, solange du nicht bestätigt hast, dass die IDs übereinstimmen, und vergleiche einen Testkauf im Snapchat Ads Manager mit dem Übermittlungsprotokoll von WeProfit.
Prüfe die Übermittlung im CAPI-Übermittlungsprotokoll
Öffne in WeProfit „Werbenetzwerke > Snapchat“ und scrolle zum „CAPI-Übermittlungsprotokoll“. Es listet jedes serverseitige Event, das an Snapchat gesendet wurde, mit den Spalten „Erstellt“, „Event“, „Ziel“, „Event-ID“, „Status“, „Versuche“ und „Fehler“, und du kannst nach Ziel, Event und Status filtern. Der Filter für Purchase findet auch PURCHASE-Events.
Das Protokoll zeigt die eigene Event-ID von WeProfit, etwa pur_6012345678901; Snapchat erhält sie mit dem Shop-Code, etwa pur_a1b2c3d4-6012345678901. Das Protokoll hat keine Spalte für den Wert, also prüfe den Wert eines Kaufs auf der Seite „Events“ in WeProfit. Die Seite „Bestellungen“ zeigt in der Spalte „Netzwerke“ die Übermittlung jeder Bestellung an jedes verbundene Netzwerk.
Der Status „gesendet“ bedeutet, dass Snapchat das Event angenommen hat, nicht, dass es die Bestellung einer Anzeige zugeschrieben hat. Lehnt Snapchat das Token ab, pausiert WeProfit die Verbindung und zeigt ein Banner; ein neues Token oder ein erfolgreicher Test mit „Test senden“ schaltet sie wieder ein.
| Status | Bedeutung |
|---|---|
| ausstehend | In der Warteschlange und noch nicht gesendet. |
| gesendet | Snapchat hat das Event angenommen. |
| fehlgeschlagen | Ein vorübergehendes Problem. WeProfit versucht es einige Stunden lang automatisch erneut, mit derselben Event-ID. |
| aufgegeben | WeProfit hat aufgegeben: Snapchat hat das Event abgelehnt, mit seiner Meldung in der Spalte „Fehler“, oder die Versuche sind aufgebraucht. |
| übersprungen (deaktiviert) | Das Ziel war ausgeschaltet oder pausiert, als das Event an der Reihe war. Events, die übersprungen werden, während es ausgeschaltet ist, werden später nicht nachgesendet. |
| übersprungen (vor Installation) | Der Kauf aus einer Bestellung, die vor der Installation von WeProfit aufgegeben wurde. Er wird nie gesendet. |
Snapchat-Werbeausgaben: von Hand eingetragen, nicht synchronisiert
WeProfit hat keine Verbindung zu Snapchat-Werbekonten, daher werden Snapchat-Ausgaben nicht automatisch synchronisiert. Trag sie auf eine von drei Arten ein: als manuelle Einträge unter „Gewinn > Werbeausgaben > Manuelle Einträge“, mit Datum, Betrag, Netzwerk, optionaler Kampagnen-ID und optionaler Notiz; als täglichen Zeitplan, der jeden Tag denselben Betrag bucht, bis du ihn änderst; oder über die Entwickler-API.
Gib bei einem Eintrag die Kampagnen-ID an, wenn du den Gewinn pro Snapchat-Kampagne sehen willst: Unter „Attribution“ werden Ausgaben über Kampagnen-ID oder Kampagnennamen den attribuierten Bestellungen zugeordnet, und Ausgaben ohne Kampagne zählen auf Kanalebene. Snapchat-Kampagnen erscheinen unter „Attribution“ meist mit ihren IDs, weil es keine Verbindung zu einem Snapchat-Werbekonto gibt, über die sich Namen nachschlagen ließen. Ein manueller Eintrag für einen Tag hat Vorrang vor einem täglichen Zeitplan.
Kampagnendetails aus deinen Snapchat-Anzeigen
WeProfit ordnet einen Besuch „Snapchat Ads“ zu, wenn er die Klick-ID ScCid von Snapchat enthält oder utm_source=snapchat mit einem bezahlten Medium. Mit den „Auto-UTMs“ von Snap liest WeProfit außerdem die Kampagnen-ID und, falls vorhanden, die Anzeigen-ID. Für die Anzeigengruppe hängst du die Snapchat-URL-Vorlage von WeProfit an jede Anzeige an, nach dem Fragezeichen in der Website-URL des Creatives.
Bei den Makros zählt die Groß- und Kleinschreibung: Schreib {{adSet.id}}, nicht {{adset.id}}. Vorlagen gelten nur für neue Klicks. In der eigenen Attribution von WeProfit zählt ein Anzeigenklick 30 Tage lang, und der letzte Klick gewinnt: Das funktioniert wie Last Click mit einem Rückblickzeitraum von 30 Tagen für Anzeigenklicks. Snapchat schreibt Conversions nach seinen eigenen Attributionseinstellungen zu, daher können die Zahlen von Snapchat und von WeProfit für dieselben Bestellungen abweichen.
utm_source=snapchat&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_term={{adSet.name}}&utm_content={{creative.name}}&wpcid={{campaign.id}}&wpasid={{adSet.id}}&wpadid={{ad.id}}