Migrer vers les flows
Dans Adapty, un flow combine 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 créez et diffusez indépendamment aujourd’hui.
Ce guide explique ce qui change lorsque vous passez aux flows et comment déployer la transition sans perturber les utilisateurs sur les anciennes versions de l’application.
Les flows sont actuellement pris en charge sur iOS, Android, React Native, Flutter et Capacitor SDK v4 et supérieur. La prise en charge d’autres plateformes et frameworks arrive prochainement.
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 passer l’utilisateur de l’onboarding au paywall dans votre propre code.
Un flow remplace les deux par une expérience unique — écrans d’introduction, quiz et écran d’achat — créée dans un seul éditeur et diffusée depuis un seul placement.
Le tableau ci-dessous compare ce que chaque option vous offre :
| Flow | Paywall Paywall Builder | Onboarding | |
|---|---|---|---|
| Plusieurs écrans | Oui | Non — écran unique | Oui |
| Rendu | Natif | Natif | WebView |
| Produits et placement | Un placement ; vous ajoutez les produits directement dans le flow | Un placement ; vous ajoutez les produits directement dans le paywall | Un placement, mais sans produits propres — pour vendre, vous créez un paywall séparé diffusé depuis son propre placement |
Faut-il migrer ?
Vos onboardings et paywalls existants continuent de fonctionner, et Adapty continue de les prendre en charge. Les nouvelles fonctionnalités sont désormais livrées sur les flows plutôt que sur les builders d’onboarding et de paywall autonomes.
Si vous construisez sur le long terme, les flows sont la meilleure base — migrez vers eux dès que cela s’intègre à votre calendrier de publication.
Comment migrer
La migration comporte quatre étapes. L’essentiel du travail est une mise à jour SDK unique — la création et la prévisualisation du flow ne nécessitent aucun code.
- Créez votre flow : Créez un flow dans l’éditeur no-code ; aucun développeur nécessaire.
- Prévisualisez sur l’appareil : Vérifiez le flow sur un vrai appareil via l’application mobile Adapty ; aucune compilation de l’app 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 iOS, Android, React Native ou Capacitor v4, récupérez le flow depuis son placement, et vérifiez un achat sandbox. C’est la principale tâche du développeur.
Créez votre flow
Sur la page Flows, cliquez sur Create flow pour commencer à créer votre onboarding et paywall en une seule expérience. Pour en savoir plus sur le builder :
- Documentation Flows : Vous guide à travers le builder et ce que vous pouvez créer.
- Recettes de flows courants : Guides pas à pas pour les écrans les plus courants.
- Demander à l’IA : Utilisez le chat sur n’importe quelle page de la documentation si vous êtes bloqué.
La création d’un flow à partir d’un modèle prêt à l’emploi ou sa génération avec l’IA ne sont pas encore disponibles — les deux arrivent prochainement. Pour l’instant, chaque nouveau flow démarre avec plusieurs écrans fréquemment utilisés que vous pouvez modifier et styliser selon vos besoins.
Prévisualisez sur l’appareil
Vous pouvez prévisualiser le flow sur un vrai appareil sans toucher à l’application. Téléchargez l’application Adapty depuis l’App Store. Ensuite, dans le builder de flow, 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 prévisualisation, Adapty ne peut pas accéder à vos produits dans les stores, donc les prix affichés ne sont pas réels. Les vrais achats sont vérifiés plus tard, dans le build v4 avec un compte sandbox — voir Mettez à jour le SDK.
Créez un nouveau placement pour votre flow
Un placement diffuse un seul type de contenu — un flow, un paywall ou un onboarding. Vous ne pouvez pas convertir un placement d’onboarding ou de paywall existant en placement de flow (voir types de placement). Un flow a besoin de son propre nouveau placement.
Donnez au nouveau placement de flow un identifiant de placement entièrement nouveau et unique. Il ne peut pas correspondre ou réutiliser l’identifiant d’un placement de paywall ou d’onboarding existant.
Gardez vos anciens placements actifs pendant la transition
Les utilisateurs sur les anciennes versions de l’application ont vos identifiants de placement d’onboarding et de paywall compilés dans l’app. Ils continuent d’appeler les méthodes d’onboarding et de paywall et voient vos onboardings et paywalls existants jusqu’à ce qu’ils mettent à jour. Ne retirez les anciens placements qu’une fois que votre taux d’adoption du SDK v4 est suffisamment élevé.
Vous n’avez pas à migrer tous les emplacements vers les flows en même temps. Dans le SDK v4, la méthode getFlow récupère depuis les placements de flow et les placements de paywall, donc votre application appelle la même méthode partout. Gardez les paywalls Paywall Builder dans les placements où vous le souhaitez, et utilisez les 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’app sont actives, vos données se répartissent entre deux ensembles de placements. Les anciens placements d’onboarding et de paywall couvrent les versions plus anciennes ; le nouveau placement de flow couvre le SDK v4+. Comparez-les comme des cohortes séparées, 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 standard sur des variantes de flow dans un placement de flow. Les tests A/B inter-placements ne sont actuellement disponibles que pour les paywalls, vous ne pouvez donc pas encore en lancer un sur des placements de flow. Comparer un nouveau flow avec votre ancien paywall est une comparaison de cohortes, pas un seul test — ils se trouvent sur des types de placement différents.
Mettez à jour le SDK
Une fois votre placement de flow prêt, pointez l’application vers celui-ci. Les flows ne s’affichent que sur le SDK Adapty v4 et versions ultérieures. Mettez à jour le SDK et récupérez le flow depuis votre nouveau placement avec getFlow. Consultez le guide de migration v4 pour votre plateforme — iOS, Android, React Native, ou Capacitor — pour les étapes de mise à jour spécifiques.
Une fois le flow intégré, vérifiez-le comme n’importe quel autre flux d’achat : lancez-le sur un appareil ou un simulateur et effectuez un achat sandbox (iOS / Android) pour confirmer que les produits, l’achat et le niveau d’accès fonctionnent tous correctement.
Les utilisateurs voient les flows uniquement après avoir installé l’application compilée avec le SDK v4+. Toute personne utilisant une version plus ancienne de l’application continue de recevoir votre onboarding et paywall existants, c’est pourquoi les anciens placements restent actifs pendant la transition. Il en va de même pour les plateformes qui ne prennent pas encore en charge les flows.
