Placements
Un placement es un punto de tu app donde insertas contenido de Adapty. Puedes invocar un placement al lanzar la app, antes de una función premium, en una pantalla de ajustes o en cualquier otro lugar.
Un placement tiene uno de tres tipos. Dos de ellos son para trabajo nuevo:
- Un placement de flow sirve un flow: una pantalla o secuencia de pantallas creadas en el Flow & Paywall Builder. Un flow puede ser un onboarding, un paywall o un onboarding que termina en un paywall. Si quieres construir la pantalla tú mismo, usa un paywall placement.
- Un paywall placement pasa un paywall —una configuración de productos que creas en el dashboard— a una pantalla que tú construyes por tu cuenta.
El tercer tipo, los placements de onboarding, sirve onboardings desde el legacy Onboarding Builder. Adapty deprecará ese builder el 1 de octubre de 2026, así que crea los nuevos onboardings como flows.
Reglas y errores comunes
- El tipo de un placement se fija al crearlo, porque cada tipo tiene su propio conjunto de métricas.
- Los IDs de placement son únicos en toda tu app, por lo que el mismo ID no puede servir un flow en un sitio y un paywall en otro.
- Un paywall implementado manualmente y un flow no pueden compartir una prueba A/B, porque cada uno necesita su propio tipo de placement. Para compararlos, despliega el flow de forma gradual en su propio placement y mide ambos entre sí.
- Para migrar un placement de paywall a un flow, crea un nuevo placement de flow con un nuevo ID y lanza una actualización de la app que lo llame. Consulta Migrar a flows.
- Lo único que escribes directamente en tu app es el ID del placement. Todo lo demás lo controlas desde el dashboard, sin necesidad de publicar una nueva versión: qué flow o paywall sirve, la segmentación por audiencia y las pruebas A/B.
- El ID del placement debe coincidir exactamente con el ID del dashboard. Cópialo sin espacios extra. Si el ID no coincide, la solicitud del SDK falla y el SDK usa el archivo de respaldo local si lo has configurado.
- Solo para el Paywall Builder antiguo: desactivar Show on device no elimina un paywall de su placement. El placement sigue resolviéndose hacia él sin una configuración del builder, por lo que la app no tiene nada que renderizar. Para dejar de mostrar un paywall, elimínalo de la audiencia del placement.
También puedes gestionar los placements mediante programación usando el CLI para desarrolladores.
Lista de placements
Para ver todos tus placements, ve a Placements desde el menú principal de Adapty. Los verás categorizados por tipo: Paywalls, Onboardings y Flows.
Cada pestaña ofrece una vista completa de los distintos puntos del recorrido del usuario donde pueden aparecer flows, paywalls, onboardings o pruebas A/B. Cada elemento de la lista corresponde a un placement específico, lo que facilita su gestión y modificación.
Puedes editar los detalles de un placement, asociarlo con el flow, paywall, onboarding o prueba A/B que desees para una audiencia específica, o eliminar los placements que no necesites. Los números de la tabla reflejan las métricas de cada placement desde su activación.
Desde aquí puedes:
- Crear un nuevo placement
- Editar un placement existente
- Eliminar un placement existente
- Descargar flows, paywalls u onboardings de respaldo locales. Estos archivos se utilizan cuando un usuario abre la app sin conexión al backend de Adapty (sin conexión a internet, o en el caso excepcional de que el backend esté caído) y no hay caché en el dispositivo. La misma descarga de Fallbacks cubre tanto flows como paywalls — la versión del SDK que elijas en el diálogo de descarga determina si el paquete incluye flows (SDK 4.0+) o solo paywalls.