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 ID d'application TikTok pour utiliser le SDK d'événements d'application 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 prend désormais en charge la configuration hybride avec des PMM dans le même compte. Pour intégrer le SDK, vous pouvez soit créer un nouveau compte publicitaire TikTok, soit utiliser votre compte PMM existant.

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

Étape 1 : Créez une application ou utilisez une application existante et générez un ID d'application TikTok et un code secret d'application

Option 1 : Ajouter le SDK à une application connectée au PMM (configuration hybride)

1. Connectez-vous à TikTok Ads Manager.

2. Cliquez sur l'onglet Outils, puis sur Gestionnaire d'événements.

3. Sélectionnez Sources de données, puis l'application à laquelle vous souhaitez ajouter une connexion au SDK.

   
   
   

4. Accédez à l'onglet Paramètres et cliquez sur Choisir un partenaire sous SDK d'événements de l'application TikTok.

   
   
   

5. Suivez la procédure et ajoutez le SDK au compte. Générez votre ID d'application TikTok et votre Code secret de l'application.

   

Option 2 : Ajouter le SDK à une nouvelle application

1. Connectez-vous à TikTok Ads Manager.

2. Cliquez sur l'onglet Outils, puis sur Gestionnaire d'événements.

3. Sélectionnez Connecter une source de données dans la barre de navigation de gauche, puis Application.

   
   
   

4. Sélectionnez SDK TikTok pour connecter votre application.

   
   
   

5. Saisissez les détails de votre application et créez l'application. Suivez la procédure et générez votre ID d'application TikTok et votre Code secret de l'application.

   
   
   

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

1. Pour initialiser le SDK, il vous faut préparer l'ID de l'application, l'ID d'application TikTok et le Code secret de l'application que vous générez à l'étape 1.

   1. Démonstration de l'ID de l'application et de l'ID d'application TikTok :

      
      
      

   2. Démonstration du Code secret de l'application :

      
      
      

2. Téléchargez le SDK sur GitHub. Pour l'instant, nous prenons en charge le SDK iOS natif, le SDK Android natif et le SDK Unity.

Étape 3 : Configurez le postback d'événement via le SDK

1. Pour obtenir une liste complète des événements d'application standard que vous pouvez enregistrer et des événements automatiquement enregistrés, consultez la section É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, consultez les Documents pour développeurs sur le SDK d'événements d'application.

   1. Lancer l'application : Pour le lancement de l'application.

   2. Installer l'application : Pour le tout premier lancement de l'application.

   3. Rétention sur 2 jours : Pour la réouverture de l'application au lendemain du premier lancement.

   4. Achat : Paiements bien effectués pour des consommables/non-consommables/abonnements.

      1. Assurez-vous que le postback d'achat automatiquement enregistré correspond aux besoins de votre entreprise avant de l'activer. Pour en savoir plus, consultez Événement d'achat iOS automatiquement enregistré et Événement d'achat Android automatiquement enregistré.

Requête spéciale pour un événement d'achat automatiquement enregistré : Le SDK peut automatiquement enregistrer les transactions effectuées via StoreKit (iOS) ou Google Play Billing (Android). Pour transmettre davantage de propriétés et de paramètres ou si vous n'utilisez pas la passerelle de paiement native d'Apple ou de Google, nous vous recommandons d'utiliser le postback d'achat manuel.

Étape 4 : [iOS] Mesurez les événements SKAdNetwork

Dans l'environnement SKAdNetwork (SKAN), nous recommandons de n'avoir qu'un seul SDK générant des rapports sur les valeurs de conversion. Si vous utilisez un PMM ou un autre SDK pour mettre à jour les valeurs de conversion vers SKAdNetwork, assurez-vous d'ajouter disableSKAdNetworkSupport() à votre configuration pour éviter les conflits de mises à jour.

Déterminez si vous devez activer la mesure SKAdNetwork du SDK TikTok :

Si vous avez un PMM :

• Le SDK du PMM met à jour la valeur de conversion (VC) et vous avez l'intention d'utiliser le schéma SKAdNetwork du PMM : Désactivez la prise en charge de SKAdNetwork dans le SDK TikTok et ne téléversez pas de schéma dans le Gestionnaire d'événements de TikTok. (Votre PMM reste la seule source de vérité pour les mises à jour de la VC et les schémas.)

Si vous n'avez PAS de PMM :

Assurez-vous que la valeur de conversion SKAdNetwork n'est mise à jour que par un seul SDK dans votre application.

• Un autre SDK, qui n'est pas un SDK de PMM, met à jour la VC : Désactivez la prise en charge de SKAdNetwork dans le SDK TikTok, mais téléversez un schéma dans le Gestionnaire d'événements de TikTok. (TikTok utilisera votre schéma, mais ne procédera à aucune mise à jour redondante de la VC.)

• Le SDK TikTok est responsable de la mise à jour de la VC : Activez la prise en charge de SKAdNetwork dans le SDK TikTok et téléversez un schéma dans le Gestionnaire d'événements de TikTok. (TikTok devient le principal gestionnaire des mises à jour de la VC SKAdNetwork.)

Pour en savoir plus, consultez les Documents pour développeurs sur le SDK d'événements de l'application.

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

Avec la version 1.5.0 du SDK, les utilisateurs disposent de deux méthodes pour vérifier l'intégration du SDK avant la publication :

• (Recommandé) Un mode d'événements de test basé sur des jetons ; cette opération s'effectue entièrement dans le Gestionnaire d'événements de TikTok et ne nécessite pas de modifier le code.

• Mode débug manuel, nécessitant de modifier le code. Si vous utilisez le débug manuel, n'oubliez pas de désactiver le mode débug avant de publier votre application. Les événements générés à l'aide de l'un ou l'autre de ces outils passent par un pipeline de test et ne peuvent pas être utilisés pour la création de rapports.

  • Mode débug : ON

    

    Mode débug : OFF

    

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

L'événement SDK apparaît dans l'onglet Rapports du Gestionnaire d'événements, une fois que TikTok commence à recevoir le signal en temps réel du SDK. En mode test, les signaux ne s'affichent pas ici.

Étape 7 : Diffusez 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 d'événements d'application comme catégorie d'incident.