Skip to Content
Suivez vos conversions Telegram avec Meta Ads — commencez en quelques minutes !
Intégration SnapchatConversions API

Snapchat Conversions API

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

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

AdTarget envoie un événement à Snapchat 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 ».

Limitation des canaux 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 canaux publics. L’application Telegram (en particulier Android) convertit souvent les adhésions par lien d’invitation en « adhésions directes » pour les canaux publics, supprimant les données d’attribution. En savoir plus →

Types d’événements disponibles

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

Événement AdTargetÉvénement SnapchatIdéal pourOptimisation Snapchat
LeadSIGN_UPCampagnes de génération de leadsOptimise pour les inscriptions
PurchasePURCHASECampagnes axées sur les achatsOptimise pour les actions d’achat
CompleteRegistrationSIGN_UPCampagnes axées sur l’inscriptionOptimise pour les inscriptions
SubscribeSUBSCRIBECampagnes d’abonnementOptimise pour l’intention d’abonnement
CustomCUSTOM_EVENT_1Suivi spécialiséOptimisation personnalisée

Choisir le bon événement

Vous faites de la génération de leads ? Utilisez Lead (associé au SIGN_UP de Snapchat) — Cela indique à Snapchat « cette personne s’est inscrite / est devenue un lead ».

Vous vendez un produit ou service ? Utilisez Purchase (associé à PURCHASE) — Idéal lorsque vous voulez que Snapchat 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 (associé à SIGN_UP) — Signale une action d’inscription complétée.

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

Vous avez besoin d’un événement non standard ? Utilisez Custom (associé à CUSTOM_EVENT_1) — Pour des scénarios de suivi spécialisés qui ne correspondent pas aux types standard.

Conseil : Faites correspondre votre type d’événement à l’objectif de votre campagne dans Snapchat 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 à Snapchat inclut ces paramètres :

Paramètres obligatoires

ParamètreDescription
event_typeLe nom de l’événement Snapchat (SIGN_UP, PURCHASE, etc.)
timestampHorodatage ISO 8601 de l’adhésion (millisecondes)
event_tagTag pour la catégorisation des événements

Paramètres d’attribution

ParamètreDescription
sc_click_idLe Snapchat Click ID (ScCid) du clic publicitaire

Données utilisateur

ParamètreSourceHaché ?
hashed_external_idID utilisateur TelegramOui (SHA-256)
hashed_ip_addressIP de la visite sur la page de destinationNon (envoyé tel quel)
user_agentNavigateur de la visite sur la page de destinationNon (envoyé tel quel)

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

Champs personnalisés

ParamètreDescription
priceValeur de l’événement (si configuré par canal)
currencyCode devise (par défaut "USD")
descriptionTitre du canal ou nom personnalisé de la config du canal

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é Snapchat (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 Snapchat Events Manager dans les 5-10 minutes

Vérifier dans Snapchat Ads Manager

  1. Allez dans Events Manager
  2. Sélectionnez votre pixel
  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

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

Facteurs de qualité de correspondance

FacteurImpact
ScCid présentÉlevé - Attribution directe par clic
User agent + IPMoyen - Correspondance probabiliste
External IDMoyen - Correspondance multi-appareils

Améliorer la qualité de correspondance

  1. Capturez le ScCid : Assurez-vous que l’URL de votre page de destination préserve le paramètre ScCid
  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 → Snapchat Event: SIGN_UP When: User joins channel Use Case: "Get subscribers" campaigns

Suivi des achats

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

Abonnement au contenu

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

Dépannage

Les événements ne correspondent pas ?

  • Vérifiez que le ScCid est dans l’URL de la page de destination
  • Vérifiez que le Snapchat 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 ScCid 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 Snapchat Events Manager régulièrement
  4. Testez avant de monter en échelle les dépenses publicitaires

Prochaines étapes

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

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

Last updated on

Snapchat Conversions API | AdTarget Docs