Was ist die Pinterest Conversions API?
Mit der Pinterest Conversions API sendest du Conversions über eine Server-to-Server-Verbindung direkt an Pinterest, zusätzlich zu den Events, die das Pinterest-Tag aus dem Browser des Käufers sendet.
Mit WeProfit erreicht ein Shopify-Kauf Pinterest als checkout, das Event von Pinterest für eine abgeschlossene Transaktion, gesendet von den Servern von WeProfit an das Werbekonto, das du verbindest. Für den Beginn des Checkouts hat Pinterest ein eigenes Event, initiate_checkout. Halte die beiden also auseinander, wenn du deine Berichte liest.
Pinterest ist in jedem Tarif von WeProfit enthalten, zusammen mit Meta, Google, TikTok, Snapchat, X Ads, Microsoft (Pilotprogramm), Reddit, LinkedIn und Taboola.
Verbinde Pinterest in WeProfit
Verbinde zuerst deinen Shopify-Shop. Für die Übermittlung an Pinterest brauchst du zwei Angaben: deine Pinterest-Werbekonto-ID und ein Conversion-Zugriffstoken. WeProfit fragt nicht nach einer ID für das Pinterest-Tag, und das Formular für Pinterest hat kein Feld für einen Test-Event-Code.
- Öffne im Pinterest Ads Manager „Conversions“, dann „Conversions API“, und wähle „Set up API“. Wähle „Conversion access token“, klicke auf „Generate new token“ und kopiere das Token.
- Kopiere deine Werbekonto-ID: die Zahl in der URL des Pinterest Ads Manager. Pinterest zeigt sie auch neben einem neu generierten Token an.
- Öffne in WeProfit „Werbenetzwerke > Pinterest“ und klicke auf „Ziel hinzufügen“. Gib die Werbekonto-ID und das Conversion-Zugriffstoken ein. Eine Bezeichnung ist optional und hilft, wenn du mehr als ein Werbekonto 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 Werbekonto erhält. Klicke dann auf „Pinterest verbinden“.
- Klicke auf „Test senden“. WeProfit sendet ein Test-Event mit dem Test-Flag von Pinterest und zeigt dir, ob Pinterest es angenommen hat. Pinterest legt Test-Events in einer Sandbox ab und verarbeitet sie nicht für Berichte oder Optimierung; Events aus dem Live-Betrieb tragen das Flag nie.
Käufe und Checkout-Events, die an Pinterest gehen
Aus einem Shopify-Shop sendet WeProfit deine Käufe an Pinterest 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 Werbekonto.
WeProfit sendet ein Event nur dann an Pinterest, wenn es eine gehashte E-Mail-Adresse oder sowohl eine IP-Adresse als auch einen User-Agent enthält, das Minimum, das die API von Pinterest für ein Web-Event verlangt. Events ohne diese Angaben überspringt WeProfit, und ein übersprungenes Event bekommt keine Zeile im Übermittlungsprotokoll. Rückerstattungen werden nicht an Pinterest gesendet, und nichts zieht einen Kauf zurück, den Pinterest 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, Preisen und Mengen, die Anzahl der Artikel und die Shopify-Bestell-ID. Prüfe im Pinterest Ads Manager, welche Events dein Werbekonto erhält.
| Shop-Event | Pinterest-Event |
|---|---|
| Checkout started | initiate_checkout |
| Payment information added | add_payment_info |
| Purchase | checkout |
Kundendaten, die mit jedem Kauf gesendet werden
Damit Pinterest einen Kauf einem Pinterest-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 Pinterest. Wenn WeProfit sie hat, sendet es außerdem die Pinterest-Klick-ID epik und eine externe ID, einen SHA-256-Hash der Besucher-ID von WeProfit.
Pinterest hängt epik an die URL eines Besuchs aus deiner Anzeige an, und das Pinterest-Tag speichert die ID im Cookie _epik. WeProfit liest beides aus, lädt das Pinterest-Tag aber nicht. Das Cookie gibt es daher nur, wenn dein Shop dieses Tag ausführt.
Pinterest-Tag und Conversions API: doppelte Zählung vermeiden
Pinterest entfernt ein Duplikat, wenn die eventID des Browser-Events, das das Pinterest-Tag sendet, der event_id des Server-Events entspricht. Pinterest behält das erste Event, das ankommt, und entfernt Duplikate innerhalb von 48 Stunden.
WeProfit lädt das Pinterest-Tag nicht. Es sendet die Events für Pinterest 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 Werbekonto, und ein Wiederholungsversuch verwendet dieselbe ID.
Meldet auch das Pinterest-Tag Käufe für dasselbe Werbekonto, ob eine App es hinzugefügt hat oder ob es im Code deines Themes steckt, verwendet es eigene Event-IDs. Sie stimmen nicht mit denen von WeProfit überein, daher kann Pinterest die beiden Kopien nicht zuordnen und zählt die Bestellung womöglich doppelt. Behalte pro Werbekonto nur einen Sender für Käufe und vergleiche dann einen Testkauf im Pinterest Ads Manager mit dem Übermittlungsprotokoll von WeProfit.
Prüfe die Übermittlung im CAPI-Übermittlungsprotokoll
Öffne in WeProfit „Werbenetzwerke > Pinterest“ und scrolle zum „CAPI-Übermittlungsprotokoll“. Es listet jedes serverseitige Event, das an Pinterest 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 die checkout-Events von Pinterest.
Das Protokoll zeigt die eigene Event-ID von WeProfit, etwa pur_6012345678901; Pinterest 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 Pinterest das Event angenommen hat, nicht, dass es die Bestellung einer Anzeige zugeschrieben hat. Lehnt Pinterest das Zugriffstoken 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 | Pinterest 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: Pinterest 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. |
Kampagnendetails aus deinen Pinterest-Anzeigen
WeProfit ordnet einen Besuch „Pinterest Ads“ zu, wenn er die Klick-ID epik von Pinterest enthält oder utm_source=pinterest mit einem bezahlten Medium. Mit den automatischen URL-Parametern von Pinterest liest WeProfit außerdem die IDs von Kampagne und Anzeigengruppe.
Für die Anzeigen-ID und lesbare Namen fügst du die Pinterest-URL-Vorlage von WeProfit einmal für das ganze Werbekonto hinzu: Öffne im Business Manager „Ad accounts“, wähle dein Konto aus, öffne den Tab „Settings“, bearbeite „Parameter settings“ so, dass sie die Parameter der Vorlage von WeProfit enthalten, und klicke auf „Save and apply“. Solange „Apply URL parameters automatically to all current and future campaigns“ angehakt ist, fügt Pinterest sie an die Ziel-URLs deiner Anzeigen an; UTM-Parameter, die eine URL bereits enthält, überschreibt Pinterest nicht. 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. Pinterest schreibt Conversions nach seinen eigenen Attributionseinstellungen zu, daher können die Zahlen von Pinterest und von WeProfit für dieselben Bestellungen abweichen.
utm_source=pinterest&utm_medium=paid&utm_campaign={campaignname}&utm_term={adgroupname}&utm_content={adid}&wpcid={campaignid}&wpasid={adgroupid}&wpadid={adid}