TikTok Events API
Vérifier les données reçues

Vérifier les données reçues

Après avoir configuré votre balise TikTok Events API, il est essentiel de vérifier les points suivants :

  • que votre conteneur serveur transmet correctement les événements à TikTok,
  • que le volume d'événements reçus par TikTok est cohérent et correspond à vos attentes,
  • que la qualité des données est suffisamment élevée pour permettre à TikTok d’associer vos événements clés à un utilisateur spécifique sur la plateforme.

Vérifier l'envoi des événements

Prévisualisation GTM Server-Side

La première étape est de vérifier que la balise TikTok Events API s'active correctement pour les événements définis dans le déclencheur.

Dans le mode de prévisualisation du conteneur serveur, assurez-vous que la balise TikTok Events API se déclenche bien pour un événement spécifique (dans cet exemple, nous vérifions son activation pour l’événement view_item). Confirmez qu'elle apparaît dans la section Tags Fired et que son statut est indiqué comme Succeeded.

Vérifier le déclenchement de la balise Tiktok Events API en server-side

Dans la prévisualisation, cliquez sur la balise Tiktok Events API pour vérifier que des requêtes ont bien été envoyées à Tiktok via l'API d'événements.

Vérifier l'envoi des données via Tiktok Events API

Côté Addingwell via Tag Health : requêtes en succès

Accédez à l'onglet Tag Health depuis votre espace de travail Addingwell. Commencez par analyser le nombre de requêtes envoyées pour l'API d'événements TikTok sur une période donnée, ainsi que le taux de réussite de ces requêtes. Cliquez sur TikTok Events API pour obtenir des détails plus approfondis.

Vérifier les requêtes Tiktok Events API sur l'espace de travail Adddingwell

Cet écran affiche les détails des événements transmis par votre serveur à l'API d'événements Tiktok, ainsi que le taux de réussite des requêtes, qui, dans notre exemple, est de 99,99%.

Pourcentage de succès dans les requêtes Tiktok Events API sur l'espace de travail Adddingwell

Pour examiner les requêtes en erreur, nous allons approfondir en récupérant les logs de ces erreurs. Retournez à l'onglet Tag Health et faites défiler vers le bas pour accéder aux logs de chaque balise en place sur votre serveur. Cliquez sur les Logs de l'API Tiktok.

Détail des logs sur les requêtes Tiktok Events API via l'espace de travail Adddingwell

Par exemple, dans les logs d'erreurs de notre compte, l'erreur la plus fréquente (6 occurrences) est due au fait que l'API de Tiktok n'était pas disponible. Dans cet exemple, à part attendre que l'API devienne à nouveau disponible vous ne pouvez pas faire grand chose de plus.

Vérification des logs sur les requêtes en erreur pour Tiktok Events API via l'espace de travail Adddingwell

Vérifier la qualité des données reçues

Envoyer vos événements de conversion à la plateforme TikTok est une étape essentielle, mais ce processus peut être optimisé en intégrant des données utilisateur (comme une adresse email, un numéro de téléphone) à ces événements. Ces informations permettent à TikTok d'associer les données transmises depuis votre serveur à un utilisateur réel dans leur base de données, améliorant ainsi la précision du suivi des conversions.

Cela permet à TikTok de :

  • Attribuer plus précisément les conversions, en identifiant des conversions qui n’auraient autrement pas été associées à vos campagnes TikTok.
  • Optimiser vos enchères de manière plus efficace, en s’appuyant sur des données de meilleure qualité.

Pour un guide détaillé sur l’envoi fiable de données utilisateur en server-side, consultez notre documentation à ce sujet.

Côté Addingwell via Data Monitoring

Accédez au menu Data Monitoring depuis votre espace de travail Addingwell. Cet écran vous permet de visualiser l’ensemble des données utilisateur traitées par votre client GA4 et disponibles pour vos événements côté serveur. Par exemple, vous pouvez voir que les données d’email sont présentes dans 25,9 % des événements reçus côté serveur. Pour consulter la liste des événements où les emails des utilisateurs ont bien été transmis, cliquez sur l’icône de recherche pour obtenir plus de détails.

Vérifier la qualité des données reçues Data monitoring Addingwell

Sur cet écran, vous pouvez voir le pourcentage de présence des données utilisateur email dans vos événements côté serveur.

Vérifier la qualité des données utilisateurs dans Addingwell

Dans notre exemple, les données d’email utilisateur sont présentes dans 100 % des événements de type purchase, mais seulement dans 35,8 % des événements add_to_cart. Cela reste cohérent avec notre entonnoir de conversion, car l’email n’est pas toujours requis ou disponible à l’étape d’ajout au panier.

La qualité des données transmises est bonne, car les événements contiennent les informations utilisateur pertinentes et disponibles, assurant un suivi efficace.

Félicitations

Vous avez terminé la configuration de la TikTok Events API, et vous avez vérifié que vos données sont correctement transmises à TikTok et que leur qualité est conforme aux attentes. Vous êtes maintenant prêt à optimiser vos campagnes publicitaires avec des données fiables et précises.

Si vous avez rencontré le moindre problème durant ces étapes, n'hésitez pas à contacter notre équipe support.