Migrar a flows
En Adapty, un flow combina un onboarding y un paywall en una única entidad bajo un solo placement. Un flow reemplaza el onboarding y el paywall por separado que construyes y sirves de forma independiente.
A partir del 1 de octubre de 2026, no podrás crear ni editar paywalls y onboardings en los builders antiguos, y su soporte finaliza. Todo lo que ya tienes seguirá funcionando — consulta qué cambia en esa fecha.
Esta guía explica qué cambia al pasarte a flows y cómo hacer el cambio sin interrumpir a los usuarios en versiones antiguas de la app.
Los flows requieren el SDK de Adapty v4.0 o posterior.
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?
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: Convierte un paywall existente con un clic, o crea un flow desde una plantilla; sin necesidad de desarrollador.
- Previsualiza en dispositivo: Comprueba el flow en un dispositivo real a través de la app móvil de Adapty; sin necesidad de 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 convive con tus placements existentes.
- Actualiza el SDK: Actualiza al SDK de Adapty v4, obtén el flow desde su placement y verifica una compra en sandbox. Esta es la tarea principal del desarrollador.
Crea tu flow
Si tu paywall fue creado con el antiguo Paywall Builder, puedes convertirlo en un flow en lugar de reconstruirlo manualmente. También puedes usar una plantilla de inicio o crear el flow desde cero. Más información sobre el flow y el paywall builder:
- Documentación del Flow Builder: Te guía por el builder y todo lo que puedes crear.
- Recetas de flow más comunes: Guías paso a paso para las pantallas más habituales.
- Pregunta a la IA: Usa el chat en cualquier página de la documentación cuando te quedes atascado.
Vista previa en el dispositivo
Puedes previsualizar el flow en un dispositivo real sin tocar la app. Descarga la app móvil de Adapty para iOS o Android. 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, la ramificación, los textos y el diseño.
En el modo de vista previa, Adapty no puede acceder a tus productos en los stores, por lo que los precios mostrados 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.
Actualiza el SDK
Con el placement de tu 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, Flutter, Unity, Kotlin Multiplatform o Capacitor — para conocer los pasos específicos de actualización.
Una vez que el flow esté conectado, verifícalo como cualquier otro flow de compra: ejecútalo en un dispositivo o simulador y realiza una compra en sandbox para confirmar que los productos, la compra y el nivel de acceso funcionan correctamente. Consulta la guía de pruebas de tu plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform o Capacitor.
Los usuarios solo ven los flows después de instalar la app compilada con SDK v4+. Quienes tengan una versión anterior de la app seguirán viendo el onboarding y el paywall existentes, por eso los placements antiguos permanecen activos durante la transición.
