Connect Adapty to Adapty Mail

Adapty est l’un des points d’entrée d’Adapty Mail — utilisez-le si votre application fait déjà tourner le SDK Adapty. Adapty transmet les profils, les adresses e-mail et les événements d’abonnement à Adapty Mail, qui les utilise pour sélectionner les destinataires, placer chaque personne dans un flow et attribuer les revenus à l’e-mail qui a généré l’achat.

Si votre application n’utilise pas le SDK Adapty, envoyez les mêmes données depuis votre serveur — consultez Envoyer des e-mails et des transactions via l’API Adapty Mail.

Adapty Mail a besoin de trois choses de votre application : des données d’achats (pour attribuer les revenus à l’e-mail qui a généré chaque conversion), un identifiant utilisateur stable, et les adresses e-mail des utilisateurs. Configurez ces trois éléments, puis paramétrez votre domaine, votre paiement, votre campagne et votre flow dans Adapty Mail, et activez l’envoi en dernier.

1. Laissez Adapty suivre vos revenus

La première étape dépend de si vous avez déjà des achats intégrés implémentés :

• Si vous avez déjà des achats intégrés implémentés avec Adapty, vous n’avez rien d’autre à faire à cette étape.
• Si vous avez déjà des achats intégrés implémentés sans Adapty et ne prévoyez pas de migrer vers Adapty, installez le SDK Adapty pour votre plateforme en mode observateur. À cette étape, il vous suffit d’ajouter le SDK à votre projet, de l’activer avec le mode observateur activé, et de signaler les transactions. Guides par plateforme : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
• Si vous n’avez pas encore d’achats intégrés implémentés et souhaitez utiliser Adapty, suivez les étapes du guide de démarrage rapide pour déléguer la gestion des achats à Adapty.

Ensuite, activez les notifications serveur App Store dans Adapty pour recevoir les mises à jour liées aux revenus directement depuis l’App Store.

2. Identifier vos utilisateurs

Transmettez un identifiant stable — l’ID utilisateur de votre backend, un UID Firebase ou équivalent — soit en le passant comme customerUserId à .activate() au démarrage du SDK, soit en appelant Adapty.identify() plus tard (par exemple, à la connexion). Dans tous les cas, définissez cet ID avant qu’un paywall ne soit affiché. Le customer_user_id permet à Adapty Mail de relier les campagnes, les clics et les achats au bon profil.

Guides par plateforme : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

3. Collecter les emails des utilisateurs

Dès qu’un utilisateur fournit son email dans votre application (par exemple, lors de l’inscription ou du paiement), transmettez-le à Adapty en appelant updateProfile avec l’attribut email. Chaque destinataire d’une campagne doit avoir cette valeur renseignée.

Guides par plateforme : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Stratégies de collecte d’e-mails

La plupart des applications ne collectent pas les e-mails par défaut. Choisissez l’approche qui correspond à l’état actuel de votre application.

4. Configurer le domaine, la page de paiement, la campagne et le flow

Pour envoyer des e-mails, Adapty Mail nécessite :

• Un domaine d’envoi vérifié
• Une page de paiement vers laquelle vos e-mails renverront
• Une campagne à envoyer
• Un flow qui détermine qui le reçoit

Configurez ces quatre éléments dans Adapty Mail — suivez les étapes 3 à 8 du guide Démarrer avec Adapty Mail.

5. Activer l’envoi

Activer l’intégration est le dernier interrupteur : les événements commencent à affluer, les segments à correspondre et les e-mails à partir. Que votre projet Mail soit lié à une application Adapty change uniquement la façon dont vous l’activez, pas ce qui arrive :

• Lié à une application Adapty. Adapty a créé ce projet pour vous la première fois que vous avez ouvert Mail depuis l’Adapty Dashboard.

Dans Adapty Mail, accédez à Settings > Project et, dans la section Adapty Integration, cliquez sur Enable Adapty integration (ou Enable si l’intégration existe déjà depuis une configuration précédente). Le bouton reste désactivé tant que vous n’avez pas au moins un flow, avec le message “Set up at least one flow before enabling Adapty integration”.

• Not linked. Vous avez créé ce projet vous-même dans Adapty Mail — que ce soit sur un compte indépendant ou votre compte Adapty.

  La section Adapty Integration n’apparaît pas, mais Adapty peut tout de même alimenter le projet — il suffit juste de la clé.

1. Dans Adapty Mail, accédez à Settings > Project et copiez la Secret key. 2. Dans l’Adapty Dashboard, accédez à Integrations > Adapty Mail, activez l’intégration, collez la clé dans Secret Key et sauvegardez.

Les deux méthodes créent la même intégration dans Adapty — le bouton dans Adapty Mail remplit automatiquement la clé secrète à votre place.

Lorsqu’elle est activée, Adapty envoie chaque événement d’abonnement — nouveaux abonnements, renouvellements, essais, conversions, remboursements, problèmes de facturation — vers Adapty Mail. Ces événements déterminent l’appartenance aux segments, le routage des campagnes et les conditions d’arrêt qui mettent en pause une séquence lorsqu’un utilisateur convertit.

Limitations

• Utilisateurs anonymes : les utilisateurs sans customer_user_id stable ne peuvent pas recevoir de campagnes. Identifiez-les lorsqu’ils créent un compte ou se connectent — à partir de ce moment, tout e-mail qu’ils fournissent est associé à leur profil Adapty.
• Utilisateurs sans e-mail : les profils sans e-mail sont exclus de la diffusion des campagnes et n’apparaissent pas dans les analyses de campagnes. Dès qu’ils fournissent un e-mail, ils deviennent éligibles aux futures campagnes.