Ü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:
- Navigieren Sie zur Registerkarte Assets und wählen Sie Ereignis aus.
- Wählen Sie unter "Web Events"die Option Verwalten.
- Wählen Sie Web-Ereignisse einrichten.
- 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 .
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.
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.
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.
yyyy-MM-dd'T'HH:mm:ss:SSSZ
-Format. Dies ist ein erforderliches Feld.
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.
_ttp
-Cookie gespeichert, wenn Cookies aktiviert sind. Der Wert _ttp
kann extrahiert und für dieses Feld verwendet werden.ttclid
, die der URL der Landingpage bei jeder Auswahl einer Anzeige auf TikTok hinzugefügt wird.
Eigenschaftsparameter
Verwenden Sie die Eigenschaftenparameter, um zusätzliche unterstützte Eigenschaften zu konfigurieren.
product
oder product_group
ein Wert zugewiesen werden, je nachdem, wie Sie Ihren Daten-Feed bei der Einrichtung Ihres Produktkatalogs konfigurieren.
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.