Configurer le pixel TikTok et l'Events API sur Shopify

Comment ajouter le pixel TikTok à Shopify ?

Installez l’application TikTok pour Shopify, connectez vos comptes TikTok et choisissez un niveau de partage de données : Standard ajoute le TikTok Pixel, tandis qu’Enhanced et Maximum ajoutent l’Events API de TikTok et l’Advanced Matching, le tout sans code. Utilisez plutôt une application de suivi quand vous avez besoin de plusieurs pixels ou voulez voir chaque événement que TikTok reçoit, et gardez un seul expéditeur par pixel.

Le guide de configuration propre à TikTok (dernière mise à jour février 2025) décrit les étapes. Les pages de Shopify sur TikTok couvrent TikTok Shop plutôt que le pixel, donc le centre d’aide de TikTok fait référence ici.

1. Installez l’application de TikTok depuis le Shopify App Store, puis ouvrez TikTok sous Sales channels dans votre administration Shopify.
2. Connectez ou créez les comptes TikTok que l’application demande, y compris votre compte TikTok for Business et TikTok Ads Manager.
3. Choisissez votre niveau de partage de données : Standard, Enhanced ou Maximum.
4. Cliquez sur Create Pixel pour créer un nouveau pixel, ou sélectionnez-en un existant.
5. Cliquez sur Set Up, ajoutez l’emplacement de votre entreprise sous Company Information, et cliquez sur Confirm.

L’application installe le pixel pour vous, il n’y a donc rien à coller. Si le code de base de TikTok se trouve aussi dans votre thème ou un pixel personnalisé d’une configuration antérieure, retirez-le, sinon chaque événement est envoyé deux fois.

Quel niveau de partage de données choisir ?

Enhanced ou Maximum, sauf si vous voulez partager moins de données avec TikTok : seuls ces niveaux incluent l’Events API, que TikTok recommande de faire tourner aux côtés du pixel. Standard est le pixel seul.

Source : l’article de TikTok sur le partage de données (dernière mise à jour février 2025), vérifié le 24 septembre 2026.

L’Advanced Matching envoie des coordonnées client, comme l’adresse e-mail et le numéro de téléphone, avec vos événements pour que TikTok puisse les faire correspondre à des utilisateurs TikTok. Quand TikTok a étendu son intégration Shopify en août 2023, elle a demandé aux utilisateurs existants de vérifier dans l’application TikTok que leur niveau était Enhanced ou Maximum (TikTok). Les niveaux supérieurs partagent davantage de données de vos clients, assurez-vous donc que votre avis de confidentialité couvre ce que vous choisissez.

Qu’ajoute l’Events API ?

Une copie serveur à serveur de vos événements, pour qu’une conversion atteigne quand même TikTok quand le pixel navigateur échoue. TikTok le recommande comme un second canal à côté du pixel, pas un remplacement, avec les deux copies dédupliquées.

Le raisonnement de TikTok : les problèmes de connexion et les différences entre navigateurs coûtent au pixel certaines conversions, et avec les deux canaux en fonctionnement, les événements continuent d’arriver par l’un quand l’autre échoue (About Events API, guide de configuration web). Un événement serveur n’est utile qu’à hauteur de ce qu’il porte :

• Un jeton d’accès. Vous le générez dans TikTok Events Manager, depuis les Settings de votre pixel.
• L’identifiant d’événement du pixel. Une copie serveur portant le même nom d’événement et le même identifiant d’événement que la copie navigateur ne compte qu’une fois. Sans eux, TikTok peut compter les deux.
• Les détails de correspondance. TikTok fait correspondre les événements web sur l’identifiant de clic TikTok (ttclid), les données d’Advanced Matching comme l’e-mail et le téléphone, et des signaux comme l’adresse IP et l’agent utilisateur. Son guide de configuration demande aussi d’envoyer l’identifiant de clic et les cookies, et d’activer les cookies propriétaires et l’Automatic Advanced Matching dans l’onglet Settings du pixel.

Ce que l’Events API ne peut pas faire, c’est faire revenir des clients qui ont refusé le suivi. Envoyer leurs événements depuis un serveur au lieu d’un navigateur ne les rend pas consentis pour autant. Plus sur ce que les événements serveur changent, et ce qu’ils ne changent pas : le suivi côté serveur sur Shopify.

Comment le configurer avec une application de suivi ?

Connectez l’application à votre pixel avec un jeton d’accès Events API, et assurez-vous que rien d’autre n’envoie à ce pixel. Une application de suivi mérite sa place quand vous faites tourner plusieurs pixels ou voulez voir chaque événement que TikTok reçoit.

cPixel, que nous développons, envoie les événements de TikTok depuis ses serveurs via l’Events API : pages vues, vues de produit, recherches, ajouts au panier, paiements, informations de paiement ajoutées et l’achat. Il construit l’achat depuis la commande Shopify, donc il ne dépend pas du chargement de la page de remerciement. Sa balise de boutique, qui s’exécute quand l’app embed de cPixel est activé dans votre thème, n’ajoute que la page vue, associée à la copie serveur sous un seul identifiant d’événement. Les événements portent les détails sur lesquels TikTok fait correspondre, là où cPixel les a : e-mail et téléphone hachés une fois que le client les a donnés, identifiants client et appareil Shopify hachés, le cookie _ttp, l’identifiant de clic ttclid, l’adresse IP et l’agent utilisateur.

Dans la configuration de cPixel, vous collez le Code du pixel (TikTok l’appelle le Pixel ID) et le Jeton d’accès Events API, que cPixel exige. Avec un Code d’événement de test (facultatif) enregistré, Tester la connexion envoie un vrai événement de test ; les vraies commandes ne portent jamais ce code. Une fois les événements en cours, la vue En direct de cPixel affiche chaque envoi avec la réponse de TikTok. Vous pouvez connecter plusieurs pixels TikTok, chacun configuré de la même façon. Étape par étape : connecter TikTok à cPixel.

Si l’application TikTok continue d’envoyer au même pixel, répondez Oui à la question de cPixel L’application officielle TikTok est-elle également installée ?, ce qui arrête l’envoi de cPixel vers ce pixel, ou connectez cPixel à un pixel différent. Gardez l’application TikTok elle-même dans tous les cas ; la règle est un seul expéditeur par pixel. Plus d’informations sur cPixel, qui envoie les achats Shopify à sept plateformes publicitaires.

Pourquoi TikTok compte-t-il les achats deux fois ?

Parce que deux copies d’un même achat ont atteint le même pixel sans porter le même nom d’événement et le même identifiant d’événement, donc TikTok n’a pas pu voir qu’il s’agissait d’une seule commande. Cela signifie généralement que deux outils envoient à un pixel.

La règle de TikTok, tirée de sa documentation développeur (vérifiée le 24 septembre 2026) : les événements portant le même pixel, le même nom d’événement et le même event_id sont des doublons. TikTok garde le premier, écarte les copies reçues dans les 48 heures suivantes et tente de fusionner les détails d’une copie reçue dans les 5 minutes dans le premier. Son article d’aide sur la déduplication des événements (dernière mise à jour mai 2025) donne la même fenêtre de 48 heures.

Quand la copie serveur n’a pas d’identifiant d’événement, TikTok se rabat sur le cookie _ttp, avec des limites : il n’écarte un événement serveur que si un événement navigateur portant le même pixel, le même événement et le même cookie est arrivé jusqu’à 5 minutes avant, et il n’écarte jamais un événement navigateur.

La règle de Meta et les vérifications pour un pixel Meta sont dans TikTok et Meta comptent les achats deux fois.

Comment tester les événements TikTok ?

Envoyez des événements de test depuis l’onglet Test Events de TikTok Events Manager pendant votre configuration. Passez ensuite une vraie commande et vérifiez la méthode de connexion de chaque événement sur l’onglet Overview du pixel : Browser, Server, ou Server & Browser.

1. Dans TikTok Events Manager, ouvrez votre pixel et son onglet Test Events, où vous pouvez tester les événements navigateur et serveur et filtrer entre eux (TikTok).
2. Pour les événements serveur, copiez le code de test depuis Test Events et envoyez-le comme test_event_code avec vos requêtes. Les événements de test apparaissent sous Event Activity, avec tout problème de payload. Retirez le code avant de passer en production (guide de vérification).
3. Passez une vraie commande.
4. Sur l’onglet Overview du pixel, lisez le Connection Method de chaque événement. Server & Browser compte une fois un événement reçu par les deux canaux. Si ce chiffre reste bas alors que les deux canaux envoient l’événement, vérifiez que les deux copies portent le même identifiant d’événement.
5. Vérifiez l’onglet Diagnostics, qui liste les problèmes trouvés par TikTok et leur gravité.

TikTok indique que les données d’événement ne s’affichent pas en temps réel. Laissez jusqu’à 10 minutes pour que les décomptes d’événements se mettent à jour, et jusqu’à 2 heures pour qu’un événement soit entièrement traité, avant de conclure que quelque chose est cassé (TikTok). Un événement ne s’affiche aussi comme actif qu’une fois qu’il s’est déclenché : dans un fil de la Communauté de 2023, un commerçant utilisant l’application de TikTok n’a vu que les pages vues marquées actives, les autres événements apparaissant après que des vues de produit et des ajouts au panier ont eu lieu.

Si TikTok Pixel Helper n’affiche rien, les causes sont les mêmes que chez Meta : consultez TikTok Pixel Helper n’affiche rien.

Questions fréquentes

CompletePayment ou Purchase ?

Purchase, pour toute configuration mise en place maintenant. TikTok a renommé CompletePayment en Purchase pour les événements web à partir du 1 mai 2025, et sa liste des événements pris en charge par l’Events API affiche désormais Purchase. Les configurations existantes n’ont pas besoin de changer : TikTok convertit automatiquement les anciens noms et affiche les nouveaux dans les rapports (événements standards mis à jour). Quel que soit le nom utilisé, envoyez le même depuis le pixel et l’Events API, car le nom fait partie de la clé de déduplication de TikTok. cPixel envoie toujours CompletePayment, que TikTok accepte et rapporte comme Purchase ; il n’envoie l’achat que depuis son serveur, donc il n’y a aucune copie navigateur dont le nom doive correspondre.

Qu’est-ce que ttclid ?

L’identifiant de clic de TikTok, un paramètre que TikTok ajoute à l’URL de votre page d’atterrissage quand quelqu’un clique sur votre publicité. Le TikTok Pixel l’enregistre dans un cookie propriétaire nommé ttclid, et TikTok recommande fortement de l’envoyer avec chaque événement de l’Events API pour que les conversions se relient au clic. Si vous le stockez vous-même, TikTok suggère de le conserver 28 jours ou plus et de le remplacer quand un clic plus récent arrive (Send TikTok Click ID). Son compagnon, le cookie _ttp, contient un identifiant pour le navigateur. TikTok indique que les deux cookies durent 13 mois depuis leur dernière utilisation, et que les cookies propriétaires sont activés par défaut dans les réglages du pixel (cookies).

Puis-je ajouter le pixel à la main ?

Oui, comme pixel personnalisé sous Settings → Customer events, qui atteint le paiement et la page de remerciement. Shopify note que les pixels personnalisés ont besoin de JavaScript et ne sont pas pris en charge par Shopify (custom pixels). Le code collé dans votre thème ne s’exécute que sur les pages hors paiement, et Additional scripts ne s’exécute plus sur la page de remerciement (l’arrêt des Additional scripts). Un pixel ajouté à la main n’envoie que depuis le navigateur, puisque l’Events API a besoin d’un serveur. Si vous déplacez un pixel, retirez l’ancienne copie : Shopify nomme le suivi du même événement plus d’une fois comme un problème de migration courant (migrating pixels).