Démarrer avec Adapty Mail

Dans ce guide, vous allez configurer Adapty Mail et lancer votre premier flow d’emails.

La configuration comporte six étapes :

1. Configurer votre SDK Adapty
2. Configurer votre domaine d’envoi
3. Créer un paywall web
4. Générer une campagne avec l’IA
5. Lancer un flow
6. Activer l’envoi

Avant de commencer

Assurez-vous que les éléments suivants sont en place avant de commencer :

• Accès DNS : vous pouvez ajouter des enregistrements à votre domaine racine.
• Prestataire de paiement web : vous disposez d’un compte Stripe, Paddle ou PayPal avec vos produits d’abonnement configurés.

1. Configurer votre SDK Adapty

Adapty Mail a besoin de trois éléments de votre application : les données d’achat (pour attribuer les revenus à l’email qui a généré chaque conversion), un identifiant utilisateur stable et les emails des utilisateurs.

1. Permettez à Adapty de suivre vos revenus. La première étape dépend de si vous avez déjà mis en œuvre des achats intégrés :

   • Si vous avez déjà mis en œuvre des achats intégrés avec Adapty, vous n’avez rien d’autre à faire à cette étape.
   • Si vous avez déjà mis en œuvre des achats intégrés sans Adapty et ne prévoyez pas de migrer vers Adapty, installez le SDK Adapty pour votre plateforme en mode observateur. À cette étape, vous devez seulement ajouter le SDK à votre projet, l’activer avec le mode observateur activé, et signaler les transactions. Guides par plateforme : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
   • Si vous n’avez pas encore mis en œuvre des achats intégré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 de l’App Store dans Adapty pour recevoir les mises à jour liées aux revenus directement depuis l’App Store.

2. Configurez l’identification des utilisateurs. Transmettez un identifiant stable — votre identifiant utilisateur backend, Firebase UID, ou similaire — soit en appelant Adapty.identify(), soit en passant customerUserId à .activate() au démarrage du SDK. Le customer_user_id est ce qu’Adapty Mail utilise pour relier les campagnes, les clics et les achats au bon profil.

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

3. Collectez 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 a besoin de cette valeur.

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

   Si votre application ne collecte pas encore les emails, consultez Stratégies de collecte d’emails.

2. Configurer votre domaine d’envoi

Ouvrez Adapty Mail : cliquez sur le logo Adapty dans l’en-tête et choisissez Mail.

Adapty Mail envoie depuis votre propre domaine. Vous ajoutez les enregistrements DNS une seule fois — toutes les campagnes utilisent le même domaine vérifié.

1. Dans Adapty Mail, allez dans Settings → Email Domains.
2. Saisissez votre domaine racine (par exemple, votreapp.com) et cliquez sur Preview. Seuls les domaines apex sont acceptés — les sous-domaines comme app.votreapp.com sont refusés à la saisie.

3. Adapty génère deux sous-domaines d’envoi (mail.votreapp.com et email.votreapp.com). Cliquez sur Confirm pour afficher les enregistrements DNS requis.

4. Dans votre registrar de domaine, ajoutez les 10 enregistrements DNS affichés (5 par sous-domaine) :
   • 3 enregistrements CNAME (DKIM) par sous-domaine
   • 1 enregistrement MX (Mail-From) par sous-domaine
   • 1 enregistrement TXT (SPF, v=spf1 include:amazonses.com ~all) par sous-domaine
5. Optionnellement, ajoutez un enregistrement TXT DMARC sur votre domaine racine (recommandé).
6. Revenez dans Settings → Email Domains et cliquez sur Check Verification.

Délais de vérification en bref :

• Vérification automatique : la première vérification s’effectue environ 5 minutes après votre soumission. Les intervalles augmentent jusqu’à une fois par heure jusqu’à ce que les enregistrements soient trouvés.
• Vérification manuelle : cliquez sur Check Verification à tout moment pour déclencher une vérification immédiate.
• Propagation DNS : généralement en quelques minutes, jusqu’à 48 heures dans de rares cas.
• Fenêtre de vérification : 7 jours. Si elle expire, vos enregistrements DNS restent en place — saisissez à nouveau votre domaine dans Settings → Email Domains pour démarrer une nouvelle fenêtre.

Pour plus de détails sur chaque type d’enregistrement et le préchauffage du domaine, consultez Configurer votre domaine d’envoi.

3. Créer un paywall web

Chaque email renvoie vers un paywall web — la page de paiement sur laquelle les utilisateurs arrivent lorsqu’ils cliquent sur un CTA. Vous avez deux options :

• Générer avec l’IA : laissez le générateur de paywall web intégré en créer un pour votre application.
• Utiliser votre propre paywall hébergé : intégrez un paywall que vous hébergez déjà.

Pour commencer, dans Adapty Mail, allez dans Web Paywalls → Create.

Option A : Générer avec l’IA

La page affiche une liste de contrôle Prerequisites avec des boutons intégrés — parcourez-la dans l’ordre, puis revenez pour générer. La liste couvre la connexion au générateur de paywall, la connexion à Stripe, l’ajout de produits et la vérification du résultat. Consultez Configurer le paiement pour la procédure complète.

Quand tous les prérequis sont validés, cliquez sur Generate pour ouvrir la boîte de dialogue de génération :

• Environment : choisissez Production ou Sandbox. Sandbox utilise vos produits en mode test Stripe et est l’option par défaut sécurisée pour les environnements de développement et locaux.
• Plans : sélectionnez jusqu’à 3 plans Stripe (chaque plan est un produit + un prix). Ce sont les offres que le paywall généré présente aux utilisateurs lors du paiement.

Cliquez sur Generate pour lancer la génération. Lorsqu’elle est terminée, ouvrez l’éditeur pour vérifier et publier.

Option B : Utiliser votre propre paywall hébergé

1. Sélectionnez Enter URL manually.

2. Collez l’URL de votre paywall hébergé. L’URL doit inclure les paramètres {email} et {external_profile_id} en tant que paramètres de requête — Adapty Mail les renseigne pour chaque destinataire afin que la page de paiement sache qui est le visiteur. Exemple :

   https://example.com/paywall?email={email}&profile={external_profile_id}

3. Enregistrez et publiez.

Pour l’anatomie du tunnel de paiement et le fonctionnement de la personnalisation, consultez Configurer le paiement.

4. Générer une campagne avec l’IA

L’IA crée la séquence d’emails complète pour vous — texte, design, images hero et liens de paiement personnalisés, le tout adapté à votre marque.

1. Dans Adapty Mail, allez dans Campaigns et cliquez sur Create.
2. Définissez le nom de la campagne.
3. Dans le menu déroulant Web paywall, sélectionnez le paywall web que vous avez ajouté à l’étape précédente.

4. Cliquez sur Generate emails.
5. Remplissez la boîte de dialogue de génération — ton, langue, une invite personnalisée optionnelle (jusqu’à 2 000 caractères) et le nombre d’emails (1 à 15, par défaut 4). Consultez Créer une campagne pour savoir ce que fait chaque champ.

6. Cliquez sur Generate. La génération prend généralement quelques minutes. Le système expire après 5 minutes s’il ne parvient pas à terminer — réessayez si cela se produit.
7. Prévisualisez chaque email. L’en-tête de prévisualisation dispose d’un bouton de thème (Auto, Light, Dark) qui contrôle l’affichage de la prévisualisation — le contenu généré est identique dans tous les modes. Vous pouvez régénérer des emails individuels, modifier le texte ou ouvrir l’éditeur HTML pour un contrôle précis.

8. Cliquez sur Create pour enregistrer la campagne.

La campagne est enregistrée en tant que brouillon et n’envoie pas encore — les campagnes ne deviennent actives que lorsqu’elles sont associées à un flow (étape suivante). Il n’y a pas d’action “publier” distincte dans l’éditeur de campagne.

5. Lancer un flow

Un flow associe un déclencheur (un événement comme l’expiration d’un abonnement) à un segment, et envoie à ce segment la campagne que vous choisissez. Adapty Mail est livré avec cinq déclencheurs fixes, chacun avec sa propre vue de flow.

1. Dans Adapty Mail, allez dans Flows, puis ouvrez le déclencheur que vous souhaitez configurer :

   • Never purchased — utilisateurs qui se sont inscrits mais n’ont pas encore effectué d’achat.
   • Renewal cancelled — utilisateurs qui ont désactivé le renouvellement automatique mais disposent encore d’un abonnement actif.
   • Billing issue — échec de paiement, carte refusée ou expirée, ou délai de grâce.
   • Expired — l’abonnement a expiré et l’accès est révoqué.
   • Refunded — utilisateurs qui ont demandé un remboursement après un achat.

   Consultez Flows pour les objectifs et les conseils de ton associés à chaque déclencheur.

2. Cliquez sur Create pour ouvrir la boîte de dialogue.

3. Dans la boîte de dialogue :
   • Choisissez un Segment (par exemple, All Users pour cibler tous ceux qui atteignent ce déclencheur, ou créez un nouveau segment basé sur les attributs du profil).
   • Laissez le type de contenu défini sur Campaign (l’option A/B Test est décrite dans Tests A/B).
   • Sélectionnez la Campaign que vous avez enregistrée à l’étape 4.
4. Cliquez sur Save.

Le flow est actif immédiatement — il n’y a pas d’étape de lancement distincte. À partir de ce moment, les utilisateurs correspondant au segment commenceront à recevoir la campagne dès qu’ils atteignent l’événement déclencheur.

6. Activer l’envoi

Jusqu’à présent, votre campagne est configurée mais n’envoie pas réellement — l’intégration Adapty qui synchronise les événements d’abonnement dans Adapty Mail est encore désactivée. L’activer est le dernier interrupteur : les événements commencent à circuler, les segments commencent à correspondre, et les emails commencent à être envoyés.

Cette étape n’est débloquée qu’après l’étape 5. Avant de lancer un flow, le bouton Enable dans Settings → Integrations est désactivé avec l’info-bulle « Set up at least one flow before enabling Adapty integration. »

1. Dans Adapty Mail, allez dans Settings → Integrations.
2. Cliquez sur Enable Adapty integration (ou Enable si l’intégration existe déjà suite à une configuration précédente).

Une fois 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 alimentent 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.

Dépannage

En savoir plus

• Collecter les emails des utilisateurs : stratégies pour obtenir la couverture email si votre application ne les collecte pas encore.
• Configurer votre domaine d’envoi : détails des enregistrements DNS, niveaux de préchauffage et dépannage.
• Configurer le paiement : anatomie du tunnel de paiement et personnalisation.
• Analytique des campagnes : suivez la délivrabilité, l’engagement et les revenus.
• Tests A/B : testez plusieurs versions de séquences.