Activer le retour de conversion TikTok

TikTok Events API renvoie vos LeadCreated et DealWon directement à TikTok côté serveur. Vous récupérez 30 à 50% de conversions invisibles côté pixel browser.

Prérequis

• Compte TikTok Ads connecté à Metrikia via OAuth.
• Vous êtes administrateur ou propriétaire du tenant Metrikia.
• Accès TikTok Ads Manager avec rôle "Standard" minimum.

Étapes

1. Récupérer le Pixel Code

1. Ouvrez https://ads.tiktok.com et connectez-vous.
2. Menu "Outils" > "Événements" > "Pixel web".
3. Sélectionnez le pixel utilisé sur votre site, copiez le code alphanumérique 16 à 32 caractères affiché en haut.

2. Générer un Access Token

1. Dans TikTok Ads Manager, allez dans "Outils" > "Événements" > l'onglet "Events API".
2. Cliquez "Générer un token" (ou "Generate token").
3. Donnez les permissions offline_event_set:write.
4. Copiez le token immédiatement, il n'est plus affiché ensuite.

3. Récupérer l'Event Source ID (optionnel)

Par défaut, le pixel est utilisé comme event source. Si vous avez créé un Event Source personnalisé, copiez son ID depuis "Events API > Event Sources".

4. Configurer dans Metrikia

1. Rendez-vous sur https://app.metrikia.io/app/settings, onglet Intégrations.
2. Section "Retours de conversions côté serveur", carte TikTok, cliquez "Activer la connexion".
3. Renseignez Pixel Code et Access Token. Event Source ID et Test Event Code sont optionnels.
4. Cliquez "Activer la connexion".

Vérification

Vérifiez dans TikTok Ads Manager > Événements > votre pixel que les colonnes "Events received" s'incrémentent après vos premiers LeadCreated.

Cas d'erreur fréquents

• "Pixel code invalide" : le code TikTok est en MAJUSCULES alphanumériques, 16 à 32 caractères. Pas de tiret ni d'espace.
• "Access token expiré" : régénérez via TikTok Ads Manager et mettez à jour dans Metrikia via "Mettre à jour".
• "Test event code visible en production" : retirez le champ Test Event Code une fois la validation terminée, sinon vos événements ne sont pas comptabilisés.

Compliance RGPD

Les événements contiennent des hashes SHA-256 d'email et téléphone. Mentionnez "TikTok Events API" dans votre bandeau cookie, catégorie marketing.