Suivi des conversions dans les campagnes Telegram Ads

Suivi des conversions pour les liens internes à Telegram dans les campagnes Telegram Ads

Dans les campagnes Telegram Ads, les macros AdsGram ne sont pas prises en charge pour les liens menant vers des destinations internes à Telegram et ne sont pas transmises dans ces liens publicitaires. L'API de confirmation de conversion ne peut donc pas être utilisée pour suivre les conversions des liens menant vers des Telegram Mini Apps (TMA), des bots ou des chaînes.

Pour les liens internes à Telegram dans les campagnes Telegram Ads, les événements cibles suivants sont automatiquement comptabilisés comme Goal 1 par défaut :

• TMA — lancement de la TMA ;
• Bots — lancement du bot ;
• Chaînes — abonnement à la chaîne.

Les conversions sont transmises automatiquement, aucune configuration supplémentaire n'est donc nécessaire.

Configuration des postbacks de conversion pour les liens web dans Telegram Ads

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.

  

• 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 Telegram Ads. Utilisez une campagne active existante ou créez-en une nouvelle.
2. Configurez le lien de suivi. 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&campaignid=72156&goaltype=2

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

Remplacez YOUR_UNIQUE_TOKEN par le jeton de votre compte et 72156 par 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. Créez ou sélectionnez une campagne Telegram Ads et configurez le lien de suivi conformément à la documentation. Assurez-vous que la macro {campaign_id} figure dans le lien.
2. Attendez les clics. Attendez que des utilisateurs aient cliqué plusieurs fois sur le lien de suivi.
3. Envoyez manuellement un postback de test avec le paramètre goaltype=1. Utilisez un token valide et l'ID de la campagne de test dans le paramètre campaignid.
4. 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, 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.