DokumentationExperience PlatformTags

Pinterest-Erweiterung zur Ereignisweiterleitung

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler

Pinterest ist eine visuelle Suchmaschine, mit der Ideen wie Rezepte, Innendekoration, Stilinspirierungen und mehr gefunden werden können. Es gibt Milliarden von Pins auf Pinterest, die auch für andere auf Pinterest freigegeben werden können. Sie können die Benutzerinteraktionsereignisse sortieren und Pinterest Analytics verwenden, um das Benutzerverhalten zu verstehen und zielgerichtete Werbung auszuführen.

Mit der Erweiterung Pinterest Konversions API Ereignisweiterleitung können Sie die im Adobe Experience Platform-Edge Network erfassten Daten nutzen und an Pinterest senden. In diesem Dokument werden die Anwendungsfälle der Erweiterung, ihre Installation und die Integration ihrer Funktionen in die Ereignisweiterleitung von Regeln behandelt.

Konversions-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 dem Edge Network in Pinterest verwenden möchten, um die Kundenanalysefunktionen zu nutzen.

Betrachten Sie beispielsweise ein Marketing-Team in einer Organisation. Das Team erfasst Benutzerinteraktionsereignisdaten von seiner Website und lädt sie mithilfe dieser Ereignisweiterleitungs-Erweiterung in Pinterest.

Die Marketing- und Analyseteams können dann Pinterest Analytics-Funktionen nutzen, um wichtige Benutzerinteraktionen und -verhalten zu verstehen, sodass Sie Benutzer besser verstehen und gezielt für zielgerichtete Werbekampagnen ansprechen können.

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

Voraussetzungen für Pinterest prerequisites

Sie müssen über ein gültiges Pinterest Geschäftskonto verfügen, um diese Erweiterung verwenden zu können. Rufen Sie die Pinterest Registrierungsseite auf, um sich zu registrieren und ein Konto zu erstellen, falls noch keines vorhanden ist.

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

Erforderliche Konfigurationsdetails sammeln configuration-details

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

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

Installieren und Konfigurieren der Pinterest -Erweiterung install

Um die Erweiterung zu installieren, erstellen Sie eine Ereignisweiterleitungs-Eigenschaft oder wählen Sie eine vorhandene Eigenschaft aus, die Sie stattdessen bearbeiten möchten.

Wählen Sie im linken Navigationsbereich Erweiterungen aus. Wählen Sie Installieren auf der Karte für die Erweiterung Pinterest auf der Registerkarte Katalog aus.

Katalog, der die Erweiterung Pinterest anzeigt, wobei Install hervorgehoben ist.

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 im linken Navigationsbereich Erweiterungen aus. Wählen Sie Konfigurieren auf der Karte für die Erweiterung Pinterest auf der Registerkarte Installiert**.

Erweiterung Pinterest wird auf der Registerkarte Installieren angezeigt, wobei Konfigurieren hervorgehoben ist.

Geben Sie im nächsten Bildschirm die Konto-ID des Anzeigenkontos und das Konversionszugriffs-Token ein, die Sie zuvor im Abschnitt Konfigurationsdetails erfasst haben. Klicken Sie abschließend auf Speichern.

Der Bildschirm Pinterest Konfigurieren , auf dem die Eingabefelder Konto-ID der Anzeigen und Konversionszugriffstoken markiert werden.

Konfigurieren einer Ereignisweiterleitungsregel config-rule

Sobald alle Ihre Datenelemente eingerichtet sind, 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 Ereignisweiterleitungseigenschaft. Fügen Sie unter Aktionen eine neue Aktion hinzu und legen Sie die Erweiterung auf Pinterest fest. Um Edge Network-Ereignisse an Pinterest zu senden, setzen Sie den Aktionstyp auf Ereignis senden.

Die Regelerstellung Pinterest Ereignis senden .

Nach der Auswahl scheinen zusätzliche Steuerelemente das Ereignis weiter zu konfigurieren. Sie müssen die Pinterest -Ereigniseigenschaften den zuvor erstellten Datenelementen zuordnen.

Ereignisdaten

Die folgenden Ereignisdaten sind erforderlich, um die neue Regel zu erstellen:

Feldname
Beschreibung
Beispiel
Ereignisname
Der Typ des Benutzerereignisses. Dies kann jedoch ein beliebiger Ereignistyp sein, um Pinterest Analytics zu nutzen. Es wird empfohlen, Pinterest Ereigniscodes zu verwenden.
* checkout
* add_to_cart
* page_visit
* signup
* [Benutzerdefiniertes Ereignis]
Action Source
Die Quelle, die angibt, wo das Konversionsereignis aufgetreten ist.
* app_android
* app_ios
* web
* offline
Ereigniszeit
Dies bezieht sich auf die Ereigniszeit. Das standardmäßig verwendete Zeitformat ist UNIX, das je nach lokaler Zeitzone im Format <seconds>.<miliseconds> vorliegt. Weitere Informationen finden Sie in der Pinterest API.
1433188255.500 bedeutet 143318255 Sekunden und 500 Millisekunden nach der Epoche oder Montag, den 1. Juni 2015, um 19 Uhr GMT.:50:
Ereignis-ID
Eine eindeutige ID-Zeichenfolge, die dieses Ereignis identifiziert und zur Deduplizierung zwischen Ereignissen verwendet werden kann, die sowohl über die Konversions-API als auch über das Pinterest-Tracking erfasst werden. Andernfalls werden die Ereignisdaten wahrscheinlich doppelt gezählt und die Metrikinflation gemeldet.
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
Ereigniseigenschaften
Ein JSON-Objekt mit benutzerdefinierten Eigenschaften des Ereignisses. Wählen Sie aus der Bereitstellung von rohen JSON-Dateien oder der Verwendung eines vereinfachten Satzes von Schlüsselwerteingaben.
{ "event_source_url": "http://site.com" }

Die in der Regelaktion hervorgehobenen Pinterest Ereignisdaten.

Die folgenden Ereigniseigenschaften können konfiguriert werden:

Feldname
Beschreibung
Ereignis-Source-URL
URL des Web-Konversionsereignisses.
App Store-ID
Die App Store-App-ID.
Anwendungsname
Der Name der Anwendung.
Application Version
Die Version der Anwendung.
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-Sprachcode, der die Sprache des Benutzers angibt.

Benutzerdaten

Die folgenden Benutzerdaten können von eingegeben werden und sind keine Pflichtfelder:

Feldname
Beschreibung
Beispiel
E-Mail
Benutzer-E-Mail-Adresse oder ein SHA256-Hash der E-Mail-Adresse des Benutzers.
ebd543592…f2b7e1
Mobile Advertising IDs
Sha256-Hashes der "Google Advertising IDs"(GAIDs) oder "Apples Identifier for Advertisers"(IDFAs) des Benutzers
ebd543592…f2b7e1
Client-IP-Adresse
Die IP-Adresse des Benutzers, die entweder im IPv4- oder IPv6-Format vorliegen kann. Wird für die Zuordnung verwendet.
192 168,0,1
Client-Benutzeragent
Die Benutzeragenten-Zeichenfolge des Webbrowsers des Benutzers.
Mozilla/5.0 (Plattform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Kundeninformationsdaten
Ein JSON-Objekt, das andere Kundeninformationen enthält. Wählen Sie aus der Bereitstellung von rohen JSON-Dateien oder der Verwendung eines vereinfachten Satzes von Schlüsselwerteingaben.
{ "ph": "122333445" }

Die in der Regelaktion hervorgehobenen Pinterest Benutzerdaten.

Die Eigenschaften der Kundeninformationen, die konfiguriert werden können, sind:

Feldname
Beschreibung
Telefon
Kontaktnummer des Benutzers. Es werden nur Ziffern akzeptiert, die mit Ländercode, Gebietscode und Nummer eingegeben werden sollten.
Geschlecht
Das Geschlecht kann entweder als "f"für weiblich, als "m"für männlich oder als "n"für nicht binär eingegeben werden.
Geburtsdatum
Geburtsdatum, angegeben 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 in Kleinbuchstaben als Code mit zwei Buchstaben bereitgestellt wird.
Postleitzahl
Postleitzahl des Benutzers, der hauptsächlich für Abrechnungszwecke verwendet wird.
Land
Zweistelliger ISO-3166-Ländercode, der das Land des Benutzers angibt.
Externe ID
Eindeutige ID des Advertisers, der einen Benutzer in seinem Bereich identifiziert. z. B. Benutzer-ID, Treueprogramm-ID usw.
Klick-ID
Die eindeutige Kennung, die im _epik -Cookie in Ihrer Domäne oder im Abfrageparameter &epik= in der URL gespeichert ist.
IMPORTANT
Bevor die Daten an den API-Endpunkt Pinterest gesendet werden, hasst 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 hasst den Wert dieser Felder nicht, wenn bereits eine SHA256-Zeichenfolge vorhanden ist.

Benutzerdefinierte Daten

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

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

Die in der Regelaktion hervorgehobenen Pinterest benutzerdefinierten Daten.

Daten mit Pinterest validieren

Sobald die Ereignisweiterleitungsregel erstellt und ausgeführt wurde, überprüfen Sie, ob das Ereignis, das an die Pinterest -API gesendet wurde, wie erwartet in der Benutzeroberfläche von Pinterest angezeigt wird.

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

Der Pinterest Ereignismanager

Sie können die Pinterest-Ereignisdatenverteilung weiter durchlaufen und anzeigen.

Die Pinterest Datenverteilung

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie die Erweiterung Pinterest 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