Twitter-Erweiterung zur Ereignisweiterleitung

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

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

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 Network in Twitter verwenden möchten, um die Analyse- und Targeting-Funktionen von Kunden nutzen zu können.

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 mithilfe dieser Ereignisweiterleitungs-Erweiterung in Twitter.

Die Marketing- und Analyseteams können dann die Twitter’s-Funktionen nutzen, um zusätzliche Analysen durchzuführen und diese Benutzer für gezielte Werbekampagnen anzusprechen.

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

Twitter Voraussetzungen und Limits prerequisites

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

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

API-Limits guardrails

Die Twitter Web Conversions-API hat eine Quotenbegrenzung 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 mit Twitter zu verbinden, sind die folgenden Eingaben erforderlich:

Schlüsseltyp
Beschreibung
Consumer Key
​ Der API-Schlüssel der App für den Zugriff auf die Twitter-API. Eine Anleitung dazu finden Sie in der Dokumentation zu Twitter für api-Schlüssel und Geheimnisse .
Verbrauchergeheimnis
Mit dem API-Geheimnis kann Ihre App auf die Twitter -API zugreifen. Eine Anleitung dazu finden Sie in der Dokumentation zu Twitter für api-Schlüssel und Geheimnisse .
Token-Geheimnis
Das nicht ablaufende Token-Geheimnis Ihrer App, das zur Authentifizierung bei der Twitter-API über OAuth verwendet wird. Eine Anleitung dazu finden Sie in der Dokumentation zu Twitter unter Abrufen von Anwendungs-Zugriffstoken .
Zugriffs-Token
Das nicht ablaufende Zugriffstoken Ihrer App, das zur Authentifizierung bei der Twitter-API über OAuth verwendet wird. Eine Anleitung dazu finden Sie in der Dokumentation zu Twitter unter Abrufen von Anwendungs-Zugriffstoken .
Pixel-ID
Das Pixel Twitter ist ein Website-Tag, das auf Ihrer Website implementiert wird, um Site-Aktionen oder -Konversionen zu verfolgen. Eine Anleitung dazu finden Sie in der Twitter -Dokumentation zum Konversions-Tracking für Websites .

Installieren und Konfigurieren der Twitter -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 Erweiterungen in der linken Navigation aus. Wählen Sie auf der Registerkarte Katalog die Option Installieren auf der Karte für die Erweiterung Twitter aus.

Katalog, der die Installation der Twitter-Erweiterung hervorhebt.

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 die folgenden Konfigurationswerte ein, die Sie zuvor aus Twitter erfasst haben:

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

Klicken Sie abschließend auf Speichern.

Twitter Konfigurationsbildschirm für die 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 Twitter 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 Twitter fest. Um Edge Network-Ereignisse an Twitter zu senden, setzen Sie den Aktionstyp auf Web-Konversion senden.

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

Der Twitter, der eine Konversionsereignisregel erstellt.

Benutzeridentifizierung

Feldname
Beschreibung
Beispiel
Erforderlich
Twitter Klick-ID
Twitter Klick-ID, wie aus 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 im E164-Format [+][Ländercode][Bereichscode][local phone number] vorliegen, bevor ein Hashing erfolgt.
+911234567875
Erforderlich, wenn keine andere Kennung hinzugefügt wird.

Konversionsdaten

Feldname
Beschreibung
Beispiel
Erforderlich
Konvertierungszeit
Datum/Uhrzeit als Zeichenfolge im ISO 8601- oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ-Format.
2022-02-18T01:14:00.603Z
Ja
Ereignis-ID
Die base-36-ID eines bestimmten Ereignisses. Diese ID sollte mit einem vorkonfigurierten Ereignis übereinstimmen, das in Ihrem Twitter -Anzeigenkonto enthalten ist. 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

Daten mit Twitter validieren

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

Wenn die Ereigniserfassung und die Integration von Experience Platform erfolgreich waren, werden Ereignisse im Twitter Ereignismanager angezeigt.

Der Twitter Ereignismanager

Nächste Schritte

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

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