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 est un produit autonome. Vous pouvez l’utiliser même si vos paywalls, abonnements ou analyses ne sont pas gérés par Adapty — migrer toute votre infrastructure n’est pas nécessaire.
Pour obtenir des données de revenus précises, la configuration minimale consiste à installer le SDK Adapty en mode observateur et à activer les notifications serveur de l’App Store.
Adapty Mail a besoin de trois éléments de votre application : des données d’achat (pour attribuer les revenus à l’e-mail qui a généré chaque conversion), un identifiant utilisateur stable, et les e-mails des utilisateurs. Configurez ces trois éléments, puis activez l’envoi.
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.
- Transmettez toujours un
customer_user_idstable, jamais un identifiant anonyme. Si un utilisateur désinstalle puis réinstalle votre application, Adapty utilise cet identifiant pour relier la réinstallation au profil existant et rattacher les achats au bon utilisateur. - Obtenez le consentement explicite de l’utilisateur avant de collecter et d’envoyer des e-mails à Adapty. Vous êtes responsable du respect du RGPD, du CAN-SPAM et des réglementations similaires dans vos marchés cibles.
Vérifiez votre taux de couverture des e-mails
Après avoir mis en place la collecte, vérifiez la couverture dans Adapty :
- Allez dans Customers → Profiles.
- Filtrez par profils ayant une adresse e-mail renseignée.
Visez au moins 30 à 50 % de couverture e-mail parmi vos utilisateurs actifs avant de lancer votre première campagne. Inutile d’attendre 100 % — lancez dès que vous atteignez 30 %. Les utilisateurs qui renseignent leur e-mail plus tard sont automatiquement intégrés aux campagnes actives dès qu’ils remplissent les conditions.
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.
| Stratégie | Idéal pour | Comment ça fonctionne |
|---|---|---|
| Authentification existante | Applications avec tout type de connexion | Vous avez déjà l’e-mail — transmettez-le à Adapty après l’authentification de l’utilisateur. |
| Saisie d’e-mail avant le paywall | Applications sans authentification — santé, bien-être, astrologie, éditeurs photo | Ajoutez un écran de saisie d’e-mail entre l’onboarding et le paywall. Le taux de conversion est généralement de 70 à 90 %, car les utilisateurs ont déjà investi du temps. |
| Checkout du web paywall builder | Peu de travail SDK ; e-mail collecté sur le web | Le premier écran du web paywall builder collecte l’e-mail et le transmet à Adapty — utile pour les utilisateurs qui cliquent sur une campagne avant qu’une saisie in-app soit en place. |
| Étape d’onboarding | Onboarding sous forme de quiz (fitness, nutrition, éducation) | Placez une saisie d’e-mail 2 à 3 étapes après le début de l’onboarding. Présentez-la comme une valeur ajoutée (« Nous vous enverrons votre plan personnalisé par e-mail ») et évitez de la rendre facultative. |
| Adapty Mail API | Envoi d’e-mails depuis votre serveur, sans le SDK Adapty | Envoyez des profils vers l’endpoint Save profile de l’Adapty Mail API. Voir Envoyer des e-mails et des transactions via l’Adapty Mail API. |
4. Activer l’envoi
Revenez à cette étape une fois que le reste de votre configuration est prêt. Adapty Mail désactive le bouton Enable tant que vous n’avez pas au moins un flow, avec le message “Set up at least one flow before enabling Adapty integration” — finissez donc d’abord votre domaine d’envoi, votre checkout, votre campagne et votre flow. Consultez Démarrer avec Adapty Mail.
Activer l’intégration est l’interrupteur final : les événements commencent à circuler, les segments commencent à correspondre et les e-mails commencent à être envoyés.
- Dans Adapty Mail, rendez-vous dans Settings → Project et trouvez la section Adapty Integration.
- Cliquez sur Enable Adapty integration (ou Enable si l’intégration existe déjà depuis une configuration précédente).
Lorsqu’elle est activée, Adapty envoie chaque événement d’abonnement — nouveaux abonnements, renouvellements, essais, conversions, remboursements, problèmes de facturation — dans Adapty Mail. Ces événements pilotent 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.
La section Adapty Integration n’apparaît que pour les projets liés à un espace de travail Adapty. Si vous vous êtes inscrit directement à Adapty Mail et que votre projet n’est pas lié, cette section n’est pas disponible — envoyez vos données via l’API Adapty Mail à la place.
Le bouton Adapty integration dans les paramètres n’est pas le même que l’espace de travail partenaire Adapty qui vous a connecté à Adapty Mail. L’espace de travail partenaire est celui qui a créé votre compte et (si vous vous êtes inscrit via Adapty) votre marque. Le bouton d’intégration ici contrôle la synchronisation des événements — il doit être activé pour chaque projet.
Limitations
- Utilisateurs anonymes : les utilisateurs sans
customer_user_idstable 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.