Migrar a flows
En Adapty, un flow combina un onboarding y un paywall en una única entidad dentro de un placement. Un flow reemplaza el onboarding y el paywall por separado que hoy construyes y sirves de forma independiente. Esta guía explica qué cambia al migrar a flows y cómo implementar el cambio sin interrumpir a los usuarios en versiones anteriores de la app.
Los flows están disponibles actualmente en iOS, Android, React Native, Flutter y Capacitor SDK v4 en adelante. Próximamente se añadirá soporte para otras plataformas y frameworks.
Flows vs. onboardings y paywalls
Con onboardings y paywalls por separado, gestionas dos builders y dos placements. Además, tienes que gestionar en tu propio código el paso del usuario del onboarding al paywall.
Un flow reemplaza ambos con una sola experiencia — pantallas de introducción, un quiz y la pantalla de compra — construida en un único editor y servida desde un único placement.
La tabla de abajo compara lo que ofrece cada opción:
| Flow | Paywall de Paywall Builder | Onboarding | |
|---|---|---|---|
| Múltiples pantallas | Sí | No: una sola pantalla | Sí |
| Renderizado | Nativo | Nativo | WebView |
| Productos y placement | Un placement; añades productos directamente al flow | Un placement; añades productos directamente al paywall | Un placement, pero sin productos propios: para vender, creas un paywall independiente y lo sirves desde su propio placement |
¿Deberías migrar?
Tus onboardings y paywalls existentes siguen funcionando, y Adapty continuará dando soporte. Sin embargo, las nuevas funcionalidades ahora se incorporan en los flows en lugar de en los editores independientes de onboarding y paywall.
Si estás construyendo a largo plazo, los flows son la mejor base: migra a ellos cuando encaje en tu calendario de lanzamientos.
Cómo migrar
La migración tiene cuatro pasos. La mayor parte del trabajo es una actualización puntual del SDK — crear y previsualizar el flow no requiere código.
- Crea tu flow: Crea un flow en el editor visual sin código; no necesitas desarrolladores.
- Previsualiza en el dispositivo: Comprueba el flow en un dispositivo real a través de la app móvil de Adapty; no necesitas compilar la app.
- Crea un nuevo placement para tu flow: Crea un nuevo placement de flow con su propio ID único y decide cómo coexiste con tus placements actuales.
- Actualiza el SDK: Actualiza a iOS, Android, React Native o Capacitor SDK v4, obtén el flow desde su placement y verifica una compra en sandbox. Esta es la tarea principal del desarrollador.
Crea tu flow
En la página Flows, haz clic en Create flow para empezar a construir tu onboarding y paywall como una sola experiencia. Para saber más sobre el builder:
- Documentación de flows: Te guía por el builder y lo que puedes crear.
- Recetas de flows habituales: Guías paso a paso para las pantallas más comunes.
- Pregunta a la IA: Usa el chat en cualquier página de la documentación cuando te quedes atascado.
Crear un flow a partir de una plantilla lista o generarlo con IA todavía no está disponible — ambas opciones llegarán próximamente. Por ahora, cada nuevo flow comienza con varias pantallas de uso común que puedes editar y personalizar según tus necesidades.
Vista previa en el dispositivo
Puedes previsualizar el flow en un dispositivo real sin tocar la app. Descarga la app de Adapty desde el App Store. Luego, en el flow builder, haz clic en Test on device, elige un idioma y escanea el código QR con tu dispositivo. Así verás las pantallas reales, las ramificaciones, los textos y el diseño.
En el modo de vista previa, Adapty no puede acceder a tus productos en los stores, así que los precios que se muestran no son reales. Las compras reales se verifican más adelante, en la build v4 con una cuenta sandbox — consulta Actualizar el SDK.
Crea un nuevo placement para tu flow
Un placement sirve para un único tipo de contenido: un flow, un paywall o un onboarding. No puedes convertir un placement de onboarding o paywall existente en un placement de flow (consulta los tipos de placement). Un flow necesita su propio placement nuevo.
Dale al nuevo placement de flow un ID de placement completamente nuevo y único. No puede coincidir ni reutilizar el ID de un placement de paywall o onboarding existente.
Mantén tus placements antiguos activos durante la transición Los usuarios con versiones antiguas de la app tienen los IDs de placement de onboarding y paywall compilados en la app. Seguirán llamando a los métodos de onboarding y paywall y verán tu onboarding y paywall existentes hasta que actualicen. Retira los placements antiguos solo cuando la adopción del SDK v4 sea suficientemente alta.
No es necesario migrar todos los placements a flows de una vez. En SDK v4, el método getFlow obtiene datos tanto de placements de flow como de placements de paywall, por lo que tu app llama al mismo método en todos lados. Mantén los paywalls del Paywall Builder en los placements donde los quieras, y usa flows en el resto.
Durante la transición, cada tipo de placement registra sus propias métricas. Mientras convivan versiones antiguas y nuevas de la app, los datos se dividen entre dos conjuntos de placements. Los placements de onboarding y paywall antiguos cubren las versiones anteriores; el nuevo placement de flow cubre el SDK v4+. Compáralos como cohortes separadas y espera que la proporción del placement de flow crezca a medida que los usuarios actualicen.
Puedes seguir haciendo pruebas A/B con flows: ejecuta una prueba A/B normal entre variantes de flow en un placement de flow. Las pruebas A/B entre placements solo están disponibles para paywalls por ahora, así que aún no puedes ejecutar una entre placements de flow. Comparar un flow nuevo con tu paywall antiguo es una comparación de cohortes, no una prueba única, ya que viven en tipos de placement distintos.
Actualizar el SDK
Con tu placement de flow listo, apunta la app hacia él. Los flows solo se renderizan con el SDK de Adapty v4 o posterior. Actualiza el SDK y obtén el flow desde tu nuevo placement con getFlow. Consulta la guía de migración a v4 para tu plataforma — iOS, Android, React Native o Capacitor — para conocer los pasos específicos de actualización.
Una vez configurado el flow, verifícalo como cualquier otro flujo de compra: ejecútalo en un dispositivo o simulador y realiza una compra en sandbox (iOS / Android) para confirmar que los productos, la compra y el nivel de acceso funcionan correctamente.
Los usuarios solo ven los flows después de instalar la app compilada con el SDK v4+. Quienes tengan una versión anterior de la app seguirán viendo el onboarding y el paywall que ya tenían, por eso los placements antiguos permanecen activos durante la transición. Lo mismo aplica en las plataformas que aún no son compatibles con flows.
