Une commande en boutique, un événement envoyé par le navigateur, un autre par le serveur. Ces deux copies ne constituent pas une erreur en soi. Le problème apparaît si l’intégration ne les reconnaît pas comme la même action. Il faut donc tester leur identité, au-delà de la connexion.
Events API transmet des événements à TikTok depuis vos systèmes. Si vous envoyez des copies de la même action via l’API et le Pixel, TikTok demande un event_id sur les deux parcours pour la déduplication. Vérifiez aussi le nom de l’événement et les conditions actuelles de rapprochement. [1]
1. Définissez la fiche de l’événement avec le développeur
Précisez quand l’achat a lieu, son nom, le système générant son identifiant, sa valeur, sa devise et l’heure de l’action. Recharger la page ou modifier une note ne doit pas créer une nouvelle identité d’achat pour la même transaction.
Vérifiez noms et paramètres dans les événements standard TikTok. Si l’activité distingue commande passée et achat finalisé, la cartographie doit le refléter. Renommer une colonne ne corrige pas une mauvaise définition commerciale. [2]
2. Testez les deux parcours et les nouvelles tentatives
Commencez par le navigateur seul, puis le serveur seul, puis une action envoyée par les deux. Comparez nom, identifiant, heure et valeur ; documentez le traitement des copies selon la documentation de l’intégration.
Simulez ensuite un échec temporaire et une nouvelle tentative appropriée. Une tentative supplémentaire n’est pas un achat supplémentaire : l’identité de l’action doit rester stable. Une valeur ou devise erronée demande une correction, pas le renvoi répété des mauvaises données.
Cas pratique : un registre de recette
Le développeur et le spécialiste de la mesure complètent ces cas fictifs dans un environnement de test autorisé.
| Scénario | Objectif du contrôle | Preuve d’acceptation proposée |
|---|---|---|
| Une action par deux parcours | Tester la déduplication | Explication documentée du traitement des deux copies |
| Nouvelle tentative | Préserver l’identité de l’action | Journal distinguant tentative et commande |
| Valeur erronée | Détecter une erreur de sens | Rejet ou diagnostic et action corrective |
| Retard simulé | Comprendre fraîcheur et limites d’acceptation | Heures de l’action et de réception, puis résultat |
| Action non autorisée au partage | Vérifier les contrôles de partage | Absence d’envoi, conformément au dispositif approuvé |
Ajoutez résultat réel, lien de preuve interne et responsable de correction. « L’API fonctionne » ne suffit pas : suivez le cas de la commande à l’envoi puis au diagnostic, sans confondre tentatives et commandes.
Ne placez ni jetons d’accès ni données clients dans un registre partagé. Utilisez des identifiants de test et respectez les droits d’accès et la politique de conservation.
3. Rapprochez diagnostics et journaux sources
Web Diagnostics indique les problèmes, leur gravité et le jeu de données concerné. Reliez chaque alerte à un cas : création, transformation ou transmission de l’événement ? Cela désigne le responsable et les contrôles à refaire. [3]
Mesurez aussi le délai entre action et envoi. Ne remplacez pas l’heure d’achat par celle d’une nouvelle tentative pour rendre le journal artificiellement récent. Définissez le traitement des échecs persistants.
4. Séparez recette technique et évaluation commerciale
Réussir les cas convenus ne prouve pas une hausse des ventes. Une meilleure couverture peut modifier les chiffres attribués : séparez cet effet de mesure du résultat commercial.
Livrez cartographie, registre, responsable d’exploitation et plan de retour arrière. Ne désactivez pas automatiquement le Pixel parce que l’API fonctionne ; l’envoi serveur ne remplace pas les contrôles de partage. La décision dépend des parcours, des données autorisées et du besoin commercial.
Sources officielles
- TikTok : déduplication des événements
- TikTok : événements standard et paramètres
- TikTok : Web Diagnostics
Documentation consultée le 16 octobre 2026. Fonctionnalités et conditions peuvent évoluer ; consultez les sources avant la mise en œuvre.
