Migrer vers les flows
Dans Adapty, un flow regroupe un onboarding et un paywall en une seule entité rattachée à un placement. Un flow remplace l’onboarding et le paywall distincts que vous construisez et servez séparément aujourd’hui.
Ce guide explique ce qui change lors du passage aux flows et comment déployer ce changement sans perturber les utilisateurs sur des versions d’application plus anciennes.
Les flows sont actuellement pris en charge sur iOS, Android, React Native, Flutter et Capacitor SDK v4 et versions ultérieures. 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 transférer les utilisateurs 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 servie depuis un seul placement.
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 |
Devez-vous migrer ?
Vos onboardings et paywalls existants continuent de fonctionner, et Adapty continue de les prendre en charge. Les nouvelles fonctionnalités, en revanche, sont désormais publiées dans les flows plutôt que dans les builders d’onboarding et de paywall indépendants.
Si vous construisez sur le long terme, les flows sont une meilleure base — migrez vers eux quand cela s’intègre à votre calendrier de publication.
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 : Créez un flow dans l’éditeur no-code ; aucun développeur nécessaire.
- Prévisualisez sur un appareil : Vérifiez le flow sur un vrai appareil via l’application mobile Adapty ; aucune build 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 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 votre paywall en une seule expérience. Pour en savoir plus sur le builder :
- Documentation sur les flows : vous guide à travers le builder et ce que vous pouvez créer.
- Recettes de flows courantes : guides pas à pas pour les écrans les plus courants.
- Ask AI : utilisez le chat sur n’importe quelle page de la documentation en cas de blocage.
La création d’un flow à partir d’un modèle prêt à l’emploi ou par génération avec l’IA n’est pas encore disponible — ces deux options arrivent prochainement. Pour l’instant, chaque nouveau flow démarre avec plusieurs écrans couramment utilisés que vous pouvez modifier et styliser selon vos besoins.
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
Un placement ne sert qu’un seul type de contenu — un flow, un paywall ou un onboarding. Vous ne pouvez pas convertir un placement onboarding ou paywall existant en placement flow (voir types de placement). Un flow a besoin de son propre nouveau placement.
Donnez au nouveau placement flow un identifiant de placement entièrement nouveau et unique. Il ne peut pas correspondre ni réutiliser l’identifiant d’un placement paywall ou onboarding existant.
Conservez vos anciens placements actifs pendant la transition
Les utilisateurs sur d’anciennes versions de l’application ont les identifiants de vos placements onboarding et paywall compilés dans l’app. Ils continuent d’appeler les méthodes onboarding et paywall et voient votre onboarding et 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 besoin de migrer tous vos emplacements vers les flows en une seule fois. Dans le SDK v4, la méthode getFlow récupère les données aussi bien depuis les placements de flows que depuis les placements de paywalls, donc votre application utilise la même méthode partout. Conservez vos paywalls Paywall Builder dans les placements où vous le souhaitez, et utilisez les flows pour le reste.
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
Une fois votre placement de flow prêt, reliez l’application à celui-ci. Les flows ne s’affichent qu’avec le SDK Adapty v4 ou ultérieur. 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 ou Capacitor — pour les étapes détaillées de mise à jour.
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 correctement.
Les utilisateurs voient les flows uniquement après avoir installé l’application compilée avec le SDK v4+. Les personnes sur une version plus ancienne continuent à voir votre onboarding et votre 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.
