# Tracking server-side des conversions TikTok

> Envoyez vos conversions à l'API Events de TikTok depuis votre serveur : achat déclenché par la commande validée, identifiants hachés, hébergé dans l'UE.

- Page d'origine : https://server-side.datafirefly.com/tiktok-events-api-server-side-tracking.html
- Langue : fr
- Mis à jour le : 2026-09-05
- Éditeur : DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/

---

TikTok Events API v1.3

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.

[Créer un compte](https://admin.datafirefly.com/pricing?lang=fr) Voir ce qui est envoyé

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 (hors webhooks Shopify)

**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_view` | `Pageview` |
| `view_content` | `ViewContent` |
| `add_to_cart` | `AddToCart` |
| `initiate_checkout` | `InitiateCheckout` |
| `add_payment_info` | `AddPaymentInfo` |
| `purchase` | `CompletePayment` |
| `lead` | `SubmitForm` |
| `complete_registration` | `CompleteRegistration` |
| `search` | `Search` |
| `add_to_wishlist` | `AddToWishlist` |
| `contact` | `Contact` |
| `subscribe` | `Subscribe` |

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. Sur Shopify, le pixel DataFirefly suit le consentement marketing enregistré par Shopify, mais les commandes arrivent par des webhooks signés qui ne portent aucun signal de consentement : c'est votre propre politique de consentement qui s'applique à elles.

### 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é. Sur Shopify, le pixel DataFirefly suit le consentement marketing enregistré par Shopify, mais les commandes arrivent par des webhooks signés qui ne portent aucun signal de consentement : c'est votre propre politique de consentement qui s'applique à elles.

### 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.

Pour aller plus loin

## La suite logique

Installer le connecteur sur votre boutique, savoir ce qu'il mesure, et vérifier ce qui est réellement parti.

### [Module PrestaShop](https://server-side.datafirefly.com/prestashop-server-side-tracking.html)

L'installation sur une boutique PrestaShop, étape par étape.

### [Plugin WooCommerce](https://server-side.datafirefly.com/woocommerce-server-side-tracking.html)

L'installation sur WordPress et WooCommerce.

### [Extension Shopware](https://server-side.datafirefly.com/shopware-server-side-tracking.html)

L'installation sur Shopware 6.

### [Ce que nous mesurons](https://server-side.datafirefly.com/ce-que-nous-mesurons.html)

Les 28 événements en clair, et ce que voit un site sans boutique.

### [Insights : le tableau de bord](https://server-side.datafirefly.com/insights.html)

Où vous vérifiez ce qui est parti, et ce que la destination en a fait.

### [Toutes les destinations](https://server-side.datafirefly.com/#destinations)

Les sept plateformes vers lesquelles un même événement peut partir.

## Branchez cette destination en quelques minutes

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

[Commencer gratuitement](https://admin.datafirefly.com/pricing?lang=fr) [Parlons-en](https://server-side.datafirefly.com/contact.html)
