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 pasar a flows y cómo implementar el cambio sin afectar a los usuarios de versiones anteriores de la app.
Los flows están disponibles actualmente en el SDK de iOS v4 o superior. La compatibilidad con otras plataformas y frameworks llegará próximamente.
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: Diseña un flow en el editor sin código; no necesitas un desarrollador.
- Previsualiza en el dispositivo: Comprueba el flow en un dispositivo real desde la app móvil de Adapty; no necesitas compilar la app.
- Crea un nuevo placement para tu flow: Crea un placement de flow con su propio ID único y decide cómo convive con tus placements actuales.
- Actualiza el SDK: Actualiza al SDK de iOS 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 tienes que migrar todos los placements a flows de una vez. En iOS SDK v4, el método getFlow obtiene datos tanto de placements de flow como de placements de paywall, así que tu app llama al mismo método en todos los casos. 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 en adelante. Actualiza el SDK y obtén el flow desde tu nuevo placement con getFlow(placementId:). Consulta la guía de migración al SDK de iOS v4 para ver los pasos concretos de actualización.
Una vez que el flow esté integrado, verifícalo como cualquier otro flujo 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.
Los usuarios ven los flows solo después de instalar la versión de la app compilada con SDK v4+. Quienes tengan una versión anterior seguirán viendo tu onboarding y paywall actuales, por eso los placements antiguos permanecen activos durante la transición. Lo mismo aplica en plataformas que aún no admiten flows.
