Événements CAPI

Ce guide explique comment configurer les événements Conversions API qu’AdTarget envoie à Meta lorsque des utilisateurs rejoignent votre channel Telegram.

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

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

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

Les événements CAPI ne sont PAS envoyés pour les adhésions organiques — les utilisateurs qui trouvent votre channel 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”.

Limitation des channels publics : En raison d’une limitation de l’API Telegram, même les utilisateurs qui cliquent sur votre lien suivi peuvent être traités comme des adhésions organiques sur les channels publics. L’application Telegram (surtout Android) convertit souvent les adhésions par lien d’invitation en “adhésions directes” pour les channels publics, supprimant les données d’attribution. En savoir plus →

Types d’événements disponibles

AdTarget peut envoyer ces événements Meta standard :

Événement	Idéal pour	Optimisation Meta
Lead	Campagnes de génération de leads	Optimise pour l’intention de lead
Purchase	Campagnes axées sur l’achat	Optimise pour les actions d’achat
CompleteRegistration	Campagnes axées sur l’inscription	Optimise pour les actions d’inscription
Subscribe	Campagnes d’abonnement	Optimise pour l’intention d’abonnement
Custom	Nom d’événement personnalisé	Pour des besoins de suivi spécifiques

Choisir le bon événement

Campagnes de génération de leads ? Utilisez Lead — Cela dit à Meta “cette personne est devenue un lead.”

Vente d’un produit ou service ? Utilisez Purchase — Idéal quand vous voulez que Meta optimise pour les acheteurs. Associez-le avec une value et une currency dans la configuration de conversion de votre channel pour une optimisation basée sur la valeur.

Campagnes d’inscription ? Utilisez CompleteRegistration — Signale une action d’inscription terminée.

Promotion d’un abonnement à un channel ? Utilisez Subscribe — Correspond à l’action de l’utilisateur (rejoindre = s’abonner).

Besoin d’un événement non standard ? Utilisez Custom — Vous permet de définir votre propre customEventName pour des scénarios de suivi spécifiques qui ne correspondent pas aux types standard.

Astuce : Faites correspondre votre type d’événement à votre objectif de campagne dans le Gestionnaire de publicités pour de meilleurs résultats.

Configuration des événements

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

Pour changer le type d’événement d’un channel :

Allez dans les Paramètres de votre site → onglet Channels
Cliquez sur Setup (ou Edit) sur la ligne du channel
Sélectionnez votre type d’événement dans la boîte de dialogue
Cliquez sur Save

Paramètres des événements

Chaque événement envoyé par AdTarget inclut ces paramètres :

Paramètres obligatoires

Paramètre	Description
`event_name`	Le type d’événement (Lead, etc.)
`event_time`	Horodatage Unix de l’adhésion
`action_source`	Toujours “website”

Paramètres d’attribution

Paramètre	Description
`fbc`	Cookie de suivi de clic (contient le `fbclid` du clic publicitaire, formaté comme `fb.1.{timestamp}.{fbclid}`)
`fbp`	Valeur du cookie de suivi navigateur (identifiant navigateur Meta)

Données utilisateur

Si disponibles, AdTarget envoie les données utilisateur pour la correspondance :

Paramètre	Source	Haché ?
`external_id`	Identifiant utilisateur Telegram	Oui (SHA-256)
`client_ip_address`	IP de la visite de la page d’atterrissage	Non (envoyé tel quel)
`client_user_agent`	Navigateur de la visite de la page d’atterrissage	Non (envoyé tel quel)

Le external_id (identifiant utilisateur Telegram) est haché en SHA-256 avant l’envoi, comme recommandé par Meta. Les autres paramètres comme l’adresse IP et le user agent sont envoyés tels quels, conformément aux spécifications CAPI de Meta pour ces champs.

Données personnalisées

AdTarget envoie également ces champs dans l’objet custom_data de chaque événement CAPI :

Paramètre	Description
`event_source_url`	URL de la page d’atterrissage (construite à partir du domaine du site + chemin de visite)
`value`	Valeur de l’événement (si configurée par channel)
`currency`	Code devise (par défaut `"USD"`)
`content_name`	Titre du channel ou nom personnalisé depuis la configuration du channel

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 nouvelle tentative.

Tester les événements

Événement de test de validation

Lorsque vous enregistrez votre pixel lors de la configuration, AdTarget envoie automatiquement un événement de test PageView avec le code ADTARGET_TEST. Vous pouvez le voir dans le Gestionnaire d’événements Meta sous l’onglet Événements test — il confirme que votre pixel ID et votre token d’accès fonctionnent.

Tester en production

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

Cliquez sur votre propre publicité (ou utilisez une publicité test)
Visitez votre page d’atterrissage
Rejoignez votre channel Telegram via le lien d’invitation suivi
Vérifiez le Gestionnaire d’événements dans les 5 minutes

Correspondance des événements

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

Facteurs de qualité de correspondance

Facteur	Impact
fbc présent (contient le fbclid)	Élevé - Attribution directe du clic
User agent + IP	Moyen - Correspondance probabiliste
External ID	Moyen - Correspondance cross-device

Améliorer la qualité de correspondance

Capturez le fbclid : Assurez-vous que l’URL de votre page d’atterrissage préserve le paramètre fbclid
Envoyez les événements rapidement : Un délai plus court entre le clic et la conversion améliore la correspondance
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


Event Type: Lead
When: User joins channel
Use Case: "Get subscribers" campaigns

Suivi des achats


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

Abonnement au contenu


Event Type: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Configuration multi-channels


Channel A (free content): Lead
Channel B (premium): Purchase
Channel C (subscription): Subscribe

Dépannage

Les événements ne correspondent pas ?

Vérifiez que le fbclid est dans l’URL de la page d’atterrissage
Vérifiez que le Meta Pixel est aussi sur la page d’atterrissage
Assurez-vous que les cookies ne sont pas bloqués

Le score de qualité des événements est faible ?

Augmentez les données que vous envoyez (IP, user agent)
Réduisez le délai entre le clic et la conversion
Vérifiez que le fbclid est bien capturé

Événements en double ?

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

Bonnes pratiques

Faites correspondre le type d’événement à l’objectif de campagne pour une meilleure optimisation
Utilisez le même type d’événement de manière cohérente au sein d’une campagne
Surveillez la qualité des événements dans le Gestionnaire d’événements chaque semaine
Testez avant d’augmenter les dépenses publicitaires

Étapes suivantes

Votre intégration Meta est terminée ! Lancez des publicités et regardez vos conversions affluer dans Meta.

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