Übersicht über die Web-Events-API-Erweiterung TikTok

Die API TikTok events ist eine sichere Benutzeroberfläche der Edge Network-Server-API, über die Sie Informationen über Benutzeraktionen auf Ihren Websites direkt an TikTok weitergeben können. Sie können die Ereignisweiterleitungsregeln nutzen, um Daten von Adobe Experience Platform Edge Network an TikTok zu senden, indem Sie die TikTok Web Events API-Erweiterung verwenden.

Voraussetzungen für TikTok prerequisites

Um die TikTok Web-Events-API für die Verwendung der TikTok-Ereignis-API zu konfigurieren, müssen Sie einen TikTok-Pixelcode und ein Zugriffstoken generieren.

Sie müssen über einen gültigen TikTok -Wert für Ihr Geschäftskonto verfügen, um ein TikTok-Pixel mit der Partnereinrichtung zu erstellen. Rufen Sie die Seite TikTok für die Registrierung von Unternehmen auf, um sich zu registrieren und ein Konto zu erstellen, falls noch keines vorhanden ist.

Sie müssen bei Ihrem Geschäftskonto angemeldet sein, um TikTok Pixel mithilfe der Partnereinrichtung einzurichten. Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie zur Registerkarte Assets und wählen Sie Ereignis aus.
  2. Wählen Sie unter "Web Events"die Option Verwalten.
  3. Wählen Sie Web-Ereignisse einrichten.
  4. Wählen Sie Partner-Setup als Verbindungsmethode aus.

Weitere Informationen zum Einrichten des TikTok-Pixels finden Sie im Handbuch Erste Schritte mit Pixel .

Sie können ein Zugriffstoken generieren, sobald das Pixel erfolgreich erstellt wurde. Navigieren Sie dazu zum Pixel und wählen Sie die Registerkarte Einstellungen aus. Wählen Sie unter "Events API"die Option Zugriffs-Token generieren.

Weitere Informationen zum Einrichten des Pixel-Codes und Zugriffs-Tokens finden Sie in der Anleitung TikTok Erste Schritte .

Installieren und Konfigurieren der Web-Events-API-Erweiterung TikTok install

Um die Erweiterung zu installieren, wählen Sie im linken Navigationsbereich Erweiterungen aus. Wählen Sie auf der Registerkarte Katalog die Erweiterung der TikTok-Web-Events-API und dann ​​ Installieren ​​ .

Der Erweiterungskatalog, der die Installation der Erweiterungskarte TikTok hervorhebt.

Geben Sie im nächsten Bildschirm die folgenden Konfigurationswerte ein, die Sie zuvor über den Anzeigen-Manager von TikTok generiert haben:

  • Pixel-Code
  • Zugriffs-Token

Klicken Sie abschließend auf Speichern.

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

Der Aktionstyp TikTok Web Events API Event senden wurde für eine TikTok -Regel in der Datenerfassungs-Benutzeroberfläche ausgewählt.

Nach der Auswahl scheinen zusätzliche Steuerelemente das Ereignis weiter zu konfigurieren, wie unten beschrieben. Wählen Sie nach dem Abschluss Änderungen beibehalten aus, um die Regel zu speichern.

Web-Ereignisse und -Parameter

Web-Ereignisse und -Parameter enthalten allgemeine Informationen zum Ereignis. Standardereignisse werden über die TikTok -Integrations-Tools hinweg unterstützt und können für die Berichterstellung , die Optimierung für Konversionen und die Erstellung von Zielgruppen verwendet werden.

Eingabe
Beschreibung
Ereignisname
Der Name des Ereignisses. Hierbei handelt es sich um Aktionen mit vordefinierten Namen, die von TikTok erstellt werden und ein erforderliches Feld sind. Weitere Informationen zu unterstützten Ereignissen finden Sie in der Dokumentation zur TikTok Marketing-API .
Ereigniszeit
Datum/Uhrzeit als Zeichenfolge im ISO 8601- oder im yyyy-MM-dd'T'HH:mm:ss:SSSZ-Format. Dies ist ein erforderliches Feld.
Ereignis-ID
Die eindeutige ID, die von Advertisern zur Angabe jedes Ereignisses generiert wurde. Dies ist ein optionales Feld, das zur Deduplizierung verwendet wird.

Der Abschnitt Web Events and Parameters, der Beispieldaten in die Felder eingibt.

Benutzerkontextparameter

Benutzerkontextparameter enthalten Kundeninformationen, mit denen Webbesucherereignisse mit TikTok Benutzern abgeglichen werden. Durch die Einbeziehung mehrerer Typen von übereinstimmenden Daten können Sie die Genauigkeit von Targeting- und Optimierungsmodellen erhöhen.

Eingabe
Beschreibung
IP-Adresse
Öffentliche IP-Adresse des Browsers ohne Hash. IPv4- und IPv6-Adressen werden unterstützt. Sowohl die vollständige als auch die komprimierte Form von IPv6-Adressen werden erkannt.
Benutzeragent
Der Benutzeragent ohne Hash vom Gerät des Benutzers.
E-Mail
E-Mail-Adresse des Kontakts, der mit dem Konversionsereignis verbunden ist.
Telefon
Die Telefonnummer muss im E164-Format [+][Ländercode][Bereichscode][local phone number] vorliegen, bevor ein Hashing erfolgt.
Cookie-ID
Wenn Sie das Pixel SDK verwenden, wird automatisch eine eindeutige Kennung im _ttp -Cookie gespeichert, wenn Cookies aktiviert sind. Der Wert _ttp kann extrahiert und für dieses Feld verwendet werden.
Externe ID
Jede eindeutige Kennung wie Benutzer-IDs, externe Cookie-IDs usw. muss mit SHA256 gehasht werden.
TikTok-Klick-ID
Die ttclid , die der URL der Landingpage bei jeder Auswahl einer Anzeige auf TikTok hinzugefügt wird.
„Seiten-URL“
Die Seiten-URL zum Zeitpunkt des Ereignisses.
Seiten-Referrer-URL
Die URL der verweisenden Seite.

Der Abschnitt User Context Parameters, der Beispieldaten in die Felder eingibt.

Eigenschaftsparameter

Verwenden Sie die Eigenschaftenparameter, um zusätzliche unterstützte Eigenschaften zu konfigurieren.

Eingabe
Beschreibung
Price
Die Kosten eines einzelnen Artikels.
Menge
Die Anzahl der Artikel, die im Ereignis gekauft werden. Hierbei muss es sich um eine positive Zahl größer als 0 handeln.
Content-Typ
Der Objekteigenschaft content_type muss entweder product oder product_group ein Wert zugewiesen werden, je nachdem, wie Sie Ihren Daten-Feed bei der Einrichtung Ihres Produktkatalogs konfigurieren.
Inhalts-ID
Eine eindeutige Kennung des Produktelements.
Inhaltskategorie
Kategorie der Seite/des Produkts.
Inhaltsname
Name der Seite/des Produkts.
Währung
Die Währung der Artikel, die im Ereignis gekauft werden. Dies wird in ISO-4217 ausgedrückt.
Wert
Der Gesamtpreis der Bestellung. Dieser Wert entspricht dem Preis * der Menge.
Beschreibung
Eine Beschreibung des Elements oder der Seite.
Abfrage
Die Textzeichenfolge, die zum Nachschlagen eines Produkts verwendet wurde.
Status
Der Status einer Bestellung, eines Artikels oder eines Dienstes. Beispiel: "gesendet".

Der Abschnitt Properties Parameters, der Beispieldaten in die Felder eingibt.

Ereignisdeduplizierung deduplication

Das Pixel TikTok muss zur Deduplizierung eingerichtet werden, wenn Sie sowohl das TikTok Pixel SDK als auch die TikTok Web-Events-API-Erweiterung verwenden, um dieselben Ereignisse an TikTok zu senden.

Eine Deduplizierung ist nicht erforderlich, wenn vom Client und vom Server unterschiedliche Ereignistypen gesendet werden, die sich nicht überschneiden. Um sicherzustellen, dass Ihre Berichterstellung keine negativen Auswirkungen hat, müssen Sie sicherstellen, dass jedes einzelne Ereignis, das vom TikTok Pixel SDK und der TikTok Web-Events-API-Erweiterung freigegeben wird, dedupliziert wird.

Stellen Sie beim Senden freigegebener Ereignisse sicher, dass jedes Ereignis eine Pixel-ID, Ereignis-ID und einen Namen enthält. Duplizierte Ereignisse, die innerhalb von fünf Minuten aufeinander folgen, werden zusammengeführt. Wenn das Datenfeld beim ersten Ereignis fehlte, wird es mit dem nachfolgenden Ereignis kombiniert. Alle doppelten Ereignisse, die innerhalb von 48 Stunden empfangen wurden, werden entfernt.

Weitere Informationen zu diesem Prozess finden Sie in der Dokumentation zu TikTok unter Ereignisdeduplizierung .

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie serverseitige Ereignisdaten mit der Web-Events-API-Erweiterung TikTok an TikTok gesendet werden. Weiterführende Informationen zu Ereignisweiterleitungsfunktionen in Adobe Experience Platform finden Sie in der Übersicht über die Ereignisweiterleitung.

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