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 Snapchat | Idéal pour | Optimisation Snapchat |
|---|---|---|---|
| Lead | SIGN_UP | Campagnes de génération de leads | Optimise pour les inscriptions |
| Purchase | PURCHASE | Campagnes axées sur les achats | Optimise pour les actions d’achat |
| CompleteRegistration | SIGN_UP | Campagnes axées sur l’inscription | Optimise pour les inscriptions |
| Subscribe | SUBSCRIBE | Campagnes d’abonnement | Optimise pour l’intention d’abonnement |
| Custom | CUSTOM_EVENT_1 | Suivi 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 :
- Allez dans les Settings de votre site → onglet Channels
- Cliquez sur Setup (ou Edit) sur la ligne du canal
- Sélectionnez votre type d’événement dans la boîte de dialogue
- Cliquez sur Save
Paramètres des événements
Chaque événement qu’AdTarget envoie à Snapchat inclut ces paramètres :
Paramètres obligatoires
| Paramètre | Description |
|---|---|
event_type | Le nom de l’événement Snapchat (SIGN_UP, PURCHASE, etc.) |
timestamp | Horodatage ISO 8601 de l’adhésion (millisecondes) |
event_tag | Tag pour la catégorisation des événements |
Paramètres d’attribution
| Paramètre | Description |
|---|---|
sc_click_id | Le Snapchat Click ID (ScCid) du clic publicitaire |
Données utilisateur
| Paramètre | Source | Haché ? |
|---|---|---|
hashed_external_id | ID utilisateur Telegram | Oui (SHA-256) |
hashed_ip_address | IP de la visite sur la page de destination | Non (envoyé tel quel) |
user_agent | Navigateur de la visite sur la page de destination | Non (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ètre | Description |
|---|---|
price | Valeur de l’événement (si configuré par canal) |
currency | Code devise (par défaut "USD") |
description | Titre 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 :
- Cliquez sur votre propre publicité Snapchat (ou utilisez une publicité test)
- Visitez votre page de destination
- Rejoignez votre canal Telegram via le lien d’invitation suivi
- Vérifiez le Snapchat Events Manager dans les 5-10 minutes
Vérifier dans Snapchat Ads Manager
- Allez dans Events Manager
- Sélectionnez votre pixel
- Cherchez votre type d’événement avec des horodatages récents
- 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
| Facteur | Impact |
|---|---|
| ScCid présent | Élevé - Attribution directe par clic |
| User agent + IP | Moyen - Correspondance probabiliste |
| External ID | Moyen - Correspondance multi-appareils |
Améliorer la qualité de correspondance
- Capturez le ScCid : Assurez-vous que l’URL de votre page de destination préserve le paramètre
ScCid - 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
AdTarget Event: Lead → Snapchat Event: SIGN_UP
When: User joins channel
Use Case: "Get subscribers" campaignsSuivi des achats
AdTarget Event: Purchase → Snapchat Event: PURCHASE
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimizationAbonnement au contenu
AdTarget Event: Subscribe → Snapchat Event: SUBSCRIBE
When: User joins channel
Use Case: "Subscribe to channel" campaignsDépannage
Les événements ne correspondent pas ?
- Vérifiez que le
ScCidest 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
ScCidest 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
- 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 livraison des événements dans le Snapchat Events Manager régulièrement
- 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.