+{"fileHash":"sha256:661a1b55d961e3a61f371de8e4cdff3dfbbd77dfc7171e78acb7e302678f91c0","sections":{"preamble-pe2a53776":{"contentHash":"sha256:e2a53776b8e1e5da64690262da5bcd75427e52ce63212ca1745ecdfcb3b26412","proseHash":"sha256:e2a53776b8e1e5da64690262da5bcd75427e52ce63212ca1745ecdfcb3b26412","translation":"---\ntitle: \"Migrar a flows\"\ndescription: \"Mueve tu onboarding y paywall por separado a un único flow de Adapty: qué cambia y cómo desplegarlo sin interrumpir a los usuarios en versiones antiguas de la app.\"\nmetadataTitle: \"Migrar a flows desde onboardings y paywalls | Flow Builder | Documentación de Adapty\"\n---\n\nimport CustomDocCardList from '@site/src/components/CustomDocCardList';\n\nEn 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."},"preamble-p0385ebba":{"contentHash":"sha256:0385ebbaa9170880f9a877ff8ede699b7077210a33ba7af6e610facce146ba4a","proseHash":"sha256:0385ebbaa9170880f9a877ff8ede699b7077210a33ba7af6e610facce146ba4a","translation":"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.\n\n:::important\nLos flows están disponibles actualmente en el SDK de iOS v4 o superior. La compatibilidad con otras plataformas y frameworks llegará próximamente.\n:::"},"h2-flows-vs-onboardings-and-paywalls-pacfaf562":{"contentHash":"sha256:acfaf562e9de00f81d325f81284ff2446dcb30b6601ecbbeb5a2837b1afbf9bf","proseHash":"sha256:acfaf562e9de00f81d325f81284ff2446dcb30b6601ecbbeb5a2837b1afbf9bf","translation":"## Flows vs. onboardings y paywalls \\{#flows-vs-onboardings-and-paywalls\\}\n\nCon 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.\n\nUn 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.\n\nLa tabla de abajo compara lo que ofrece cada opción:"},"h2-flows-vs-onboardings-and-paywalls-p26875d02":{"contentHash":"sha256:26875d0215960816c1245371f29c9cfe4b4713ff8e2a4f0b192a0dcc57fb2a65","proseHash":"sha256:26875d0215960816c1245371f29c9cfe4b4713ff8e2a4f0b192a0dcc57fb2a65","translation":"| | Flow | Paywall de Paywall Builder | Onboarding |\n|---|---|---|---|\n| Múltiples pantallas | Sí | No: una sola pantalla | Sí |\n| Renderizado | Nativo | Nativo | WebView |\n| 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 |"},"h2-should-you-migrate":{"contentHash":"sha256:61c877a9d60ccd7875b75a785939911a43914215ece799fa2f35455e3e6cf188","proseHash":"sha256:61c877a9d60ccd7875b75a785939911a43914215ece799fa2f35455e3e6cf188","translation":"## ¿Deberías migrar? \\{#should-you-migrate\\}\n\nTus 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.\n\n**Si estás construyendo a largo plazo, los flows son la mejor base**: migra a ellos cuando encaje en tu calendario de lanzamientos."},"h2-how-to-migrate-pb41408a5":{"contentHash":"sha256:b41408a56e2f8e9433dae2f8f0341b09d52f74093303af1388171783e266e43f","proseHash":"sha256:b41408a56e2f8e9433dae2f8f0341b09d52f74093303af1388171783e266e43f","translation":"## Cómo migrar \\{#how-to-migrate\\}\n\nLa 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."},"h2-how-to-migrate-pcd351854":{"contentHash":"sha256:cd3518540a2e9f3fecb37034d5eacd06496a14a634e83b5b464ee367a17658fe","proseHash":"sha256:cd3518540a2e9f3fecb37034d5eacd06496a14a634e83b5b464ee367a17658fe","translation":"1. **[Crea tu flow](#build-your-flow)**: Diseña un flow en el editor sin código; no necesitas un desarrollador.\n2. **[Previsualiza en el dispositivo](#preview-on-device)**: Comprueba el flow en un dispositivo real desde la app móvil de Adapty; no necesitas compilar la app.\n3. **[Crea un nuevo placement para tu flow](#create-a-new-placement-for-your-flow)**: Crea un placement de flow con su propio ID único y decide cómo convive con tus placements actuales.\n4. **[Actualiza el SDK](#update-the-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."},"h3-build-your-flow-p31a71fc8":{"contentHash":"sha256:31a71fc80af9f59710ac336b8784153632017173550383114a98612aa1e1d45f","proseHash":"sha256:31a71fc80af9f59710ac336b8784153632017173550383114a98612aa1e1d45f","translation":"### Crea tu flow \\{#build-your-flow\\}\n\nEn 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:\n\n- **[Documentación de flows](adapty-flow-builder)**: Te guía por el builder y lo que puedes crear.\n- **[Recetas de flows habituales](flow-builder-recipes)**: Guías paso a paso para las pantallas más comunes.\n- **Pregunta a la IA**: Usa el chat en cualquier página de la documentación cuando te quedes atascado."},"h3-build-your-flow-p7fefc484":{"contentHash":"sha256:7fefc484f3d864d0324546403f38c179160bf2391581a9a586029e499f52da51","proseHash":"sha256:7fefc484f3d864d0324546403f38c179160bf2391581a9a586029e499f52da51","translation":":::note\nCrear 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.\n:::"},"h3-preview-on-device-pf6734983":{"contentHash":"sha256:f6734983f7271f94755b1f15feea43f149b02793632e503b0a78efd9d0f45744","proseHash":"sha256:f6734983f7271f94755b1f15feea43f149b02793632e503b0a78efd9d0f45744","translation":"### Vista previa en el dispositivo \\{#preview-on-device\\}\n\nPuedes previsualizar el flow en un dispositivo real sin tocar la app. Descarga la [app de Adapty](https://apps.apple.com/us/app/adapty/id6739359219) 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.\n\n:::note\nEn 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](#update-the-sdk).\n:::"},"h3-preview-on-device-pf477b33c":{"contentHash":"sha256:f477b33c2db287a3dd0c427fe6c366466f936b7833cd23cddf20ae9612850280","proseHash":"sha256:f477b33c2db287a3dd0c427fe6c366466f936b7833cd23cddf20ae9612850280","translation":"<ZoomImage id=\"flow-test-on-device.webp\" width=\"700px\" alt=\"Botón de prueba en dispositivo en el flow builder\" />"},"h3-create-a-new-placement-for-your-flow-p981207d1":{"contentHash":"sha256:981207d1c494959ea5bdce82332b9c1f5a11f40e62bf5eedbd37a11949f257db","proseHash":"sha256:981207d1c494959ea5bdce82332b9c1f5a11f40e62bf5eedbd37a11949f257db","translation":"### Crea un nuevo placement para tu flow \\{#create-a-new-placement-for-your-flow\\}\n\nUn 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](create-placement)). Un flow necesita su propio placement nuevo.\n\n**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.\n\n:::warning\nMantén tus placements antiguos activos durante la transición"},"h3-create-a-new-placement-for-your-flow-pb2754245":{"contentHash":"sha256:b2754245d14f04ecf26e503750a4a9e344232edf6964b19914d53ad145dc6f78","proseHash":"sha256:b2754245d14f04ecf26e503750a4a9e344232edf6964b19914d53ad145dc6f78","translation":"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.\n:::\n\n<ZoomImage id=\"flow_placements_diagram.png\" width=\"700px\" alt=\"Lista de placements con pestañas separadas para Flows, Paywalls y Onboardings\" />"},"h3-create-a-new-placement-for-your-flow-p7c57389b":{"contentHash":"sha256:7c57389bc9eb5b9f8040cfcba354739919e9663253c3bb00291fe15429a789c7","proseHash":"sha256:7c57389bc9eb5b9f8040cfcba354739919e9663253c3bb00291fe15429a789c7","translation":"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."},"h3-create-a-new-placement-for-your-flow-p1e28feb3":{"contentHash":"sha256:1e28feb304f0e67b8245b0b8516817bca276c64d7e6e4c1732ff7653c9e5254a","proseHash":"sha256:1e28feb304f0e67b8245b0b8516817bca276c64d7e6e4c1732ff7653c9e5254a","translation":"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."},"h3-create-a-new-placement-for-your-flow-p9f9c6574":{"contentHash":"sha256:9f9c6574780db5d1d75805827ea3c107137ce1fa9f3f7b1d119de9cc444e46f6","proseHash":"sha256:9f9c6574780db5d1d75805827ea3c107137ce1fa9f3f7b1d119de9cc444e46f6","translation":"Puedes seguir haciendo pruebas A/B con flows: ejecuta una [prueba A/B normal](ab-tests) 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."},"h3-update-the-sdk-p7fc5744a":{"contentHash":"sha256:7fc5744aee47e36362ac5e59548f7fe5a0dd1f7a7380deb9dfbdd0c44224002d","proseHash":"sha256:7fc5744aee47e36362ac5e59548f7fe5a0dd1f7a7380deb9dfbdd0c44224002d","translation":"### Actualizar el SDK \\{#update-the-sdk\\}\n\nCon 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](migration-to-ios-sdk-v4) para ver los pasos concretos de actualización.\n\nUna 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](ios-test) para confirmar que los productos, la compra y el nivel de acceso funcionan correctamente."},"h3-update-the-sdk-p541dfca2":{"contentHash":"sha256:541dfca2b61f7c91108411a486b36da69679d2ec4b2277eb8aaa0c2dc74e0f22","proseHash":"sha256:541dfca2b61f7c91108411a486b36da69679d2ec4b2277eb8aaa0c2dc74e0f22","translation":":::note\nLos 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.\n:::\n\n<ZoomImage id=\"flow_sdk_diagram.png\" width=\"700px\" />"}}}
0 commit comments