Comment intégrer le SDK d'événements d'application TikTok

Avant de commencer

Vous aurez besoin d'un compte publicitaire TikTok et d'un identifiant d'application TikTok pour utiliser le SDK d'événements TikTok pour Android et iOS. Vous pouvez utiliser votre application existante si vous en avez une ou créer une nouvelle application.

Remarque : Le SDK d'événements d'application TikTok ne prend pas en charge la double configuration avec des PMM dans le même compte publicitaire. Veuillez créer un nouveau compte publicitaire TikTok pour intégrer le SDK d'événements d'application dans le nouveau compte publicitaire sans PMM.

Comment intégrer le SDK d'événements d'application TikTok 

Étape 1 : Créer une application et générer un identifiant d'application TikTok dans le Gestionnaire d'événements TikTok.

1. Dans TikTok Ads Manager, accédez au Gestionnaire d'événements en cliquant sur l'onglet Outils, puis sur Événement.

2. Sélectionnez Connecter une source de données dans la barre de navigation en haut à droite.

3. Sélectionnez Application et continuez.

4. Saisissez les détails de votre application.

5. Sélectionnez Utiliser le SDK d'événements TikTok et continuez. L'application est maintenant créée.

6. Générez votre ID d'application TikTok.

Étape 2 : Suivez les instructions dans le Guide du Centre des développeurs TikTok pour intégrer le SDK d'événements d'application TikTok.

1. Pour une liste complète des événements d'application standard que vous pouvez enregistrer et des événements enregistrés automatiquement, voir : Événements standard.

2. Les événements enregistrés automatiquement sont listés ci-dessous. Remarque : vous pouvez désactiver l'enregistrement automatique des événements. Pour en savoir plus, voir les Documents pour développeurs sur le SDK d'événements d'application.

   1. LaunchApp : pour le lancement de l'application.

   2. InstallApp : pour le tout premier lancement de l'application.

   3. 2DRetention : quand l'application est réouverte le lendemain du premier lancement.

   4. Achat (iOS uniquement) : paiements bien effectués pour des consommables/non-consommables/abonnements.

3. [Pour iOS uniquement] Configurez le schéma des valeurs de conversion SKAN sur le Gestionnaire d'événements TikTok (TTEM).

   1. La configuration du schéma des valeurs de conversion sur le TTEM est obligatoire pour recevoir les conversions SKAN. TikTok prend en charge le mappage des valeurs de conversion 64 bits dans le mappage des schémas SKAN 3.0 et SKAN 4.0.

   2. [Bonnes pratiques] Dans l'environnement SKAdNetwork (SKAN), il est recommandé de n'avoir qu'un seul SDK générant des rapports sur les valeurs de conversion. Si vous utilisez un MMP ou un autre SDK pour mettre à jour les valeurs de conversion vers SKAdNetwork, vous devrez :

      1. Configurer le schéma de CV du TTEM avec les mêmes valeurs que celles définies sur le PMM.

      2. Appliquer disableSKAdNetworkSupport() pour éviter que le SDK d'événements d'application TikTok ne mette à jour les valeurs de conversion.

Étape 3 : Vérifiez les postbacks en temps réel avec le mode débug.

1. Vous pouvez vérifier et débugger les postbacks d'événements et les paramètres pertinents en temps réel en activant le mode débug dans l'application. Pour voir les événements, accédez à l'onglet Événement de test sous l'app dans le Gestionnaire d'événements TikTok.

Remarques :

• Les événements de test peuvent tester plusieurs ID d'application TikTok simultanément. Cependant, si plusieurs ID d'application TikTok sont testés simultanément, tous les événements de test de plusieurs ID d'application TikTok s'afficheront dans l'onglet Événement de test du compte publicitaire ayant le premier ID d'application TikTok associé.

• Une fois que vous avez vérifié la configuration de vos signaux, désactivez le mode débug avant de déposer l'application sur l'App Store/le Play Store. Les événements de test peuvent rester visibles pendant 72 heures une fois qu'ils sont éteints. Si les événements sont toujours visibles après 72 heures dans l'onglet Événement de test, le mode débug n'est pas encore désactivé. Voir l'exemple ci-dessous :

Mode débug : ON

Mode débug : OFF

Étape 4 : Publiez la nouvelle version de l'application avec le SDK TikTok sur l'App Store (iOS)/Play Store (Android).

Étape 5 : Exécutez votre campagne à l'aide du SDK TikTok.

Pour tout problème ou difficulté d'intégration du SDK d'événements d'application, vous pouvez déposer un ticket auprès de l'assistance à la clientèle. Veillez à sélectionner Mesures puis SDK Événements d'application comme catégorie d'incident.