TikTok Events API

Ce guide explique comment configurer les événements de l’Events API qu’AdTarget envoie à TikTok lorsque des utilisateurs rejoignent votre canal Telegram.

Quand les événements sont-ils envoyés ?

AdTarget envoie un événement à TikTok uniquement pour les adhésions attribuées — c’est-à-dire les adhésions où AdTarget peut relier l’adhésion Telegram à un clic publicitaire spécifique sur votre page de destination. Cela nécessite que l’invite_link soit présent dans le webhook de Telegram.

Les événements sont envoyés lorsqu’un utilisateur clique sur votre lien d’invitation suivi et que Telegram le signale dans le webhook (fiable pour les canaux privés).

Les événements NE SONT PAS envoyés pour les adhésions organiques — les utilisateurs qui trouvent votre canal via la recherche, des liens directs ou des messages transférés. Ces adhésions apparaissent toujours dans votre tableau de bord AdTarget mais sont marquées comme « organiques ».

Types d’événements disponibles

AdTarget associe ses types d’événements aux événements standard de TikTok :

Choisir le bon événement

Vous faites de la génération de leads ? Utilisez Lead (associé au SubmitForm de TikTok) — Cela indique à TikTok « cette personne a soumis un formulaire / est devenue un lead ».

Vous vendez un produit ou service ? Utilisez Purchase — Idéal lorsque vous voulez que TikTok optimise pour les acheteurs. Associez-le à une value et une currency dans la config de conversion de votre canal pour une optimisation basée sur la valeur.

Vous lancez des campagnes d’inscription ? Utilisez CompleteRegistration — Signale une action d’inscription complétée.

Vous promouvez un abonnement à un canal ? Utilisez Subscribe — Correspond à l’action de l’utilisateur (rejoindre = s’abonner).

Vous avez besoin d’un événement non standard ? Utilisez Custom — Vous permet de définir votre propre nom d’événement pour des scénarios de suivi spécialisés.

Conseil : Faites correspondre votre type d’événement à l’objectif de votre campagne dans TikTok Ads Manager pour de meilleurs résultats.

Configuration des événements

Les types d’événements sont configurés par canal. Chaque canal est par défaut sur CompleteRegistration lors de sa première détection.

Pour modifier le type d’événement d’un canal :

1. Allez dans les Settings de votre site → onglet Channels
2. Cliquez sur Setup (ou Edit) sur la ligne du canal
3. Sélectionnez votre type d’événement dans la boîte de dialogue
4. Cliquez sur Save

Paramètres des événements

Chaque événement qu’AdTarget envoie à TikTok inclut ces paramètres :

Paramètres obligatoires

Paramètres d’attribution

Données utilisateur

L’external_id (ID utilisateur Telegram) est haché en SHA-256 avant l’envoi, comme requis par TikTok. L’adresse IP et le user agent sont envoyés tels quels selon les spécifications de l’Events API de TikTok.

Propriétés de l’événement

Déduplication des événements

AdTarget inclut un event_id unique avec chaque événement pour éviter les doublons :

event_id: "adtarget_{conversion_id}"

Cela garantit que la même conversion n’est pas comptée deux fois, même en cas de nouvel essai.

Tester les événements

Test en production

La méthode la plus fiable pour tester de bout en bout :

1. Cliquez sur votre propre publicité TikTok (ou utilisez une publicité test)
2. Visitez votre page de destination
3. Rejoignez votre canal Telegram via le lien d’invitation suivi
4. Vérifiez le TikTok Events Manager dans les 5-10 minutes

Vérifier dans TikTok Ads Manager

1. Allez dans Assets → Events → Web Events → Manage
2. Vérifiez l’onglet Events
3. Cherchez votre type d’événement avec des horodatages récents
4. Vérifiez que l’événement est marqué comme « Received »

Correspondance des événements

TikTok fait correspondre vos événements aux utilisateurs pour l’attribution. Une meilleure qualité de correspondance signifie une meilleure optimisation.

Facteurs de qualité de correspondance

Améliorer la qualité de correspondance

1. Capturez le ttclid : Assurez-vous que l’URL de votre page de destination préserve le paramètre ttclid
2. Envoyez les événements rapidement : Un délai plus court entre le clic et la conversion améliore la correspondance
3. Parcours utilisateur cohérent : Gardez les utilisateurs sur votre domaine avant de les rediriger vers Telegram

Configurations d’événements courantes

Génération de leads

AdTarget Event: Lead → TikTok Event: SubmitForm
When: User joins channel
Use Case: "Get subscribers" campaigns

Suivi des achats

AdTarget Event: Purchase → TikTok Event: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Abonnement au contenu

AdTarget Event: Subscribe → TikTok Event: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Dépannage

Les événements ne correspondent pas ?

• Vérifiez que le ttclid est dans l’URL de la page de destination
• Vérifiez que le TikTok Pixel est également sur la page de destination
• Assurez-vous que les cookies ne sont pas bloqués

Faible taux de correspondance des événements ?

• Réduisez le délai entre le clic et la conversion
• Vérifiez que le ttclid est capturé depuis l’URL
• Assurez-vous que l’IP et le user agent sont disponibles

Événements en double ?

• AdTarget gère la déduplication automatiquement via event_id
• Si vous voyez des doublons, contactez le support

Bonnes pratiques

1. Faites correspondre le type d’événement à l’objectif de campagne pour une meilleure optimisation
2. Utilisez le même type d’événement de manière cohérente au sein d’une campagne
3. Surveillez la livraison des événements dans le TikTok Events Manager régulièrement
4. Testez avant de monter en échelle les dépenses publicitaires

Prochaines étapes

Votre intégration TikTok est complète ! Commencez à diffuser des publicités et regardez vos conversions arriver dans TikTok.

Besoin d’aide pour optimiser ? Contactez notre équipe support.