Postback Keitaro, Voluum et Binom depuis votre CRM Telegram
Si vos campagnes passent par un tracker, ScaleGram CRM lui renvoie ce qui se passe sur Telegram et chez le broker : adhésion au canal, lead, inscription, dépôt confirmé. Le tracker garde alors la vue complète de vos conversions, quelle que soit la source de trafic.
En bref
ScaleGram appelle l’URL de postback de votre tracker, en GET ou en POST, à chaque événement du lead. Les macros entre accolades ({sub1}, {event}, {value}, {currency}…) sont remplacées par les valeurs du clic et de l’événement. Il n’y a pas de module dédié à Keitaro, Voluum ou Binom : tous passent par ce postback générique.
Le principe : votre identifiant de clic aller-retour
- Votre tracker envoie le visiteur vers le lien de suivi ScaleGram de la campagne, en ajoutant son propre identifiant de clic dans un paramètre sub1 à sub5.
- ScaleGram enregistre ce paramètre avec le clic et donne au visiteur son lien d’invitation Telegram à usage unique.
- À chaque événement du lead (adhésion, lead, inscription, dépôt), ScaleGram appelle l’URL de postback de votre tracker, dans laquelle {sub1} est remplacé par l’identifiant reçu au départ.
Le nom du jeton qui contient l’identifiant de clic dépend de votre tracker : reprenez-le de sa documentation et placez-le dans le paramètre sub1 du lien ScaleGram.
Les macros disponibles
| Macro | Valeur |
|---|---|
| {sub1} … {sub5} | Les paramètres sub1 à sub5 reçus au clic, par exemple l’identifiant de clic de votre tracker |
| {event} | Le nom de l’événement (par défaut join, lead, registered, deposit…) |
| {value}, {currency} | Le montant et la devise, pour le dépôt |
| {time} | L’heure de l’événement (horodatage Unix) |
| {click_id} | L’identifiant du clic chez ScaleGram |
| {campaign} | La campagne ScaleGram |
| {lead_id}, {telegram_user_id} | L’identifiant du lead dans le CRM et son identifiant Telegram |
| {fbclid}, {ttclid}, {gclid}, {gbraid}, {wbraid}, {sccid}, {twclid}, {msclkid} | Les identifiants de clic des régies, s’ils étaient dans l’URL |
| {utm_source}, {utm_campaign} | Les UTM du clic |
Les événements envoyés
Chaque événement du CRM peut partir vers le tracker. Par défaut, l’adhésion au canal, le lead et le dépôt confirmé sont actifs ; la demande d’adhésion, le démarrage du bot, le premier message privé et l’inscription sont disponibles. Le nom transmis dans {event} se modifie règle par règle, pour correspondre aux statuts de votre tracker.
Le dépôt part seulement quand il est confirmé, avec sa valeur. L’inscription part quand le lead entre dans l’étape du pipeline que vous choisissez, ou quand la synchronisation CellXpert la remonte.
Keitaro
Dans Keitaro, la campagne envoie le trafic vers le lien de suivi ScaleGram, avec le jeton de clic de Keitaro dans sub1. Dans ScaleGram, la destination de type postback reçoit l’URL de postback de votre installation Keitaro, où l’identifiant de clic est remplacé par {sub1} et le statut par {event}.
Voluum
Dans Voluum, l’offre pointe vers le lien de suivi ScaleGram, avec le jeton d’identifiant de clic de Voluum dans sub1. Dans ScaleGram, l’URL de postback de Voluum reçoit {sub1} à la place de l’identifiant de clic, et {value} pour le montant du dépôt.
Binom
Dans Binom, l’offre pointe vers le lien de suivi ScaleGram, avec le jeton de clic de Binom dans sub1. Dans ScaleGram, l’URL de postback de Binom reçoit {sub1} comme identifiant de conversion, {event} pour le statut et {value} pour le montant.
Configurer et tester le postback
- Dans l’écran Tracking, ajoutez une destination de type postback : l’URL avec ses macros, et la méthode GET ou POST. En POST, toutes les valeurs sont envoyées dans le corps de la requête.
- Cliquez sur « Tester » : ScaleGram appelle l’URL avec un événement de test.
- Choisissez les événements à envoyer et leurs noms.
- Seules les adresses publiques en http ou https sont acceptées ; les adresses locales et privées sont refusées.
- Un envoi échoué est relancé après 1, 5, 30, 120 puis 720 minutes, puis abandonné et journalisé.
- Les identifiants de clic X (twclid) et Microsoft (msclkid) sont enregistrés mais n’ont pas d’envoi direct : le postback est le moyen de les transmettre.
Questions fréquentes
ScaleGram a-t-il une intégration native avec Keitaro, Voluum ou Binom ?
Non. ScaleGram appelle l’URL de postback de votre tracker avec des macros. C’est la méthode que ces trackers proposent pour recevoir des conversions d’une source externe.
Comment le tracker reconnaît-il le bon clic ?
Votre tracker passe son identifiant de clic dans un paramètre sub1 à sub5 du lien ScaleGram. ScaleGram le renvoie dans le postback avec la macro correspondante, par exemple {sub1}.
Le montant du dépôt est-il transmis ?
Oui, avec la macro {value}, et la devise avec {currency}.
Puis-je envoyer les événements à plusieurs trackers ?
Oui. Chaque destination a sa propre URL, et une campagne peut envoyer vers plusieurs destinations à la fois, en plus de Meta, TikTok ou Snapchat.
GET ou POST ?
Les deux sont possibles. En GET, les macros sont remplies dans l’URL. En POST, les valeurs sont aussi envoyées dans le corps de la requête.
Que se passe-t-il si mon tracker ne répond pas ?
L’envoi est relancé après 1, 5, 30, 120 puis 720 minutes, puis abandonné. Les envois et leurs réponses sont journalisés dans le CRM.
À voir aussi
Suivi publicitaire Telegram
Un lien d’invitation Telegram par clic, renvoyé à Meta, TikTok et Snapchat jusqu’au dépôt.
Meta Ads
Conversions API côté serveur et import des dépenses par publicité et par jour.
TikTok Ads
Events API côté serveur et import des dépenses TikTok.
Snapchat Ads
Conversions API v3 côté serveur, de l’adhésion au dépôt.
Intégrations
Telegram, régies publicitaires, CellXpert, trackers et Google Sheets.
Créez votre espace en quelques minutes
Gratuit pendant le lancement, sans carte bancaire. Connectez un compte Telegram et vos premiers leads arrivent dans le pipeline.