So integrierst du das TikTok App-Events-SDK

Wichtige Hinweise

Du benötigst ein TikTok Anzeigenkonto und eine TikTok App-ID, um das TikTok App-Events-SDK für Android und iOS zu verwenden. Du kannst deine vorhandene App verwenden, falls du eine hast, oder eine neue App erstellen.

Hinweis: Das TikTok App-Events-SDK unterstützt nicht die duale Einrichtung mit MMPs im selben Anzeigenkonto. Erstelle bitte ein neues TikTok Anzeigenkonto, um das App-Events-SDK mit dem neuen Konto ohne MMP zu integrieren.

So integrierst du das TikTok App-Events-SDK

Schritt 1: Erstelle eine App und generiere eine TikTok App-ID im TikTok Event-Manager.

1. Gehe im TikTok Ads Manager zum Event-Manager, indem du auf die Registerkarte Tools und dann auf Ereignis klickst.

2. Wähle oben recht Datenquelle verbinden aus.

3. Wähle App aus und fahre fort.

4. Gib deine App-Details ein.

5. Wähle TikTok Events-SDK verwenden aus und fahre fort. Damit hast du deine App erstellt.

6. Generiere deine TikTok App-ID.

Schritt 2: Folge der Anleitung im TikTok Developer Center, um das TikTok App-Events-SDK zu integrieren.

1. Eine vollständige Liste der Standard-App-Ereignisse, die du protokollieren kannst, und der automatisch protokollierten Ereignisse findest du unter Standardereignisse.

2. Automatisch protokollierte Ereignisse sind unten aufgeführt. Hinweis: Du kannst automatisch protokollierte Ereignisse deaktivieren. Weitere Informationen findest du in der Entwicklerdokumentation zum App-Events-SDK.

   1. LaunchApp: Die App wird aufgerufen.

   2. InstallApp: Die App wird zum ersten Mal aufgerufen.

   3. 2DRetention: Die App wird am Tag nach dem ersten Öffnen erneut geöffnet.

   4. Kauf (nur iOS): Erfolgreich abgeschlossene Zahlungen für Verbrauchsprodukte/Gebrauchsprodukte/Abonnements.

3. [Nur für iOS] Konfiguriere das SKAN-Conversion-Wert-Schema im TikTok Event-Manager (TTEM).

   1. Die Einrichtung des Conversion-Wert-Schemas im TTEM ist erforderlich, um SKAN-Conversions zu empfangen. TikTok unterstützt die 64-Bit-Conversion-Wert-Zuordnung in SKAN 3.0 und SKAN 4.0.

   2. [Best Practice] In der SKAdNetwork (SKAN)-Umgebung wird empfohlen, nur ein SDK zu verwenden, um Berichte zu Conversion-Werten zu erstellen. Wenn du MMP oder ein anderes SDK verwendest, um Conversion-Werte im SKAdNetwork zu aktualisieren, musst du folgende Schritte ausführen:

      1. Konfiguriere das TTEM-Conversion-Wert-Schema mit denselben Werten, die im MMP eingerichtet wurden.

      2. Implementiere die Funktion disableSKAdNetworkSupport(), um zu vermeiden, dass das TikTok App-Events-SDK Conversion-Werte aktualisiert.

Schritt 3: Überprüfe Postbacks in Echtzeit im Debug-Modus.

1. Du kannst die Ereignis-Postbacks und die relevanten Parameter in Echtzeit überprüfen und debuggen, indem du den Debug-Modus in der App aktivierst. Ereignisse findest du auf der Registerkarte Testereignis unter der App im TikTok Event-Manager.

Hinweise:

• Du kannst mit Testereignissen mehrere TikTok App-IDs gleichzeitig testen. In dem Fall findest du die Testereignisse aller TikTok App-IDs auf der Registerkarte Testereignis in dem Anzeigenkonto, zu dem die erste verknüpfte TikTok App-ID gehört.

• Nachdem du die Einrichtung deiner Signale überprüft hast, schalte den Debug-Modus aus, bevor du die App im App Store bzw. Play Store veröffentlichst. Testereignisse können nach der Deaktivierung noch bis zu 72 Stunden lang sichtbar sein. Wenn die Ereignisse nach 72 Stunden immer noch auf der Registerkarte Testereignis zu sehen sind, wurde der Debug-Modus noch nicht deaktiviert. Hier ein Beispiel:

Debug-Modus: EIN

Debug-Modus: AUS

Schritt 4: Veröffentliche die neue App-Version mit dem TikTok SDK im App Store (iOS) bzw. Play Store (Android).

Schritt 5: Führe deine Kampagne mit dem TikTok SDK aus.

Wenn es Probleme bei der Integration des App-Events-SDK gibt, kannst du ein Ticket beim Kundensupport einreichen. Achte darauf, Messung und dann App-Events-SDK als Problemkategorie auszuwählen.