Migrar a flows
En Adapty, un flow combina un onboarding y un paywall en una sola entidad bajo un único placement. Un flow reemplaza el onboarding y el paywall separados que construyes y sirves de forma independiente.
A partir del 1 de octubre de 2026, no podrás crear nuevos paywalls ni onboardings en los builders heredados, y dejará de ofrecerse soporte para ellos. Todo lo que ya tienes seguirá funcionando y podrá editarse — consulta qué cambia en esa fecha.
Esta guía explica qué cambia al migrar a flows y cómo aplicar el cambio sin afectar a los usuarios con versiones antiguas de la app.
Los flows requieren el SDK de Adapty v4.0 o posterior.
Flows frente a onboardings y paywalls
Con onboardings y paywalls por separado, gestionas dos builders y dos placements. Además, tienes que pasar al usuario del onboarding al paywall desde tu propio código.
Un flow reemplaza ambos con una sola experiencia — pantallas de introducción, un cuestionario y la pantalla de compra — creada en un único editor y servida desde un único placement. Ese placement es nuevo: un flow es su propio tipo de contenido, por lo que no puede ejecutarse en el placement de onboarding o paywall que reemplaza.
La tabla siguiente 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 en el Paywall Builder heredado, conviértelo en lugar de reconstruirlo. La acción Move to new builder lo recrea como un flow en borrador con un solo clic — diseño, textos en todos los idiomas y productos con precios como variables — y el original permanece activo mientras editas y pruebas. Consulta Convierte un paywall en un flow.
Para crear algo nuevo, elige la opción que mejor se adapte:
- Empieza desde una plantilla: Una plantilla inicial o un flow en blanco en el Flow & Paywall Builder, sin código.
- Usa la habilidad del agente: Tu herramienta de programación con IA crea y edita flows desde el terminal — ideal para cuestionarios, ramificaciones y añadir locales en bloque.
Referencia mientras construyes:
- Documentación de Flow & Paywall Builder: Te guía a través del builder y 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 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 & Paywall 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 el build v4 con una cuenta sandbox; consulta Actualizar el SDK.
Crea un nuevo placement para tu flow
Los flows, paywalls y onboardings son tres tipos de contenido diferentes, y cada uno se mide con su propio conjunto de métricas — por eso un placement sirve solo para un tipo. El tipo de un placement queda fijado en el momento de crearlo, así que no hay forma de convertir un placement de onboarding o paywall en un placement de flow (consulta los tipos de placement). Cada flow que publiques necesita su propio placement nuevo.
Asigna al nuevo placement de flow un ID de placement completamente nuevo y único.
Los IDs de placement son únicos en toda la aplicación y no por tipo, por lo que un placement de flow no puede reutilizar el ID de un placement de paywall o de onboarding, ni siquiera el del que sustituye su contenido. Reutilizar el ID no es una cuestión de preferencia: el Dashboard lo rechaza.
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 el onboarding y paywall existente hasta que actualicen. Retira los placements antiguos solo cuando la adopción de SDK v4 sea suficientemente alta.
No tienes que mover todas las ubicaciones a flows de una vez. En SDK v4, el método getFlow obtiene datos tanto de placements de flows como de placements de paywalls, por lo que tu app llama al mismo método en todas partes. 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 realizando pruebas A/B con flows: ejecuta una prueba A/B regular entre variantes de flow en un placement de flow. Las pruebas A/B entre placements actualmente solo están disponibles para paywalls, por lo que aún no puedes ejecutar una entre placements de flow. Comparar un flow nuevo con tu paywall anterior es una comparación de cohortes, no una sola prueba — se encuentran en tipos de placement diferentes.
Crea los placements con una habilidad de agente
С более чем несколькими placements для переноса, навык migrate-placements создаёт их прямо из вашего AI-инструмента для написания кода. Он считывает все placements в вашем приложении через Adapty CLI, группирует их по paywall, который каждый из них обслуживает, спрашивает для каждого paywall, откуда берётся flow, затем создаёт один flow placement для каждого paywall placement в области видимости и возвращает сопоставление старых и новых ID, а также вызов getFlow, который необходимо добавить в приложение.
Wait, I need to translate to Spanish (es-ES), not Russian. Let me redo this.
Si tienes más de unos pocos placements que migrar, el skill migrate-placements los crea directamente desde tu herramienta de codificación con IA. Lee todos los placements de tu aplicación a través del Adapty CLI, los agrupa por el paywall al que sirve cada uno, pregunta por cada paywall de dónde viene el flow, luego crea un flow placement por cada paywall placement en el alcance y devuelve el mapeo de IDs antiguos a nuevos y la llamada getFlow que tu app debe implementar.
Tu paywall placements se leen pero nunca se editan, así que siguen sirviendo mientras trabajas, y cada ID de placement que propone el skill espera tu aprobación.
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.
