Integrations partenaires

AdsGram prend en charge l'integration avec des plateformes d'attribution et de suivi populaires. Elles vous permettent de suivre les clics, les installations et les actions des utilisateurs apres avoir interagi avec les publicites AdsGram, ainsi que d'envoyer les donnees de conversion a AdsGram, ce qui vous permet d'optimiser les campagnes pour le cout de conversion (tCPA).

Les integrations suivantes sont disponibles :

• AppsFlyer
• Adjust
• AppMetrica
• Kochava
• Keitaro

Vous pouvez egalement utiliser des liens provenant d'autres plateformes de suivi. Cependant, dans ce cas, AdsGram ne pourra pas transmettre toutes les informations necessaires au tracker pour une analyse plus detaillee.

Adjust

1. Choisir le reseau

Dans la section Campaign Lab, accedez a Partners

• Cliquez sur New Partner.
• Dans la barre de recherche, tapez AdsGram et selectionnez ce reseau.
• Apres la selection, cliquez sur Next.

2. Choisir l'application

Sur l'ecran suivant, choisissez l'application pour laquelle vous souhaitez creer le lien. Utilisez la barre de recherche pour trouver votre application, ou faites defiler la liste pour la trouver. Vous pouvez configurer des liens pour une application a la fois.
Apres avoir selectionne l'application, cliquez sur Next.

3. Definir les options de partage de donnees

Dans cette section, vous configurerez les parametres de partage de donnees avec AdsGram, en selectionnant quels evenements et parametres d'application seront envoyes a AdsGram pour analyse.
Des instructions detaillees sont disponibles sur la page de documentation Adjust.

4. Obtenir le lien de suivi

Apres avoir configure tous les parametres et correspondances, vous recevrez un lien de suivi unique, qui doit etre utilise lors de la creation de campagnes publicitaires dans AdsGram.
De plus, vous pouvez ajouter des parametres supplementaires comme les balises UTM pour un suivi plus precis des sources de trafic.

5. Transfert des donnees de conversion

Par defaut, les donnees d'activite des utilisateurs sont transferees d'Adjust vers AdsGram et automatiquement attribuees aux objectifs correspondants :

• Sessions - vers Goal 1
• Installations (Installs) - vers Goal 2

IMPORTANT

Pour lancer une campagne tCPA, vous devez recevoir au moins 10 conversions pour l'objectif selectionne. Par exemple, si la campagne est lancee avec Goal 2, vous devez recevoir au moins 10 conversions pour Goal 2.

AppMetrica

Creation d'un tracker :

1. Apres l'inscription dans le compte personnel AppMetrica, l'integration du SDK dans l'application et la configuration du suivi des actions ciblees, vous pouvez proceder a la creation du tracker.
2. Specifiez le nom du tracker.
3. Ajoutez l'application.

Des instructions detaillees sont disponibles sur la page de documentation AppMetrica.

Transfert des donnees d'installation :

4. Choisissez le destinataire du postback (AdsGram).
5. Specifiez le type d'evenement qui doit etre envoye a AdsGram.
6. Obtenez l'URL de postback — le lien via lequel les evenements et installations seront envoyes au serveur AdsGram.
7. Apres avoir cree les postbacks, vous recevrez un lien de suivi. Ce lien doit etre utilise lors de la creation de campagnes dans AdsGram. De plus, vous pouvez ajouter des parametres supplementaires, tels que des balises UTM, si necessaire.

Keitaro

1. Creation d'un tracker dans Keitaro

1. Apres vous etre connecte au tableau de bord Keitaro, accedez a la section Trackers.
2. Cliquez sur Create tracker ou New tracker.
3. Entrez le nom du tracker et selectionnez AdsGram comme type de source de trafic.
4. Cliquez sur Save pour creer le tracker.

2. Configuration du postback dans Keitaro

1. Dans les parametres du tracker cree, accedez a la section Postback ou API Integration.

2. Dans le champ Postback URL, entrez le point de terminaison AdsGram :

   https://api.adsgram.ai/confirm_conversion?

3. Ajoutez le parametre token requis et le parametre record. Le nom du parametre doit correspondre au parametre record specifie dans le Tracking Link.

   Par exemple, si vous transmettez la macro AdsGram dans le Tracking Link comme suit :

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&record={record_data}

   alors ce qui suit doit etre specifie dans le postback Keitaro :

   https://api.adsgram.ai/confirm_conversion?token=YOUR_UNIQUE_TOKEN&record={_record}

   Ou :

   • YOUR_UNIQUE_TOKEN — le jeton de votre profil AdsGram
   • record — le parametre transmis dans le Tracking Link
   • {_record} — une macro qui transmet la valeur d'origine du parametre record au postback

   WARNING

   Pour obtenir une valeur brute du systeme de suivi, ajoutez "_" (tiret bas) avant le nom de la macro. Cela concerne uniquement le tracker Keitaro et est necessaire pour prevenir les attaques XSS.

3. Configuration d'une campagne dans AdsGram

1. Copiez le Click URL depuis les parametres de votre tracker Keitaro (par exemple : https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. Dans le tableau de bord AdsGram, lors de la creation d'une campagne, collez ce lien dans le champ Click URL.
3. Ajoutez les macros AdsGram requises au lien :

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. Assurez-vous que la macro {record_data} est incluse dans le lien final.

4. Configuration des objectifs dans Keitaro

1. Dans les parametres de votre tracker Keitaro, accedez a la section Goals ou Conversions.
2. Creez un nouvel objectif ou selectionnez-en un existant.
3. Activez l'envoi de postback vers l'URL precedemment specifiee pour cet objectif.
4. Definissez les conditions de declenchement (par exemple, lors de la confirmation de conversion ou d'un statut specifique).

Kochava

1. Creation d'un tracker dans Kochava

1. Apres vous etre connecte au tableau de bord Kochava, accedez a la section Apps & Assets.
2. Cliquez sur Add New et selectionnez App pour creer un nouveau tracker d'application.
3. Remplissez les champs requis :
   • Platform : Choisissez la plateforme de l'application (iOS, Android, Web).
   • App Name : Entrez le nom de votre application.
   • Store ID : Entrez l'identifiant de l'application dans le store (App Store ID, Package Name, etc.).
4. Cliquez sur Save pour creer l'application.

2. Configuration de l'integration partenaire

1. Sur la page de l'application creee, naviguez vers la section Partner Management.
2. Cliquez sur Add Partner.
3. Trouvez et selectionnez AdsGram dans la liste des partenaires.
4. Cliquez sur Next pour proceder aux parametres de configuration.

3. Configuration des parametres d'integration

1. Dans la section Integration Settings, selectionnez le type de suivi (Click-Through, View-Through ou Hybride).

2. Activez l'option Server-to-Server Postbacks.

3. Dans le champ Postback URL, entrez le point de terminaison AdsGram :

   https://api.adsgram.ai/confirm_conversion

4. Ajoutez les parametres suivants aux parametres de Postback :

   • Parametre requis : {record_data} (insere automatiquement par Kochava).
   • Ajoutez le parametre : token avec la valeur YOUR_UNIQUE_TOKEN (pris depuis votre profil AdsGram).

5. Configurez les macros de correspondance de donnees :

   • {campaign_id} -> campaign_id
   • {click_id} -> click_id
   • {publisher_id} -> publisher_id

4. Configuration d'une campagne dans AdsGram

1. Retournez a la section Tracking Links dans Kochava et creez un lien de suivi (par exemple : https://your-app.kochava.com/install?data={encrypted_data}).
2. Dans le tableau de bord AdsGram, lors de la creation d'une campagne, collez ce lien dans le champ Click URL.
3. Ajoutez les macros AdsGram obligatoires au lien en tant que parametres :

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. Assurez-vous que la macro {record_data} est incluse dans l'URL finale.

5. Configuration des evenements dans Kochava

1. Dans le tableau de bord Kochava, accedez a la section Events.
2. Creez un nouvel evenement ou choisissez-en un standard (par exemple, install, purchase).
3. Configurez le postback pour l'evenement selectionne :
   • Activez Send Postback.
   • Selectionnez l'integration AdsGram precedemment creee.
   • Definissez les filtres et conditions de declenchement.
4. Enregistrez la configuration de l'evenement.

6. Test de l'integration

1. Utilisez le mode Test dans Kochava pour verifier le suivi des installations.
2. Verifiez les requetes entrantes dans les journaux Kochava et AdsGram.
3. Assurez-vous que le parametre record_data est transmis correctement.

AppsFlyer

L'integration d'AdsGram avec AppsFlyer vous permet d'envoyer a AdsGram des donnees sur les installations d'application et les actions des utilisateurs au sein de l'application.

Une fois l'integration configuree, AdsGram recevra :

• Les installations d'application - automatiquement attribuees a Goal 1
• Tous les autres In-App Events - automatiquement attribues a Goal 2

Aucune configuration supplementaire ni mise en correspondance evenement-objectif n'est requise dans AdsGram. Par exemple, si des evenements comme registration, purchase, deposit, etc. sont envoyes depuis AppsFlyer, ils seront tous automatiquement comptabilises sous Goal 2.

IMPORTANT

Les campagnes tCPA ne peuvent etre lancees que sur Goal 1. Cela signifie que les campagnes tCPA ne peuvent etre optimisees que pour les installations d'application. Les In-App Events envoyes vers Goal 2 ne peuvent pas etre utilises comme objectif pour les campagnes tCPA.

1. Connexion d'AdsGram via Integrated Partners

AdsGram est un partenaire integre d'AppsFlyer. Pour vous connecter :

• Accedez a Collaboration → Partner Marketplace dans AppsFlyer
• Recherchez AdsGram (nom marketing) ou adsgram1e_int (nom technique) et selectionnez le partenaire

2. Configurer les Postbacks d'installation

Ouvrez l'onglet Integration :

• Activez Activate Partner
• Desactivez AAP (doit etre desactive a la fois dans les parametres de l'application et dans cet onglet)
• Dans Install Postback, selectionnez This partner only. Cela signifie qu'AdsGram recevra les installations attribuees a AdsGram. Ces installations seront comptabilisees comme Goal 1 dans AdsGram.

IMPORTANT

Si vous souhaitez lancer une campagne optimisee pour les installations, assurez-vous que les installations sont envoyees a AdsGram et affichees sous Goal 1. Les campagnes tCPA optimisees pour les installations ne peuvent etre lancees que sur Goal 1.

3. Configurer les Postbacks d'evenements in-app

Configurez les postbacks pour les In-App Events (achats, inscriptions, etc.) dans la section In-App Event Postbacks :

• Ajoutez les evenements requis, par exemple :
  • purchase - achats
  • af_complete_registration - inscriptions
• Dans le champ For users from, selectionnez This partner only
• AdsGram ne recoit que l'evenement lui-meme, sans ses parametres ni ses revenus. Vous pouvez donc selectionner No values & no revenue dans Including

Recommande :

• Autoriser la configuration de l'integration (a l'exception des postbacks d'evenements in-app)
• Autoriser la configuration des postbacks d'evenements in-app

Les autres autorisations (rapports de retention, revenus, etc.) sont facultatives.

Une fois l'integration configuree, cliquez sur Save Integration.

4. Configurer le Tracking Link

Ouvrez l'onglet Tracking Link :

• AppsFlyer generera automatiquement un lien de suivi pour AdsGram et ajoutera l'identifiant de partenaire requis : pid=adsgram1e_int
• Les 4 macros AdsGram seront remplies automatiquement (af_storeid, c, etc.)
• Si necessaire, ajoutez des parametres statiques supplementaires
• Dans Click-through attribution, selectionnez la fenetre d'attribution. La valeur par defaut est 7 jours, mais vous pouvez la modifier si necessaire

5. Configurer les Permissions

Ouvrez l'onglet Permissions et activez les autorisations requises :

• Acces au tableau de bord de l'application
• Conversions agregees
• Evenements
• Protect360

👉 Cliquez sur Save Integration

6. Configuration de la campagne dans AdsGram

Lors de la creation d'une campagne dans AdsGram :

• Inserez le Click link dans le champ Link. Le systeme generera automatiquement un lien de suivi AppsFlyer et ajoutera les macros requises
• Specifiez dans le lien de suivi AppsFlyer votre nom de package/bundle s'il n'est pas deja inclus (par exemple, id12345678 ou com.app.name)
• Dans le champ Link qui apparait, saisissez le lien direct vers votre produit sur Google Play / App Store / RuStore

7. Remarques

• La configuration s'applique a toutes les bannieres de la campagne
• L'annonceur est responsable de l'exactitude des parametres du lien et de l'attribution
• En cas d'utilisation d'un lien personnalise, vous devez egalement indiquer un lien direct vers le produit dans le champ Link