Configuration des postbacks de conversion pour les liens de destination de l'écosystème Telegram

ATTENTION

Les instructions de cette section ne s'appliquent pas aux campagnes Telegram Ads. Pour en savoir plus sur le suivi des conversions pour les liens internes à Telegram dans les campagnes Telegram Ads, consultez cette section.

Paramètres :

• token — un jeton unique associé à votre compte. Il est disponible dans le tableau de bord AdsGram et peut être régénéré si nécessaire.

  Comment obtenir votre jeton :

  1. Ouvrez le tableau de bord AdsGram.
  2. Cliquez sur votre profil dans le coin supérieur droit.
  3. Trouvez le paramètre token et cliquez sur le bouton de copie pour le copier.

  

• tgid — l'ID Telegram de l'utilisateur qui a cliqué sur le lien publicitaire.

• campaignid — l'ID de la campagne publicitaire AdsGram à laquelle se rapporte la conversion. Il correspond à la valeur de la macro {campaign_id} transmise dans le lien publicitaire. AdsGram insère la valeur de la macro lorsqu'un utilisateur clique sur le lien.

• goaltype — un paramètre qui spécifie le type de conversion (étape du funnel), aidant à segmenter les diverses actions des utilisateurs. Il accepte les valeurs entières de 1 à 3.

  Utilisation de goaltype :

  1. Définissez les étapes du funnel dans votre produit ou service.
  2. Associez les étapes aux valeurs de goaltype :
     • 1. Inscription
     • 2. Premier dépôt/achat
     • 3. Dépôt/achat répété
  3. Configurez le suivi des conversions pour les étapes pertinentes du parcours utilisateur.
  4. Ajoutez le paramètre goaltype à votre requête API lors de l'envoi des données de conversion.
  5. Utilisez ce paramètre dans vos statistiques pour effectuer une analyse détaillée des performances par type de conversion.

Comment configurer le suivi des conversions :

1. Sélectionnez une campagne. Utilisez une campagne active existante ou créez-en une nouvelle.
2. Configurez le lien publicitaire. Assurez-vous qu'il contient la macro {campaign_id}.
3. Obtenez votre jeton. Copiez votre jeton unique depuis le tableau de bord AdsGram.
4. Configurez l'envoi des postbacks. Configurez votre serveur pour qu'il envoie une requête API à AdsGram chaque fois qu'un utilisateur effectue une action cible.
5. Indiquez le type de conversion. Définissez la valeur goaltype appropriée si vous souhaitez distinguer les étapes du funnel.
6. Testez l'intégration. Suivez les étapes de la section Test de l'intégration ci-dessous et vérifiez que les conversions apparaissent dans les statistiques AdsGram.

Exemple de requête API lors d'une conversion :

GET
https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&tgid=98110997&goaltype=2&campaignid=72156

Dans cet exemple, goaltype=2 correspond à une conversion telle qu'un premier dépôt ou un achat.

Remplacez les valeurs de l'exemple par vos données réelles :

• YOUR_UNIQUE_TOKEN — le jeton de votre compte AdsGram ;
• 98110997 — l'ID Telegram de l'utilisateur qui a cliqué sur le lien publicitaire ;
• 72156 — l'ID de votre campagne publicitaire.

Réponse attendue : 200 OK — la conversion a été enregistrée avec succès.

Test de l'intégration

Pour tester le suivi des conversions, suivez ces étapes :

1. Créez ou sélectionnez une campagne. Configurez le lien publicitaire conformément à la documentation et assurez-vous qu'il contient la macro {campaign_id}.
2. Attendez les clics. Attendez que des utilisateurs aient cliqué plusieurs fois sur le lien publicitaire.
3. Obtenez l'ID Telegram de l'utilisateur. Récupérez le tgid d'un utilisateur qui a cliqué sur le lien de la campagne sélectionnée.
4. Envoyez manuellement un postback de test. Définissez goaltype=1 et indiquez un jeton valide, l'ID Telegram de l'utilisateur dans le paramètre tgid et l'ID de la campagne de test dans le paramètre campaignid.
5. Vérifiez le résultat. Assurez-vous que la requête a été traitée avec succès et que la conversion apparaît dans les statistiques AdsGram de la campagne sélectionnée.

Dépannage

• La conversion apparaît dans les statistiques : l'intégration est correctement configurée et fonctionne pour le scénario testé.
• Le serveur renvoie une erreur : vérifiez l'URL de la requête et les valeurs des paramètres token, tgid, campaignid et goaltype.
• La requête aboutit, mais la conversion n'apparaît pas : les statistiques sont mises à jour une fois par heure. Si la conversion n'apparaît toujours pas au bout d'une heure, contactez le support AdsGram ou votre account manager. Joignez impérativement les logs de la requête et de la réponse.