Qu'est-ce que l'API d'événements (API conversions) et comment l'activer dans le module ?

L’API d’événements permet au serveur de votre boutique d’envoyer des événements à TikTok. Elle complète le canal navigateur du Pixel, mais son fonctionnement dépend de l’intégration utilisée.

Dans ce module, l’envoi vers l’API est déclenché par une requête JavaScript de la boutique. L’activation de l’API ne garantit donc pas que tous les événements seront transmis si le navigateur, un script, un blocage ou la connexion empêchent ce déclenchement. Elle ne doit pas être présentée comme un moyen de contourner un refus de suivi.

Certains identifiants client sont hachés et la requête à TikTok utilise HTTPS ; cela ne signifie pas que toutes les données de l’événement sont chiffrées individuellement ou anonymes. Vérifiez les informations partagées, vos choix de consentement et l’information donnée aux visiteurs.

Configurer l’API dans le module

1. Créez la source Web et configurez son ID de Pixel dans le module. Le module utilise cette source et son script même si TikTok propose aussi d’autres intégrations API autonomes. Pour les annonces de catalogue, reliez la source aux catalogues concernés.
2. Dans TikTok Events Manager, ouvrez les paramètres de cette source et les instructions de l’API d’événements pour générer un jeton d’accès avec les droits appropriés.
3. Conservez le jeton dans un endroit sûr. Ne le publiez pas et ne l’incluez pas dans une capture ou une demande d’assistance.
4. Dans Pixel TikTok > Code Pixel, activez Activer l’API d’événements ?, collez le jeton dans Jeton d’accès API et enregistrez. cURL est requis sur le serveur ; contactez votre hébergeur s’il n’est pas disponible.

Le champ du jeton apparaît après activation de l’API ; aucun jeton n’est montré dans cet exemple.

Vérifier la réception

Contrôlez aussi le chargement du Pixel et les appels locaux avant tout choix de consentement, après un refus et après une acceptation. La présence d’un bandeau de cookies ne prouve pas, à elle seule, que cette intégration bloque les appels concernés. Le message de réussite d’une requête AJAX locale ne remplace pas la réception affichée dans TikTok.

Effectuez un parcours et une commande de test, puis contrôlez les événements dans TikTok. Vérifiez le canal serveur, le nom de l’événement, les produits, le montant, la devise et les éventuels doublons avec le Pixel. Une requête envoyée par la boutique ne prouve pas à elle seule que TikTok l’a acceptée.

En cas d’absence ou d’erreur, indiquez au support la version du module et le scénario testé sans transmettre votre jeton. Ne supposez pas que tous les événements disponibles sur TikTok sont automatiquement envoyés par le module.

Consultez les instructions officielles de l’API d’événements pour le fonctionnement de la plateforme.

Repères visuels de l’interface précédente : les libellés et la présentation peuvent varier. Suivez les étapes écrites ci-dessus.