TikTok Übersicht über die Web Events API-Erweiterung

Die TikTok Ereignis-API ist sicher Edge Network Server-API -Benutzeroberfläche, über die Sie Informationen für TikTok direkt über Benutzeraktionen auf Ihren Websites. Sie können die Ereignisweiterleitungsregeln nutzen, um Daten aus dem Adobe Experience Platform Edge Network nach TikTok durch Verwendung von TikTok Web Events API-Erweiterung.

Voraussetzungen für TikTok prerequisites

So konfigurieren Sie die TikTok Web-Events-API zur Verwendung der TikTok Ereignis-API erstellen, müssen Sie eine TikTok Pixelcode und Zugriffstoken.

Sie müssen über gültige TikTok für Geschäftskonten, um eine TikTok Pixel unter Verwendung der Partner-Einrichtung. Navigieren Sie zu TikTok für die Registrierungsseite für Unternehmen , um sich zu registrieren und ein Konto zu erstellen, falls Sie noch kein Konto haben.

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

  1. Navigieren Sie zum Assets Registerkarte und wählen Sie Ereignis.
  2. Wählen Sie unter "Web Events"die Option Verwalten.
  3. Auswählen Webereignisse einrichten.
  4. Auswählen Partnereinrichtung als Verbindungsmethode.

Siehe Erste Schritte mit Pixel Anleitung für weitere Informationen zum Einrichten der TikTok Pixel.

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

Siehe TikTok Erste Schritte für weitere Informationen zum Einrichten des Pixel-Codes und Zugriffs-Tokens.

Installieren und konfigurieren Sie die TikTok Web Events API-Erweiterung install

Um die Erweiterung zu installieren, wählen Sie Erweiterungen in der linken Navigation. Im Katalog auswählen, wählen Sie die TikTok Web Events API-Erweiterung und wählen Sie Installieren.

Der Erweiterungskatalog, der die TikTok Erweiterungskartenmarkierung.

Geben Sie im nächsten Bildschirm die folgenden Konfigurationswerte ein, die Sie zuvor aus TikTok Anzeigen-Manager:

  • Pixelcode
  • Zugriffstoken

Klicken Sie abschließend auf Speichern.

TikTok Konfigurationsbildschirm für 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 gesendet werden TikTok.

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

Die TikTok Web Events API-Ereignis senden Aktionstyp, der für eine TikTok in der Datenerfassungs-Benutzeroberfläche.

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

Web-Ereignisse und -Parameter

Web-Ereignisse und -Parameter enthalten allgemeine Informationen zum Ereignis. Standardereignisse werden in allen TikTok Integrations-Tools 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. Dies sind Aktionen mit vordefinierten Namen, die von TikTok und ist ein erforderliches Feld. Siehe Abschnitt TikTok Marketing-API Dokumentation finden Sie weitere Informationen zu unterstützten Ereignissen.
Ereigniszeit
Datum/Uhrzeit als Zeichenfolge in ISO 8601 oder in 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.

Die Web Events and Parameters -Abschnitt mit Beispieldaten in die Felder.

Benutzerkontextparameter

Benutzerkontextparameter enthalten Kundeninformationen, mit denen Webbesucherereignisse mit TikTok Benutzer. 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 das Format E164 aufweisen [+][Ländercode].[Bereichscode][local phone number] vor dem Hashing.
Cookie-ID
Wenn Sie das Pixel SDK verwenden, wird automatisch eine eindeutige Kennung im _ttp Cookie, wenn Cookies aktiviert sind. Die _ttp -Wert 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 bei jeder Auswahl einer Werbung auf der Landingpage zur URL der Landingpage hinzugefügt wird TikTok.
„Seiten-URL“
Die Seiten-URL zum Zeitpunkt des Ereignisses.
Seiten-Referrer-URL
Die URL der verweisenden Seite.

Die User Context Parameters -Abschnitt mit Beispieldaten in die Felder.

Eigenschaftenparameter

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

Eingabe
Beschreibung
Preis
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
Ein Wert von product oder product_group muss der Objekteigenschaft content_type zugewiesen sein, 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".

Die Properties Parameters -Abschnitt mit Beispieldaten in die Felder.

Ereignis-Deduplizierung deduplication

TikTok Pixel müssen für die Deduplizierung eingerichtet werden, wenn Sie beide TikTok Pixel-SDK und die TikTok Web-Events-API-Erweiterung zum Senden derselben Ereignisse an TikTok.

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

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.

Siehe TikTok Dokumentation zu Ereignisdeduplizierung Weitere Informationen zu diesem Prozess.

Nächste Schritte

In diesem Handbuch wurde beschrieben, wie Sie serverseitige Ereignisdaten an senden TikTok mithilfe der TikTok Web-Events-API-Erweiterung. Weitere Informationen zu den Ereignisweiterleitungsfunktionen finden Sie unter Adobe Experience Platform, siehe Übersicht über die Ereignisweiterleitung.

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