DokumentationExperience PlatformTags

Twitter-Erweiterung zur Ereignisweiterleitung

Last update: Fri Mar 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Developer

Twitter ist ein Online-Dienst für soziale Medien und soziale Netzwerke, bei dem Benutzer Nachrichten mit einer Länge von 280 Zeichen posten und mit ihnen interagieren, die als Tweets bezeichnet werden. Benutzer können über einen Browser, eine mobile Frontend-Software oder programmgesteuert mit Twitter interagieren APIs

Die Twitter Web Conversions API Ereignisweiterleitung -Erweiterung ermöglicht es Ihnen, die im Adobe Experience Platform Edge Network erfassten Daten zu nutzen und an Twitter. In diesem Dokument werden die Anwendungsfälle der Erweiterung, ihre Installation und die Integration ihrer Funktionen in die Ereignisweiterleitung behandelt. Regeln.

Twitter erfordert OAuth 1.0 für die Authentifizierung mit der Twitter Web Conversions API.

Anwendungsfälle

Diese Erweiterung sollte verwendet werden, wenn Sie Daten aus dem Edge-Netzwerk in Twitter , um die Analyse- und Targeting-Funktionen der Kunden zu nutzen.

Betrachten Sie beispielsweise ein Marketing-Team in einer Organisation. Das Team erfasst Benutzerinteraktionsereignisdaten von seiner Website als Ereignisdaten von seiner Website und lädt sie in Twitter mit dieser Ereignisweiterleitungs-Erweiterung verwenden.

Die Marketing- und Analyseteams können dann Twitter’s Funktionen zur Durchführung zusätzlicher Analysen und zur Ausrichtung dieser Benutzer auf zielgerichtete Werbekampagnen.

Weitere Informationen zu spezifischen Anwendungsfällen für Twitter, siehe Twitter Anwendungsfälle Dokumentation.

Twitter Voraussetzungen und Limits prerequisites

Sie müssen über gültige Twitter , um diese Erweiterung zu verwenden. Navigieren Sie zu Twitter Registrierungsseite , um sich zu registrieren und ein Konto zu erstellen, falls Sie noch kein Konto haben.

Sie müssen Ihr Konto als Twitter Entwicklerkonto. Informationen zur Anmeldung als Entwickler finden Sie im Abschnitt Twitter Entwicklerkonto.

API-Limits guardrails

Die Twitter Die Web Conversions-API hat eine Ratenbegrenzung von 60.000 Anfragen pro 15-minütigen Intervall, wobei jede Anfrage 500 Ereignisse zulässt.

Erforderliche Konfigurationsdetails sammeln configuration-details

Um die Experience Platform an Twitter, sind folgende Eingaben erforderlich:

Schlüsseltyp
Beschreibung
Consumer Key
​ API-Schlüssel der App für den Zugriff auf die Twitter API. Siehe Abschnitt Twitter Dokumentation zu API-Schlüssel und Geheimnisse für Leitlinien.
Verbrauchergeheimnis
Der API-Geheimnis ermöglicht es Ihrer App, auf die Twitter API. Siehe Abschnitt Twitter Dokumentation zu API-Schlüssel und Geheimnisse für Leitlinien.
Token-Geheimnis
Das nicht ablaufende Token-Geheimnis Ihrer App, das für die Authentifizierung bei der Twitter API über OAuth. Siehe Abschnitt Twitter Dokumentation zu Verwenden von Zugriffstoken abrufen für Leitlinien.
Zugriffs-Token
Das nicht ablaufende Zugriffstoken Ihrer App, das zur Authentifizierung bei der Twitter API über OAuth. Siehe Abschnitt Twitter Dokumentation zu Verwenden von Zugriffstoken abrufen für Leitlinien.
Pixel-ID
Die Twitter Pixel ist ein Website-Tag, das auf Ihrer Website implementiert wird, um Site-Aktionen oder -Konversionen zu verfolgen. Siehe Abschnitt Twitter Dokumentation zu Konversions-Tracking für Websites für Leitlinien.

Installieren und konfigurieren Sie die Twitter Erweiterung install

So installieren Sie die Erweiterung: Erstellen einer Ereignisweiterleitungs-Eigenschaft oder wählen Sie eine vorhandene Eigenschaft aus, die Sie stattdessen bearbeiten möchten.

Wählen Sie Erweiterungen in der linken Navigation aus. Im Katalog Registerkarte auswählen Installieren auf der Karte für die Twitter -Erweiterung.

Katalog, der die Twitter Erweiterungsmarkierungsinstallation.

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.

Geben Sie im nächsten Bildschirm Folgendes ein: Konfigurationswerte die Sie zuvor aus Twitter:

  • Pixel-ID
  • Consumer Key
  • Verbrauchergeheimnis
  • Token
  • Token-Geheimnis

Klicken Sie abschließend auf Speichern.

Twitter Konfigurationsbildschirm für Twitter -Erweiterung.

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 gesendet werden Twitter.

Erstellen Sie eine neue Regel in Ihrer Ereignisweiterleitungseigenschaft. under Aktionen, fügen Sie eine neue Aktion hinzu und legen Sie die Erweiterung auf Twitter. So senden Sie Edge Network-Ereignisse an Twitter, legen Sie die Aktionstyp nach Web-Konversion senden.

Nach der Auswahl scheinen zusätzliche Steuerelemente das Ereignis weiter zu konfigurieren. Sie müssen die Twitter Ereigniseigenschaften zu den zuvor erstellten Datenelementen hinzufügen. Weitere Informationen finden Sie im Abschnitt Twitter Web Conversions API.

Die Twitter Erstellen einer Konversionsereignisregel.

Benutzeridentifizierung

Feldname
Beschreibung
Beispiel
Erforderlich
Twitter Klick-ID
Twitter Klick-ID wie von der Clickthrough-URL analysiert.
26l6412g5p4iyj65a2oic2ayg2
Erforderlich, wenn keine andere Kennung hinzugefügt wird.
E-Mail
Eine mit SHA256 gehashte E-Mail-Adresse. Der Text muss in Kleinbuchstaben geschrieben werden und alle nachfolgenden oder führenden Leerzeichen müssen vor dem Hashing entfernt werden.
eventforwarding@example.com
Erforderlich, wenn keine andere Kennung hinzugefügt wird.
Phone
Phone dient als ID zum Abgleich des Konversionsereignisses. Die Telefonnummer muss das Format E164 aufweisen [+][Ländercode].[Bereichscode][local phone number] vor dem Hashing.
+911234567875
Erforderlich, wenn keine andere Kennung hinzugefügt wird.

Konversionsdaten

Feldname
Beschreibung
Beispiel
Erforderlich
Konvertierungszeit
Datum/Uhrzeit als Zeichenfolge in ISO 8601 oder in yyyy-MM-dd'T'HH:mm:ss:SSSZ Format.
2022-02-18T01:14:00.603 Z
Ja
Ereignis-ID
Die base-36-ID eines bestimmten Ereignisses. Diese ID sollte mit einem vorkonfigurierten Ereignis übereinstimmen, das in Ihrer Twitter Anzeigenkonto. Dies wird als ID für das entsprechende Ereignis im Ereignismanager bezeichnet.
o87ne oder tw-o8z6j-o87ne (tw-pixel_id-event-id)
Ja
Anzahl der Elemente
Die Anzahl der Artikel, die im Ereignis gekauft werden. Hierbei muss es sich um eine positive Zahl größer als 0 handeln.
4
Nein
Währung
Die Währung der Artikel, die im Ereignis gekauft werden. Dies wird in ISO-4217 ausgedrückt und falls nicht angegeben, ist der Standardwert USD.
USD
Nein
Wert
Der Preiswert der Artikel, die im Ereignis gekauft werden.
100,00
Nein
Konversions-ID
Ein Bezeichner für ein Konversionsereignis, das zur Deduplizierung zwischen Web-Pixel- und Konversions-API-Konvertierungen im selben Ereignis-Tag verwendet werden kann.
23294827
Nein
Beschreibung
Eine Beschreibung mit zusätzlichen Informationen zu den Konvertierungen.
Testkonversion
Nein

Validieren von Daten in Twitter

Überprüfen Sie nach der Erstellung und Ausführung der Ereignisweiterleitungsregel, ob das Ereignis, das an die Twitter Die API wird wie erwartet im Twitter Benutzeroberfläche.

Wenn die Ereigniskollektion und Experience Platform -Integration erfolgreich war, werden Ereignisse im Twitter Ereignismanager.

Die Twitter Ereignismanager

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Konversionsereignisse an gesendet werden Twitter über die Ereignisweiterleitung. Weitere Informationen zu diesen Technologien finden Sie in der offiziellen Dokumentation:

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