DokumentationExperience PlatformTags

Pinterest-Erweiterung zur Ereignisweiterleitung

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Pinterest ist eine visuelle Discovery-Engine zum Finden von Ideen wie Rezepten, Wohnkultur, Stilinspiration und mehr. Es gibt Milliarden von Pins auf Pinterest, die auch mit anderen auf Pinterest geteilt werden können. Sie können die Benutzerinteraktionsereignisse zusammenstellen und Pinterest Analytics nutzen, um das Benutzerverhalten zu verstehen und zielgerichtete Anzeigen auszuführen.

Mit der Pinterest Conversions-API Ereignisweiterleitung können Sie die in Adobe Experience Platform Edge Network erfassten Daten nutzen und an Pinterest senden. In diesem Dokument werden die Anwendungsfälle der Erweiterung, deren Installation und die Integration der Funktionen in die Ereignisweiterleitung () ​.

Konversionen-Zugriffstoken sind die Authentifizierungsmethode, die von Pinterest bei der Interaktion mit der Pinterest-API verwendet wird.

Anwendungsfälle

Diese Erweiterung sollte verwendet werden, wenn Sie Daten aus der Edge Network verwenden möchten, Pinterest die Kundenanalysefunktionen von zu nutzen.

Betrachten Sie beispielsweise ein Marketing-Team in einer Organisation. Das Team erfasst Ereignisdaten zu Benutzerinteraktionen von seiner Website und lädt sie mithilfe dieser Erweiterung zur Ereignisweiterleitung in Pinterest.

Die Marketing- und Analyse-Teams können dann Pinterest Analytics-Funktionen nutzen, um wichtige Benutzerinteraktionen und -verhaltensweisen zu verstehen, sodass Sie Benutzer besser verstehen und sie für zielgerichtete Anzeigenkampagnen ansprechen können.

Weitere Informationen zu Pinterest-spezifischen Anwendungsfällen finden Sie in der Dokumentation Pinterest Anwendungsfälle .

Voraussetzungen für Pinterest prerequisites

Sie müssen über ein gültiges PinterestGeschäftskonto​ verfügen um diese Erweiterung verwenden zu können. Navigieren Sie zur Pinterest Registrierungsseite, um sich zu registrieren und ein Konto zu erstellen, falls Sie noch keines haben.

Sie benötigen außerdem ein Pinterest Entwicklerkonto, das mit Ihrem Pinterest Business-Konto verknüpft werden muss. Informationen zum Verknüpfen Ihres Entwicklerkontos mit Ihrem Geschäftskonto finden Sie unter Pinterest ​ Entwicklerkonto.

Sammeln erforderlicher Konfigurationsdetails configuration-details

Um den Experience Platform mit Pinterest zu verbinden, sind die folgenden Eingaben erforderlich:

Anmeldedaten
Beschreibung
Beispiel
Werbekonto-ID
Ihre Pinterest Ads-Konto-ID. Eine Anleitung finden Sie in der Pinterest Dokumentation.
123456789012
Konversionszugriffstoken
Ihr Pinterest-Konversions-Zugriffstoken. Eine Anleitung dazu finden Pinterest im Dokument ​Konversions-API“.
Sie müssen dies nur einmal tun, da dieses Token nicht abläuft.

Installieren und Konfigurieren der Pinterest install

Um die Erweiterung zu installieren​ erstellen Sie eine Ereignisweiterleitungseigenschaft oder ​ Sie stattdessen eine vorhandene Eigenschaft aus, die bearbeitet werden soll.

Wählen Sie in der linken Navigation Extensions aus. Wählen Sie Install auf der Karte für die Pinterest auf der Registerkarte Catalog aus.

Katalog mit hervorgehobener Pinterest-Erweiterung mit Install.

Pinterest-Erweiterung konfigurieren

IMPORTANT
Je nach Ihren Implementierungsanforderungen müssen Sie möglicherweise ein Schema, Datenelemente und einen Datensatz erstellen, bevor Sie die Erweiterung konfigurieren. Bitte überprüfen Sie alle Konfigurationsschritte, bevor Sie beginnen, um festzustellen, welche Entitäten Sie für Ihren Anwendungsfall einrichten müssen.

Wählen Sie in der linken Navigation Extensions aus. Wählen Sie Configure auf der Karte für die Pinterest auf der Registerkarte Installed** aus.

Pinterest auf der Registerkarte Install angezeigte Erweiterung mit hervorgehobenem Configure.

Geben Sie im nächsten Bildschirm die Ads Account Id und Conversion Access Token ein, die Sie zuvor im Abschnitt Konfigurationsdetails erfasst haben. Wenn Sie fertig sind, wählen Sie Save aus.

Der Pinterest Configure mit den Ads Account Id und Conversion Access Token Eingabefeldern.

Konfigurieren einer Ereignisweiterleitungsregel config-rule

Nachdem alle Datenelemente eingerichtet wurden, können Sie mit der Erstellung von Ereignisweiterleitungsregeln beginnen, die bestimmen, wann und wie Ihre Ereignisse an Pinterest gesendet werden.

Erstellen Sie eine neue Regel in Ihrer Ereignisweiterleitungs-Eigenschaft. Fügen Sie unter Actions eine neue Aktion hinzu und legen Sie die Erweiterung auf Pinterest fest. Um Edge Network-Ereignisse an Pinterest zu senden, setzen Sie den Action Type auf Send Event.

Die Pinterest Send Event Regelerstellung.

Nach der Auswahl erscheinen zusätzliche Steuerelemente, um das Ereignis weiter zu konfigurieren. Sie müssen die Pinterest Ereigniseigenschaften den Datenelementen zuordnen, die Sie zuvor erstellt haben.

Event Data

Zum Erstellen der neuen Regel sind die folgenden Ereignisdaten erforderlich:

Feldname
Beschreibung
Beispiel
Event Name
Der Typ des Benutzerereignisses. Dies kann ein beliebiger Ereignistyp sein. Zur Nutzung Pinterest Analytics wird jedoch die Verwendung von Pinterest Ereignis-Codes“ ​
*
* add_to_cart
* page_visit
*
* [Benutzerdefiniertes Ereignis]
Action Source
Die Quelle, die angibt, wo das Konversionsereignis aufgetreten ist.
* app_android
* app_ios-
* Web-
* offline
Event Time
Dies bezieht sich auf die Ereigniszeit. Das standardmäßig verwendete Zeitformat ist UNIX und das Format <seconds>.<miliseconds> abhängig von Ihrer lokalen Zeitzone. Weitere Informationen finden Sie unter Pinterest API.
1433188255.500 gibt 1433188255 Sekunden und 500 Millisekunden nach Epoche oder Montag, den 1. Juni 2015, um 19:50:55 Uhr GMT an.
Event ID
Eine eindeutige ID-Zeichenfolge, die dieses Ereignis identifiziert und für die Deduplizierung zwischen Ereignissen verwendet werden kann, die sowohl über die Konversions-API als auch über das Pinterest-Tracking aufgenommen werden. Andernfalls werden die Daten des Ereignisses wahrscheinlich doppelt gezählt und eine metrische Inflation gemeldet.
BA7816BF8F01CFEA414140DE5DAE2223B00361A396177A9CB410FF61F20015AD
Event Properties
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Ereignisses. Wählen Sie aus der Bereitstellung von unformatiertem JSON oder der Verwendung eines vereinfachten Satzes von Schlüssel-Wert-Eingaben.
{ „event_source_url“: "http://site.com" }

Die Pinterest Event Data in der Regelaktion hervorgehoben.

Die folgenden Ereigniseigenschaften können konfiguriert werden:

Feldname
Beschreibung
Event Source URL
URL des Web-Konversionsereignisses.
Kennung des Anwendungsspeichers
Die App Store-App-ID.
Anwendungsname
Der Name des Programms.
Application Version
Die Version des Programms.
Gerätemarke
Marke des Geräts, das vom Benutzer verwendet wird.
Geräteträger
Mobilnetzbetreiber des Benutzers für sein Gerät.
Gerätemodell
Modell des Geräts des Benutzers.
Device Type
Gerätetyp, der vom Benutzer verwendet wird.
Betriebssystemversion
Version des Betriebssystems des Geräts.
Benutzersprache
Zweistelliger ISO-639-1-Sprach-Code, der die Sprache des Benutzers angibt.

User Data

Die folgenden Benutzerdaten können über Felder eingegeben werden, die nicht erforderlich sind:

Feldname
Beschreibung
Beispiel
Email
Benutzer-E-Mail-Adresse oder ein SHA256-Hash der Benutzer-E-Mail-Adresse.
EBD543592…F2B7E1
Mobile Adverstising IDs
SHA256-Hashes der "Google Advertising IDs“ (GAIDs) oder "Apple-Kennung für Werbetreibende“ (IDFAs) von Benutzenden
EBD543592…F2B7E1
Client IP Address
Die IP-Adresse des Benutzers, die entweder im IPv4- oder IPv6-Format vorliegen kann. Wird für den Abgleich verwendet.
192.168.0.1
Client User Agent
Die Benutzeragenten-Zeichenfolge des Webbrowsers des Benutzers.
Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Customer information data
Ein JSON-Objekt, das andere Kundeninformationen enthält. Wählen Sie aus der Bereitstellung von unformatiertem JSON oder der Verwendung eines vereinfachten Satzes von Schlüssel-Wert-Eingaben.

Die Pinterest User Data in der Regelaktion hervorgehoben.

Zu den Kundeninformationseigenschaften, die konfiguriert werden können, gehören:

Feldname
Beschreibung
Telefon
Kontaktnummer des Benutzers Nur Ziffern werden akzeptiert und sollten mit Ländercode, Vorwahl und Nummer eingegeben werden.
Geschlecht
Das Geschlecht kann entweder als „f“ für weiblich, „m“ für männlich oder „n“ für nicht-binär eingegeben werden.
Geburtsdatum
Geburtsdatum, eingegeben als Jahr, Monat und Tag.
Nachname
Nachname des Benutzers.
Vorname
Vorname des Benutzers.
Stadt
Wohnort des Benutzers. Dies wird hauptsächlich für Abrechnungszwecke verwendet.
Land
Benutzerstatus, der als Code mit zwei Buchstaben in Kleinbuchstaben bereitgestellt wird.
Postleitzahl
Postleitzahl des Benutzers, die hauptsächlich zu Abrechnungszwecken verwendet wird.
Land
Zweistelliger ISO-3166-Ländercode, der das Land des Benutzers angibt.
Externe ID
Eindeutige ID des Advertisers, der einen Benutzer in seiner Platzierung identifiziert. Beispielsweise Benutzer-ID, Treueprogramm-ID usw.
Klick-ID
Die eindeutige Kennung, die im _epik-Cookie in Ihrer Domain oder im &epik=-Abfrageparameter in der URL gespeichert ist.
IMPORTANT
Bevor die Daten an den Pinterest-API-Endpunkt gesendet werden, hasht und normalisiert die Erweiterung die Werte der folgenden Felder: E-Mail, Telefonnummer, Vorname, Nachname, Geschlecht, Geburtsdatum, Stadt, Bundesland, Postleitzahl, Land und externe ID. Die Erweiterung hasht den Wert dieser Felder nicht, wenn bereits eine SHA256-Zeichenfolge vorhanden ist.

Custom Data

Die folgenden benutzerdefinierten Daten können für die Regel eingegeben werden:

Feldname
Beschreibung
Währung
Der ISO-4217-Währungscode. Wenn dies nicht angegeben wird, verwendet Pinterest standardmäßig die Währung des Advertisers, die bei der Kontoerstellung festgelegt wurde.
Wert
Gesamtwert des Ereignisses. Akzeptiert als Zeichenfolge in der Anfrage. Dies wird in eine zweistellige Zahl geparst.
Suchzeichenfolge
Die Suchzeichenfolge für das Benutzerkonversionsereignis.
Auftrags-ID
Die Auftrags-ID. Das Senden von order_id hilft bei Pinterest Deduplizierung von Ereignissen.
Anzahl der Produkte
Gesamtzahl der Produkte der Veranstaltung. Beispielsweise die Gesamtzahl der in einem Checkout-Ereignis gekauften Artikel.
Inhalts-IDs
Liste (Array) der Produkt-IDs.
Inhalt
Eine Liste (Array) von Objekten, die Informationen über Produkte enthalten, z. B. Preis und Menge.

Die Pinterest Custom Data in der Regelaktion hervorgehoben.

Validieren von Daten in Pinterest

Überprüfen Sie nach der Erstellung und Ausführung der Ereignisweiterleitungsregel, ob das an die Pinterest-API gesendete Ereignis wie erwartet in der Pinterest-Benutzeroberfläche angezeigt wird.

Wenn die Ereignissammlung und Experience Platform Integration erfolgreich waren, werden Ereignisse in der Pinterest Benutzeroberfläche angezeigt.

Der Pinterest Event Manager

Sie können die Pinterest Ereignisdatenverteilung weiter aufschlüsseln und anzeigen.

Die Pinterest Datenverteilung

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie die Pinterest-Erweiterung für die Ereignisweiterleitung in der Benutzeroberfläche installieren und konfigurieren. Weitere Informationen finden Sie in der offiziellen Dokumentation:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743