TikTok Events API v1.3

Tracking server-side des conversions TikTok

Vos conversions partent de votre serveur vers l'API Events de TikTok, pas du navigateur d'un visiteur qui bloque peut-être le pixel. L'achat est déclenché par la commande validée, pas par une page de remerciement que le client n'a pas forcément chargée.

Les identifiants sont normalisés puis hachés avant l'envoi : TikTok reçoit de quoi rapprocher la conversion d'une personne, jamais l'adresse elle-même.

Envoi depuis votre serveur Identifiants hachés avant l'envoi Hébergé dans l'UE
Le chemin d'un achat
Votre boutique La commande est validée côté serveur, pas sur une page de merci
Dispatcher DataFirefly Consentement vérifié, identifiants normalisés puis hachés
TikTok Events API v1.3 CompletePayment, avec la valeur et les produits
Pageview AddToCart CompletePayment SubmitForm
Le problème

Où une boutique perd ses conversions TikTok

Le pixel TikTok dépend d'un enchaînement fragile : le navigateur charge le script, l'exécute, et n'est bloqué par rien en chemin.

Le pixel ne se charge pas

Bloqueurs, navigateurs restrictifs, connexion mobile coupée en pleine navigation : l'événement n'existe jamais, et TikTok optimise sur ce qui lui reste.

L'achat dépend d'une page

Le pixel se déclenche sur la page de confirmation. Un client qui ferme l'onglet après le paiement a bien acheté, et la conversion, elle, n'est jamais partie.

Un appariement pauvre coûte du ROAS

Sans identifiant exploitable, TikTok ne rattache pas la conversion à un profil. La campagne apparaît moins performante qu'elle ne l'est, et l'algorithme apprend sur des données incomplètes.

Installation

Trois étapes, et rien à réécrire

Le connecteur s'installe sur votre boutique ; le reste se règle dans la console.

1 : Installer le connecteur

Le module PrestaShop, le plugin WooCommerce ou l'extension Shopware, téléchargés depuis votre console. Aucun code à écrire.

2 : Coller deux valeurs

Le code du pixel et le jeton, pris dans votre compte TikTok. Ils sont chiffrés au repos et ne réapparaissent jamais en clair.

3 : Vérifier dans Test Events

Vos événements arrivent dans l'écran de test de TikTok avant que vous basculiez en production.

Correspondances

Ce que TikTok reçoit, événement par événement

Douze de nos événements ont un nom TikTok officiel. Ceux qui n'en ont pas ne sont pas envoyés à cette destination : ils partent vers les autres, sans erreur ni perte.

Notre nom Nom chez la plateforme
page_viewPageview
view_contentViewContent
add_to_cartAddToCart
initiate_checkoutInitiateCheckout
add_payment_infoAddPaymentInfo
purchaseCompletePayment
leadSubmitForm
complete_registrationCompleteRegistration
searchSearch
add_to_wishlistAddToWishlist
contactContact
subscribeSubscribe
Les limites

Ce que TikTok ne saura pas faire

Chaque destination a un vocabulaire fermé, sauf une. Voici ce que cela implique ici : dit avant que vous le constatiez.

Les événements sans nom TikTok ne partent pas

TikTok n'a pas d'équivalent officiel pour une prise de rendez-vous, un partage ou une candidature. Ces événements ne lui sont pas envoyés : ils partent vers vos autres destinations, sans erreur. Nous préférons ne rien envoyer plutôt que de les forcer dans un nom voisin qui fausserait vos chiffres.

La qualité d'appariement dépend de vous

TikTok rapproche la conversion d'un profil grâce aux identifiants que votre boutique nous transmet. Une commande sans adresse e-mail part quand même, mais s'apparie moins bien. La console vous montre cette couverture jour par jour.

Vérifiable

Ce que la console vous montrera pour cette destination

Un argument que nous pouvons tenir parce que la page existe : vous n'avez pas à nous croire sur parole, vous regardez.

Chaque événement, avec le retour de la plateforme

L'Inspecteur liste ce qui est parti, ce que la destination en a fait, et la raison exacte d'un refus. Un identifiant invalide ou un jeton expiré se lit en clair, le jour même.

La couverture des identifiants

Combien de vos événements portaient de quoi rapprocher la conversion d'une personne. C'est ce qui décide de la qualité d'appariement, donc du ROAS que vous lirez chez l'annonceur.

Les périodes où plus rien n'est parti

L'anomalie la plus coûteuse et la plus discrète : un tableau de bord vide se lit comme une mauvaise semaine, jamais comme une panne. La console les nomme.

Prérequis

Ce qu'il vous faut

Deux valeurs, prises dans votre propre compte TikTok. Nous ne demandons jamais votre mot de passe.

Le code du pixel

TikTok Ads Manager → Assets → Events → Web Events → votre pixel. C'est l'« Event Source ID ».

Un jeton d'accès

Généré dans la configuration Events API du même écran. Il est chiffré au repos chez nous et n'apparaît jamais dans une page.

Un code d'événement de test (facultatif)

Pour voir vos événements arriver dans Test Events avant de basculer en production.

Confidentialité

Ce qui ne quitte pas notre infrastructure

Un produit qui manipule des données de clients doit dire où il s'arrête.

Les identifiants sont hachés avant l'envoi

Normalisés puis hachés chez nous : la destination reçoit une empreinte, jamais l'adresse e-mail ou le numéro de téléphone.

Le consentement décide, y compris côté serveur

Chaque événement porte l'état du consentement enregistré par votre bandeau. Un refus reste un refus : passer par le serveur ne contourne rien.

Hébergé dans l'Union européenne

Le dispatcher, la base et la console sont en Allemagne. Vos jetons sont chiffrés au repos et ne réapparaissent jamais en clair dans une page.

Sans surprise

Simple à installer, et sans coût qui s'ajoute

C'est un choix de conception, pas une promesse commerciale : il n'y a rien à héberger, et rien à débloquer palier par palier.

Un module, comme les autres

Le connecteur s'installe comme n'importe quelle extension de votre boutique. Rien à héberger : pas de conteneur à louer, pas de serveur à maintenir, pas de sous-domaine à configurer.

Toutes les destinations, à tous les forfaits

Y compris le gratuit. Les forfaits ne diffèrent que par le nombre de sites et d'événements, aucune destination n'est réservée à un palier, ce qui est pourtant l'usage.

Commencer ne coûte rien

Le forfait gratuit couvre un site et 10 000 événements par mois, sans carte bancaire. Rien ne casse si vous dépassez le quota.

Ce qu'on nous demande

Questions fréquentes

Le pixel TikTok reste-t-il nécessaire ?

Oui, et c'est voulu. Le pixel et l'envoi serveur portent le même identifiant d'événement, donc TikTok les rapproche au lieu de compter deux fois. Le pixel apporte le contexte navigateur, le serveur garantit que l'achat arrive même si le pixel n'a pas pu s'exécuter.

Mes conversions vont-elles être comptées en double ?

Non. La déduplication repose sur l'identifiant d'événement, que nous fixons à partir du numéro de commande. Deux envois pour la même commande portent le même identifiant : TikTok n'en garde qu'un.

Quelles données personnelles sont envoyées ?

Les identifiants sont normalisés puis hachés avant de quitter notre infrastructure : TikTok reçoit une empreinte, jamais l'adresse. Rien ne part sans le consentement que votre bandeau a enregistré.

Que se passe-t-il si TikTok refuse un événement ?

L'Inspecteur de votre console affiche le refus avec le message exact de TikTok. Un jeton expiré se voit le jour même, pas au moment du bilan mensuel.

Branchez cette destination en quelques minutes

Le forfait gratuit inclut toutes les destinations. Sans engagement et sans carte bancaire.