Übersicht

Die Pinterest-API für Conversions ermöglicht es Werbetreibenden, Conversions direkt über eine Server-to-Server-Verbindung an Pinterest zu senden. Mit der Pinterest-API erfasste Conversions können dann zum Retargeting in Kampagnen verwendet und anhand von Conversion-Berichten überprüft werden, um die Sichtbarkeit von Conversions zu verbessern.

Über die Pinterest-API für Conversions können Werbetreibende Folgendes senden:

Web-Conversions

In-App-Conversions

Offline-Conversions

Events können in Echtzeit oder innerhalb einer Stunde nach Auftreten des Events empfangen und erfasst werden. Events, die außerhalb dieses Zeitfensters oder als Teil eines verzögerten Batch-Events empfangen wurden, werden als Offline-Conversions gezählt. 

Die gemeinsame Verwendung der Pinterest-API für Conversions und des Pinterest-Tags kann dazu beitragen, die Sichtbarkeit erfasster Conversions zu maximieren. Unsere Best Practice besteht darin, beide Lösungen zur Conversion-Erfassung zu verwenden, um sicherzustellen, dass du einen umfassenden Überblick über die Performance deiner Conversion-Kampagnen erhältst.

Die Pinterest-API

Die Pinterest-API für Conversions ist eines von mehreren Produkten, die Teil unseres Pinterest-API-Ökosystems sind. Jeder mit einem Pinterest Business-Konto kann die Pinterest-API für Conversions verwenden, was jedoch nicht automatisch den Zugang zur allgemeinen Pinterest-API-Funktionalität bedeutet. 

Die Entwicklerplattform von Pinterest enthält Informationen zu allen API-Produkten von Pinterest. 

Erste Schritte

Jeder mit einem Pinterest Business-Konto hat Zugriff auf die Pinterest-API für Conversions.

Als Erstes musst du ein Zugriffstoken generieren. Ein Zugriffstoken ist eine Zeichenfolge, mit der sichergestellt wird, dass die Anfragen gestellt und an das richtige Nutzerkonto zurückgeschickt werden. 

So generierst du ein Zugriffstoken: 

Melde dich bei deinem Pinterest-Unternehmenskonto an.

Klicke im oberen Menü auf Anzeigen und wähle Conversions aus.

Wähle im linken Navigationsbereich die Seite Conversion-Zugriffstoken aus.

Klicke auf den Button Neues Token generieren.

Kopiere das neue Zugriffstoken und kehre zum Einrichtungsprozess zurück.

Wenn du auf ein Konto zugreifen möchtest, das dir nicht gehört, musst du zuerst ein Unternehmenskonto einrichten. 

Implementierung

Conversion Events: Alle Event-Typen, die über den Pinterest-Tag erfasst werden können, sind auch über die Pinterest-API für Conversions verfügbar. Eine vollständige Liste der Events und weitere Informationen zu ihrer Wichtigkeit findest du in unserer Entwicklerdokumentation zur Pinterest-API.

Die Einrichtung einer Server-to-Server-API-Integration erfordert Entwickler- und Engineering-Ressourcen vom Eigentümer der Webseite. Der Aufwand für den technischen Entwickler hängt von den folgenden Aspekten ab:

Der Vertrautheit der Entwickler mit API-Integrationen. Falls noch nie eine API-Integration durchgeführt wurde, ist möglicherweise zusätzliche Arbeit erforderlich. Falls du schon andere Conversion-APIs implementiert hast, sollte dein Entwickler nur ein paar inkrementelle Änderungen vornehmen müssen.

Die Anzahl der Events, die nachverfolgt werden und in welcher Phase der Conversion Prozessdaten an uns gesendet werden.

Wenn ein Werbekunde eine Drittpartei integrieren möchte oder muss (z. B. Shopify, GTM, Tealium).

Wenn du das Pinterest-Tag bereits verwendest

Wir empfehlen dringend, die Pinterest-API für Conversions gemeinsam mit dem Pinterest-Tag zu verwenden. So kannst du sicherstellen, dass du das Maximum aus deinen Conversions herausholst. 

Falls du das Pinterest-Tag bereits eingerichtet hast, musst du sicherstellen, dass Conversions nicht zweimal gezählt werden – einmal über das Pinterest-Tag und einmal über die API. 

Dazu musst du sicherstellen, dass der Parameter event_id mit Conversions zurückgegeben wird, die sowohl vom Pinterest-Tag als auch von der Pinterest-API für Conversions erfasst wurden. 

Unser System erkennt die event_ids dann als Duplikate und behält nur die erste erfasste Conversion bei. Um sicherzustellen, dass diese Deduplizierung erfolgreich ist, müssen event_ids Folgendes sein:

event_ids müssen bei denselben Conversions identisch sein: Ein Nutzer navigiert zu einer Webseite und eine Seitenaufruf-Conversion wird sowohl vom Pinterest-Tag als auch von der Pinterest-API ausgelöst. Für die beiden Conversions müssen übereinstimmende event_ids zurückgegeben werden, damit unser System erkennt, dass es sich um dieselbe Conversion handelt. 

event_ids müssen bei unterschiedlichen Conversions eindeutig sein: Ein Nutzer navigiert zu einer Webseite und eine Seitenaufruf-Conversion wird sowohl vom Pinterest-Tag als auch von der Pinterest-API ausgelöst. Der Nutzer fügt dann ein T-Shirt zum Warenkorb hinzu, wodurch das AddToCart-Event sowohl für das Pinterest-Tag als auch für die Pinterest-API ausgelöst wird. Während die event_ids, die für dieselben Events ausgelöst werden, übereinstimmen müssen, müssen die event_ids, die für das PageVisit-Event und das AddToCart-Event gesendet werden, eindeutig sein. Auf diese Weise erkennt unser System sie als separate Events.

Basierend auf dieser Event-ID und dem Event-Namen (event_name) entfernt Pinterest alle doppelten Events aus dem Datensatz, sofern (a) das Event nicht offline stattgefunden hat (die action_source ist nicht offline) und (b) Pinterest die doppelten Events innerhalb von 48 Stunden voneinander empfängt.

Einrichtung überprüfen

Sobald du die API fertig eingerichtet hast, kannst du sicherstellen, dass Conversion Events empfangen werden, indem du Folgendes überprüfst:

Antwortcodes: Der Entwickler, der deine API-Integration einrichtet, kann die Antwortcodes überprüfen, die bei jeder Anfrage zurückgesendet werden, nachdem eine Conversion ausgelöst wurde. 

Deduplizierungsseite im Ads Manager: Nach der Deduplizierung generierte Conversions werden auf der Deduplizierungsseite im Ads Manager angezeigt. So kannst du auf die Deduplizierungsseite zugreifen:

• Melde dich bei deinem Pinterest-Unternehmenskonto an.
• Klicke im oberen Menü auf „Anzeigen“ und wähle „Conversions“ aus.
• Wähle im linken Navigationsbereich die Option „Deduplizierung“ aus.

Qualität und Resilienz

Resilienz ist der Status des Setups einer API für Conversions, die die höchste Ebene der Signalzuordnung und -attribution zulässt. Diese zusätzlichen Daten helfen uns dabei, vor dem Hintergrund sich ändernder oder weiterentwickelnder Richtlinien in der Anzeigenbranche genauere Berichte zu erstellen.

Resilienzstatus

Es gibt zwei Kategorien des Resilienzstatus: „Gut“ und „Schlecht“. Dein Resilienzstatus wird im Abschnitt „Conversion-Integrität“ im Ads Manager angezeigt.

Gute Resilienz

Option 1: Abdeckung von spezifischen Kennungen

Abdeckung von Kennungen

• Mindestens 90 % der Events weisen eine IP-/UA-Adresse auf, 
• Mindestens 10 % der Events im Lower Funnel weisen eine verschlüsselte E-Mail oder MAID auf, 
• Mindestens 10 % der Events weisen eine externe ID auf.

Überschneidung mit Tag-Daten (falls zutreffend)

• Mindestens 90 %* der Tag-Events sollten über CAPI empfangen werden. 

Oder:

Option 2: Erreichen einer Basis-Übereinstimmungsrate

CAPI Nutzer-Übereinstimmungsrate von mindestens 60 %

Überschneidung mit Tag-Daten (falls zutreffend)

Mindestens 90 %* der Tag-Events sollten über CAPI empfangen werden. 

Schlechte Resilienz

Jedes Setup, das nicht „Gut“ ist.

Resilienz-IDs und Signale

Sende die folgenden Signale, um einen resilienten Status für Werbetreibende zu erreichen.

API-IDs/Signale	Gewichtungen/Ranking
client_ip_address + client_user_agent	Hoch
em	Hoch
external_id	Hoch
hashed_maid	Hoch
click_id	Hoch
fn + ln	Niedrig
ph	Niedrig
ge, bd, ct, st, zp, country	Niedrig

*Gewichtung/Ranking basierend auf der Wahrscheinlichkeit der Erhöhung der Übereinstimmungsrate

Implementierung durch Drittanbieter

Pinterest verfügt über Integrationen von Dritten, die deinen API-Einführungsprozess unterstützen können. 

Google Tag Manager – Serverseitig

Verknüpfe dein Google Tag Manager-Konto mit der Pinterest-API für Conversions, um herauszufinden, wie sehr Pinterest den Traffic zu deinem Shop und die Verkaufszahlen deiner Produkte beeinflusst.

Diese Integration erfordert die Bereitstellung eines Server-Containers bei deinem bevorzugten Cloud-Anbieter. Außerdem solltest du dich mit serverseitigem Tagging auskennen. Weitere Infos zu den Voraussetzungen findest du auf der Entwickler-Webseite.

Shopify

Diese Integration der API für Conversions ergänzt das Pinterest-Tag, um die Datenerfassung und -qualität zu verbessern. Solange die Shopify-App installiert ist, musst du nichts weiter tun, um diese Verbesserung zu nutzen. Die Änderungen werden automatisch auf den Shop des Händlers angewendet.

Tealium

Werbetreibende, die an Tealium interessiert sind, können die API für Conversions direkt über die Drittpartei einrichten. Tealium erstellt die Vorlage und unterstützt den Werbetreibenden bei der Integration. 

Der Implementierungsprozess ist im Learning Center von Tealium beschrieben. Bei Fragen zur Unterstützung bei der Implementierung kannst du dich an support [at] tealium.com (support[at]tealium[dot]com) wenden. 

Falls du an zusätzlichen Integrationen von Dritten interessiert bist, wende dich für weitere Informationen an deinen Vertriebsmitarbeiter. 

Erläuterung zu Limited Data Processing

Seit dem 1. Januar 2023 können Werbetreibende das Flag „Limited Data Processing“ unterstützend nutzen, um den California Consumer Privacy Act und den California Privacy Rights Act (zusammen „CCPA“) einzuhalten. Mit diesem Flag schränkt Pinterest ein, wie wir bestimmte Daten verwenden, um Werbetreibende bei der Einhaltung der Datenschutzeinstellungen der Nutzer zu unterstützen. Beispielsweise kann ein Werbetreibender das Flag „Limited Data Processing“ für Nutzer im US-Bundesstaat Kalifornien implementieren, die dem Verkauf oder der Weitergabe ihrer Daten gemäß CCPA widersprochen haben. Wenn das Flag „Limited Data Processing“ verwendet wird, fungiert Pinterest gemäß CCPA als Dienstanbieter hinsichtlich entsprechend markierter Daten von Nutzern in Kalifornien.

Werbetreibende sind dafür verantwortlich, gemäß dem Widerspruch der Nutzer zu handeln sowie zu ermitteln, in welchem US-Bundesstaat Nutzer wohnhaft sind, wenn sie den Flag „Limited Data Processing“ implementieren.