Ü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

    Die resiliente Einrichtung von Events umfasst zusätzliche Conversion-Daten, die Pinterest verwenden kann, um sicherzustellen, dass Events korrekt abgeglichen und zugeordnet werden.  Diese zusätzlichen Daten helfen uns dabei, vor dem Hintergrund sich ändernder oder weiterentwickelnder Richtlinien in der Anzeigenbranche genauere Berichte zu erstellen.

    Resilienzebenen

    Es gibt drei Ebenen, um die Resilienz eines Werbetreibenden zu bewerten: Schlecht, Zufriedenstellend und Gut. Dein Resilienzstatus wird im Abschnitt „Conversion-Integrität“ von Ads Manager angezeigt.

    Schlecht

    Eine schlechte Statusbewertung bedeutet, dass:

  • ein Werbetreibender eine IP-/UA-Abdeckung von weniger als 100 % für alle Events hat
  • eine E-Mail-Adresse oder MAID nicht in Checkout-Events geteilt wird
  • ein Werbetreibender das Pinterest-Tag zwar implementiert hat, jedoch nicht alle Lower-Funnel-Tag-Events (In den Warenkorb legen, Checkout, Lead oder Registrierung) an die API sendet.

    • Zufriedenstellend

    Ein zufriedenstellende Statusbewertung wird erreicht, wenn: 

  • ein Werbetreibender eine IP-/UA-Abdeckung von 100 % für alle Events hat 
  • eine E-Mail-Adresse oder MAID in Checkout-Events geteilt wird 
  • ein Werbetreibender das Pinterest-Tag implementiert hat und 100 % der Lower-Funnel-Tag-Events (entweder In den Warenkorb legen, Checkout, Lead oder Registrierung) über die API erhält.

    • Klasse

    Eine gute Statusbewertung bedeutet, dass ein Werbetreibender alle Anforderungen an einen zufriedenstellenden Status erfüllt und alle IDs mittlerer und niedriger Priorität sendet.

    Resilienz-IDs und Signale

    Um für Werbetreibende einen resilienten Status zu erreichen, empfiehlt Pinterest das Senden der folgenden Signale.
     

    API-IDs/Signale Gewichtungen/Ranking
    hashed_maid Hoch
    em Hoch
    Clinet_ip_address + Client_user_agent Hoch
    external_id Mittel
    Fn+In Mittel
    click_id Niedrig
    ph Niedrig
    ge, bd, ct, st, zp, country Niedrig
    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.
    Brauchst du immer noch Hilfe? Kontakt
    War dieser Artikel hilfreich?

    Wie können wir diesen Artikel verbessern?