Configuration des postbacks de conversion pour les liens de destination web

ATTENTION

Les instructions de cette section ne s'appliquent pas aux campagnes Telegram Ads. Pour configurer les postbacks de conversion pour les liens web dans 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.

  

• record — une valeur unique pour chaque clic ou impression, correspondant à la macro {record_data}. AdsGram insère automatiquement cette valeur dans le lien de suivi.

• 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 de suivi. Assurez-vous qu'il contient la macro {record_data}.
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&record=7f3a1b6c5d2e4f8a&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 7f3a1b6c5d2e4f8a par la valeur réelle de {record_data} issue du lien de suivi.

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 de suivi conformément à la documentation et assurez-vous qu'il contient la macro {record_data}.
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. Indiquez un jeton valide dans le paramètre token et, dans le paramètre record, la valeur réelle de {record_data} issue du lien de suivi sur lequel l'utilisateur a cliqué.
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, record 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.