Skip to main
← Sommaire

Connecter TikTok Events API

Envoyer vos events server-side à TikTok Events API avec un Pixel ID + token d'accès, déduplication event_id incluse.

Walityk envoie vos events à la TikTok Events API (v1.3), côté serveur, avec un event_id par event pour la déduplication avec le pixel TikTok navigateur.

Compter 5 minutes.

Prérequis

  • Un compte TikTok Ads Manager avec un pixel Web créé.

1. Récupérer Pixel ID et Access Token

  1. TikTok Ads Manager → Outils → Événements → Événements Web → sélectionnez votre pixel.
  2. Le Pixel ID (format C4XXXXXXXXXXXXXXXX) s’affiche dans les détails du pixel.
  3. Onglet Paramètres du pixel → Generate Access Token (API Events). Copiez le token.

2. Configurer la destination

  1. Dashboard Walityk → Destinations → votre site → carte TikTok Events API.
  2. Collez le Pixel ID et l’Access Token.
  3. Optionnel : un Test Event Code pour visualiser les events dans le debug d’Events Manager sans polluer les stats. Retirez-le après les tests.
  4. Enregistrer.

3. Déduplication avec le pixel navigateur

  • Si la « Déduplication pixels » Walityk est activée sur le site, le tag initialise le pixel TikTok (ttq) et re-déclenche chaque event navigateur avec le même event_id que la copie serveur. Retirez vos appels ttq.track(…) manuels pour éviter le double comptage.
  • Sans pixel navigateur, la Events API seule fonctionne très bien.

4. Vérifier

  1. Destinations → votre site → TikTok : journal des envois (chaque hit avec son statut HTTP).
  2. Côté TikTok : Events Manager → votre pixel → les events arrivent avec le canal « Serveur ».

Erreurs fréquentes

  • HTTP 401/403 : token invalide ou expiré → régénérez-le dans les paramètres du pixel.
  • HTTP 400 : Pixel ID erroné (vérifiez le format C4…, ce n’est pas l’ID du compte pub).
  • Events « ignorés » dans le journal = consentement publicitaire refusé. Normal.

Pour aller plus loin

Besoin d’aide ? hi@walityk.com.