Qu’est-ce que la TikTok Events API ?
La TikTok Events API, l’API d’événements de TikTok, permet à un serveur d’envoyer les événements d’un site web directement à TikTok, en complément des événements que le pixel TikTok envoie depuis le navigateur du client. Pour les sites web, TikTok recommande de l’utiliser avec le pixel. Vous la verrez aussi appelée TikTok Conversions API.
Avec WeProfit, un achat Shopify arrive chez TikTok sous la forme de l’événement CompletePayment, envoyé depuis les serveurs de WeProfit vers le pixel que vous connectez. D’autres événements de la boutique empruntent le même chemin, comme ViewContent, AddToCart et InitiateCheckout ; le tableau plus bas sur cette page les liste.
TikTok a renommé CompletePayment en Purchase en mai 2025. Il accepte toujours CompletePayment, le convertit de son côté et l’affiche comme Purchase dans les rapports, la création d’audiences et l’optimisation. TikTok est inclus dans chaque forfait WeProfit, avec Meta, Google, Pinterest, Snapchat, X Ads, Microsoft (programme pilote), Reddit, LinkedIn et Taboola.
Connecter TikTok dans WeProfit
Connectez d’abord votre boutique Shopify et activez l’intégration d’application WeProfit, pour que les événements de la vitrine parviennent à WeProfit. L’envoi vers TikTok nécessite deux valeurs fournies par TikTok : l’ID du pixel, que TikTok appelle aussi code du pixel, et un jeton d’accès Events API. Aucun compte publicitaire TikTok n’est nécessaire pour l’envoi : il ne sert qu’à importer les dépenses publicitaires.
- Dans le Gestionnaire de publicités TikTok, survolez le menu Outils, ouvrez le Gestionnaire d’événements, puis sélectionnez le pixel de votre site web. Copiez son ID.
- Ouvrez l’onglet des paramètres du pixel, faites défiler jusqu’à la partie Events API et générez un jeton d’accès. Copiez le jeton.
- Dans WeProfit, ouvrez Réseaux publicitaires > TikTok et sélectionnez « Ajouter une destination ». Saisissez l’ID du pixel (code du pixel) et le jeton d’accès Events API. Le libellé est facultatif et vous aide si vous connectez plusieurs pixels.
- Laissez les conditions vides pour envoyer tous les événements éligibles, ou ajoutez des conditions, par exemple sur le pays, l’événement, la valeur de la commande, le produit, l’URL de la page ou la campagne, pour limiter ce que ce pixel reçoit. Sélectionnez ensuite « Connecter TikTok ».
- Pour tester d’abord, ouvrez l’outil de test des événements du pixel dans le Gestionnaire d’événements TikTok, copiez son code d’événement de test dans le champ « Code d’événement de test » de la destination, enregistrez, puis sélectionnez « Envoyer un test ». WeProfit indique si TikTok a accepté le test.
- Tant qu’un code d’événement de test est défini, tous les événements réels de ce pixel vont dans l’outil de test de TikTok et peuvent ne pas compter pour vos publicités. WeProfit affiche « Mode test activé » et désactive le code 24 heures après que vous l’avez défini ; effacez le code quand vous avez fini vos tests, et les événements redeviennent réels.
Quels événements de la boutique parviennent à TikTok ?
Sur Shopify, l’intégration d’application WeProfit enregistre les pages vues, les consultations de produits et les ajouts au panier sur la vitrine, et le pixel web de WeProfit enregistre les étapes du paiement. WeProfit les envoie à TikTok depuis son serveur au fur et à mesure qu’il les traite. Les achats proviennent du webhook de commande de Shopify, et l’achat de chaque commande est envoyé au plus une fois à chaque pixel connecté.
Les événements de la vitrine parviennent à WeProfit par le proxy d’application de Shopify, sur le propre domaine de votre boutique : les listes de blocage qui visent les domaines de suivi ne les arrêtent donc généralement pas. Cela ne veut pas dire que chaque visite est enregistrée.
Les recherches, les prospects, les inscriptions et les événements personnalisés n’atteignent TikTok que si votre site les envoie avec l’appel track de WeProfit ; sur Shopify, ils ne sont pas captés automatiquement. Un événement personnalisé part sous son propre nom, limité à 64 caractères. Les prospects partent en SubmitForm, que TikTok a renommé Lead en mai 2025 et convertit de la même façon que CompletePayment. Les remboursements, les retraits du panier et les événements de l’étape de livraison ne sont pas envoyés à TikTok, et rien ne retire un achat que TikTok a déjà reçu.
Chaque achat contient le total de la commande tel que Shopify l’indique, dans la devise de la commande, les produits sous forme de lignes avec leur ID, leur quantité, leur prix unitaire et leur titre, ainsi que l’ID de commande Shopify. Vérifiez dans le Gestionnaire d’événements TikTok lesquels de ces événements votre pixel reçoit.
| Événement de la boutique | Événement TikTok |
|---|---|
| Page view | Pageview |
| Product or content view | ViewContent |
| Search | Search |
| Add to cart | AddToCart |
| Checkout started | InitiateCheckout |
| Payment information added | AddPaymentInfo |
| Purchase | CompletePayment |
| Lead | SubmitForm |
| Sign up | CompleteRegistration |
Les informations client envoyées avec chaque événement
Pour aider TikTok à associer un événement à un utilisateur TikTok, WeProfit envoie les informations dont dispose l’événement. Pour un achat Shopify, il s’agit de l’adresse e-mail et du numéro de téléphone de l’acheteur, tirés de la commande et hachés en SHA-256, ainsi que de l’adresse IP et de l’agent utilisateur. Quand WeProfit en dispose, il envoie aussi l’ID de clic TikTok (ttclid), le cookie _ttp et un ID externe, c’est-à-dire un hachage SHA-256 de l’ID de visiteur WeProfit. TikTok ne reçoit de WeProfit ni nom ni adresse.
Les événements navigateur ne contiennent ni adresse e-mail ni numéro de téléphone, sauf si votre site identifie le client avec l’appel identify de WeProfit, et le pixel web Shopify de WeProfit n’envoie aucune information client. L’adresse IP et l’agent utilisateur partent non hachés, comme l’attend l’Events API.
TikTok ajoute l’ID de clic ttclid à l’URL de votre page de destination quand quelqu’un clique sur votre publicité, et WeProfit le lit à cet endroit. Le cookie _ttp vient du propre pixel de TikTok : WeProfit ne charge pas ce pixel, donc le cookie n’existe que si votre boutique l’utilise.
Pixel TikTok et Events API : éviter le double comptage
TikTok ne compte qu’une fois la copie navigateur et la copie serveur d’un même événement quand les deux parviennent au même pixel avec le même nom d’événement et le même ID d’événement. Il garde la première copie reçue et fusionne ou écarte les copies qui arrivent ensuite dans les 48 heures.
WeProfit ne charge pas le pixel de TikTok. Il envoie les événements TikTok depuis son serveur uniquement, chacun avec son propre ID d’événement. Un achat part sous la forme pur_ suivi d’un code de boutique et de l’ID de commande Shopify, par exemple pur_a1b2c3d4-6012345678901, une fois par commande et par pixel, et une nouvelle tentative réutilise cet ID.
Un autre outil qui envoie au même pixel, comme l’application TikTok pour Shopify ou un code de pixel dans votre thème, transmet ses propres ID d’événement. Ils ne correspondront pas à ceux de WeProfit : TikTok ne peut donc pas apparier les deux copies par ID d’événement et peut compter l’événement deux fois. L’application TikTok pour Shopify, par exemple, partage les événements de votre boutique avec votre pixel selon le niveau de partage des données que vous choisissez : « Standard » utilise le pixel TikTok, « Amélioré » et « Maximum » ajoutent l’Events API.
Avant de connecter un pixel, listez tous les outils qui lui envoient des événements et décidez lequel envoie chaque événement. Gardez un seul émetteur d’achats par pixel, puis comparez un achat de test dans le Gestionnaire d’événements TikTok avec le journal d’envoi WeProfit.
Vérifier l’envoi dans le journal d’envoi CAPI
Ouvrez Réseaux publicitaires > TikTok dans WeProfit et faites défiler jusqu’au « Journal d’envoi CAPI ». Il liste chaque événement côté serveur envoyé à TikTok, avec les colonnes Date, Événement, Destination, ID d’événement, Statut, Tentatives et Erreur, et vous pouvez filtrer par destination, par événement et par statut. Le filtre Purchase trouve aussi CompletePayment.
Le journal affiche l’ID d’événement propre à WeProfit, par exemple pur_6012345678901 ; TikTok le reçoit avec le code de boutique, par exemple pur_a1b2c3d4-6012345678901. Le journal n’a pas de colonne de valeur : vérifiez la valeur d’un achat sur la page Événements de WeProfit. La page Commandes indique l’envoi de chaque commande vers chaque réseau connecté dans sa colonne Réseaux, et le widget « État du suivi » compte les envois côté serveur des dernières 24 heures en « Envoyés », « En cours / nouvelle tentative » et « Échecs ».
Le statut « envoyé » signifie que TikTok a accepté l’événement. Il ne prouve pas que TikTok l’a associé à un utilisateur ni qu’il a attribué la commande à une publicité. Si TikTok refuse le jeton d’accès, WeProfit met la connexion en pause et affiche une bannière ; un nouveau jeton ou un « Envoyer un test » réussi la réactive.
| Statut | Signification |
|---|---|
| en attente | En file d’attente, pas encore envoyé. |
| envoyé | TikTok a accepté l’événement. |
| échec | Un problème temporaire. WeProfit réessaie automatiquement pendant quelques heures, avec le même ID d’événement. |
| abandonné | WeProfit a abandonné : TikTok a refusé l’événement, avec son message dans la colonne Erreur, ou les tentatives sont épuisées. |
| ignoré (désactivé) | La destination était désactivée ou en pause quand le tour de l’événement est venu. Les événements ignorés pendant qu’elle est désactivée ne sont pas envoyés plus tard. |
| ignoré (avant installation) | L’achat d’une commande passée avant l’installation de WeProfit. Il n’est jamais envoyé. |
Les dépenses publicitaires TikTok à côté de vos commandes
L’envoi des conversions et les dépenses publicitaires sont deux connexions distinctes. Pour intégrer les dépenses TikTok à vos rapports de rentabilité, ouvrez Bénéfices > Dépenses publicitaires > Comptes publicitaires dans WeProfit, sélectionnez « Connecter un compte publicitaire » et choisissez TikTok Ads. « Connecter avec TikTok » demande un accès en lecture seule ; choisissez ensuite les comptes annonceurs, et indiquez si toutes les campagnes ou seulement certaines comptent pour cette boutique.
WeProfit importe les dépenses quotidiennes de TikTok par campagne, avec le nom des campagnes : 30 jours à la connexion, puis il relit chaque heure les 3 derniers jours, que TikTok peut encore corriger. Les dépenses dans une autre devise sont converties dans la devise de votre boutique au taux de référence du jour.
Les dépenses sont enregistrées par campagne et par jour : le ROAS, le POAS et le bénéfice après publicité descendent donc jusqu’à la campagne, pas jusqu’aux groupes d’annonces ni aux annonces. Sur la page Attribution, le bénéfice par campagne associe les dépenses TikTok synchronisées aux commandes attribuées, par ID ou par nom de campagne. Si vous saisissez aussi à la main des dépenses TikTok pour les mêmes jours, WeProfit vous avertit qu’elles risquent d’être comptées deux fois.
Le détail par campagne de vos publicités TikTok
WeProfit classe une visite dans TikTok Ads quand elle porte l’ID de clic ttclid de TikTok, ou utm_source=tiktok avec un support payant. Quand l’option URL Auto-attach de TikTok est activée, il lit aussi l’ID et le nom de la campagne. Pour le détail par groupe d’annonces et par annonce, ajoutez le modèle d’URL TikTok de WeProfit à l’URL de destination de chaque annonce, après le point d’interrogation. Pour les publicités Smart+, utilisez wpadid=__ADID_V2__ au lieu de wpadid=__CID__.
Les modèles ne s’appliquent qu’aux nouveaux clics. Dans l’attribution de WeProfit, un clic sur une publicité compte pendant 30 jours et le clic le plus récent l’emporte : cela fonctionne comme une attribution au dernier clic, avec une fenêtre de 30 jours pour les clics publicitaires. TikTok attribue les conversions selon ses propres paramètres d’attribution, donc ses chiffres et ceux de WeProfit peuvent différer pour les mêmes commandes.
utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&wpcid=__CAMPAIGN_ID__&wpasid=__AID__&wpadid=__CID__&wpplc=__PLACEMENT__