Migrer vers les flows
Dans Adapty, un flow regroupe un onboarding et un paywall en une seule entité derrière un placement. Un flow remplace l’onboarding et le paywall séparés que vous construisez et servez indépendamment.
À partir du 1er octobre 2026, vous ne pourrez plus créer de nouveaux paywalls et onboardings dans les anciens builders, et leur support prendra fin. Tout ce que vous avez déjà continue de fonctionner et reste modifiable — consultez ce qui change à cette date.
Ce guide explique ce qui change lorsque vous passez aux flows, et comment déployer ce changement sans perturber les utilisateurs sur les anciennes versions de l’application.
Les flows nécessitent le SDK Adapty v4.0 ou une version ultérieure.
Flows vs. onboardings et paywalls
Avec des onboardings et des paywalls séparés, vous gérez deux builders et deux placements. Vous devez aussi assurer vous-même la transition de l’onboarding vers le paywall dans votre code.
Un flow remplace les deux par une expérience unique — écrans d’introduction, quiz et écran d’achat — conçue dans un seul éditeur et servie depuis un seul placement. Ce placement est nouveau : un flow est son propre type de contenu, il ne peut donc pas s’exécuter sur le placement d’onboarding ou de paywall qu’il remplace.
Le tableau ci-dessous compare ce que chaque option vous offre :
| Flow | Paywall Builder paywall | Onboarding | |
|---|---|---|---|
| Plusieurs écrans | Oui | Non — écran unique | Oui |
| Rendu | Natif | Natif | WebView |
| Produits et placement | Un placement ; vous ajoutez les produits directement au flow | Un placement ; vous ajoutez les produits directement au paywall | Un placement, mais sans produits propres — pour vendre, vous créez un paywall séparé et le servez depuis son propre placement |
Devriez-vous migrer ?
Si vous construisez sur le long terme, les flows sont une meilleure base — migrez vers eux quand cela correspond à votre calendrier de versions.
Comment migrer
La migration comporte quatre étapes. L’essentiel du travail est une mise à niveau unique du SDK — la création et la prévisualisation du flow se font sans code.
- Créez votre flow : Convertissez un paywall existant en un clic, ou créez un flow à partir d’un template ; aucun développeur nécessaire.
- Prévisualisez sur un appareil : Vérifiez le flow sur un vrai appareil via l’application mobile Adapty ; aucune compilation d’application nécessaire.
- Créez un nouveau placement pour votre flow : Créez un nouveau placement de flow avec son propre identifiant unique, et décidez comment il coexiste avec vos placements existants.
- Mettez à jour le SDK : Passez au SDK Adapty v4, récupérez le flow depuis son placement, et vérifiez un achat en sandbox. C’est la principale tâche développeur.
Créez votre flow
Si votre paywall a été conçu dans le Paywall Builder Legacy, convertissez-le plutôt que de le reconstruire. L’action Move to new builder le recrée en tant que flow en brouillon en un seul clic — mise en page, texte dans chaque langue, et produits avec les prix en tant que variables — et votre original reste en ligne pendant que vous modifiez et testez. Voir Convertir un paywall en flow.
Pour créer quelque chose de nouveau à la place, choisissez l’option qui vous convient :
- Commencer à partir d’un modèle : un modèle de départ ou un flow vide dans le Flow Builder, sans code.
- Utiliser le skill IA : votre propre outil de codage IA crée et modifie des flows depuis le terminal — pratique pour les quiz, les branchements et l’ajout de locales en masse.
Référence pendant la création :
- Documentation du Flow Builder : Présente le builder et ce que vous pouvez créer avec.
- Recettes de flows courants : Guides étape par étape pour les écrans les plus fréquents.
- Demandez à l’IA : Utilisez le chat sur n’importe quelle page de documentation si vous êtes bloqué.
Aperçu sur appareil
Vous pouvez prévisualiser le flow sur un vrai appareil sans toucher au code de l’application. Téléchargez l’application mobile Adapty pour iOS ou Android. Ensuite, dans le flow builder, cliquez sur Test on device, choisissez une locale et scannez le QR code avec votre appareil. Vous verrez les vrais écrans, les branchements, les textes et le design.
En mode aperçu, Adapty ne peut pas accéder à vos produits dans les stores, donc les prix affichés dans l’aperçu ne sont pas réels. Les vrais achats sont vérifiés plus tard, dans le build v4 avec un compte sandbox — voir Mettre à jour le SDK.
Créer un nouveau placement pour votre flow
Les flows, les paywalls et les onboardings sont trois types de contenus distincts, chacun mesuré avec son propre ensemble de métriques — c’est pourquoi un placement ne sert qu’un seul type à la fois. Le type d’un placement est fixé à sa création, il n’est donc pas possible de convertir un placement onboarding ou paywall existant en placement flow (voir types de placement). Chaque flow que vous diffusez nécessite un nouveau placement qui lui est propre.
Donnez au nouveau placement flow un identifiant de placement entièrement nouveau et unique.
Les IDs de placement sont uniques dans toute l’application et non par type, donc un placement de flow ne peut pas réutiliser l’ID d’un placement de paywall ou d’onboarding — même celui dont le flow remplace le contenu. Ce n’est pas une question de préférence : le Dashboard le rejette.
Gardez vos anciens placements actifs pendant la transition
Les utilisateurs sur d’anciennes versions de l’app ont vos identifiants de placement d’onboarding et de paywall compilés dans l’app. Ils continuent à appeler les méthodes d’onboarding et de paywall et voient votre onboarding et votre paywall existants jusqu’à ce qu’ils mettent à jour. Ne retirez les anciens placements qu’une fois que l’adoption du SDK v4 est suffisamment élevée.
Vous n’avez pas à migrer tous les emplacements vers des flows en une seule fois. Dans le SDK v4, la méthode getFlow récupère aussi bien depuis les placements de flow que depuis les placements de paywall, donc votre app appelle la même méthode partout. Conservez les paywalls du Paywall Builder dans les placements où vous le souhaitez, et utilisez des flows dans les autres.
Pendant la transition, chaque type de placement suit ses propres métriques. Tant que les anciennes et nouvelles versions de l’application sont actives, vos données se répartissent entre deux ensembles de placements. Les anciens placements d’onboarding et de paywall couvrent les versions antérieures ; le nouveau placement de flow couvre le SDK v4+. Comparez-les comme des cohortes distinctes, et attendez-vous à ce que la part du placement de flow augmente au fur et à mesure que les utilisateurs mettent à jour.
Vous pouvez continuer à faire des tests A/B avec les flows : lancez un test A/B classique entre des variantes de flow sur un placement de flow. Les tests A/B cross-placement ne sont actuellement disponibles que pour les paywalls, il n’est donc pas encore possible d’en lancer un sur des placements de flow. Comparer un nouveau flow avec votre ancien paywall est une comparaison de cohortes, pas un test unique — ils appartiennent à des types de placement différents.
Mettre à jour le SDK
Avec votre placement de flow prêt, pointez l’application dessus. Les flows ne s’affichent qu’à partir du SDK Adapty v4. Mettez à jour le SDK et récupérez le flow depuis votre nouveau placement avec getFlow. Consultez le guide de migration vers la v4 pour votre plateforme — iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, ou Capacitor — pour les étapes de mise à jour spécifiques.
Une fois le flow intégré, testez-le comme n’importe quel autre flow d’achat : exécutez-le sur un appareil ou un simulateur et effectuez un achat sandbox pour vérifier que les produits, l’achat et le niveau d’accès fonctionnent correctement. Consultez le guide de test pour votre plateforme : iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform ou Capacitor.
Les utilisateurs voient les flows uniquement après avoir installé l’application compilée avec SDK v4+. Toute personne utilisant une version antérieure de l’application continue de voir votre onboarding et votre paywall existants, c’est pourquoi les anciens placements restent actifs pendant la transition.
