Esta guía describe cómo integrar Adapty en tus paywalls personalizados. Mantén el control total sobre la implementación del paywall, mientras el SDK de Adapty obtiene productos, gestiona nuevas compras y restaura las anteriores. Esta guía utiliza las APIs del SDK Kotlin Multiplatform de Adapty v4 (beta) — si estás en v3, consulta la guía de migración para los nombres de métodos correspondientes.

Antes de empezar

Configurar productos

Para habilitar las compras in-app, necesitas entender tres conceptos clave:

• Productos – todo lo que los usuarios pueden comprar (suscripciones, consumibles, acceso de por vida)
• Paywalls – configuraciones que definen qué productos ofrecer. En Adapty, los paywalls son la única forma de obtener productos, pero este diseño te permite modificar productos, precios y ofertas sin tocar el código de tu app. En SDK v4, las variaciones de paywall para un placement las lleva un objeto flow — obtienes un flow y consultas sus productos.
• Placements – dónde y cuándo mostrar los paywalls en tu app (por ejemplo, main, onboarding, settings). Configuras los paywalls para los placements en el dashboard y luego los solicitas por ID de placement en tu código. Esto facilita ejecutar pruebas A/B y mostrar diferentes paywalls a distintos usuarios.

Asegúrate de entender estos conceptos aunque uses un paywall personalizado. Básicamente, son tu forma de gestionar los productos que vendes en tu app.

Para implementar tu paywall personalizado, tendrás que crear un paywall y añadirlo a un placement. Esta configuración te permite recuperar tus productos. Para entender qué debes hacer en el dashboard, sigue la guía de inicio rápido aquí.

Gestionar usuarios

Puedes trabajar con o sin autenticación del backend en tu lado.

Sin embargo, el SDK gestiona de forma diferente a los usuarios anónimos e identificados. Lee la guía de inicio rápido de identificación para entender las particularidades y asegurarte de trabajar correctamente con los usuarios.

Paso 1. Obtener productos

Para recuperar los productos de tu paywall personalizado, necesitas:

1. Obtener el objeto flow pasando el ID del placement al método getFlow.
2. Obtener el array de productos para este flow usando el método getPaywallProducts.

fun loadPaywall() {
    Adapty.getFlow(placementId = "YOUR_PLACEMENT_ID")
        .onSuccess { flow ->
            Adapty.getPaywallProducts(flow = flow)
                .onSuccess { products ->
                    // Use products to build your custom paywall UI
                }
                .onError { error ->
                    // Handle the error
                }
        }
        .onError { error ->
            // Handle the error
        }
}

Paso 2. Aceptar compras

Cuando un usuario toca un producto en tu paywall personalizado, llama al método makePurchase con el producto seleccionado. Esto gestionará el flow de compra y devolverá el perfil actualizado.

fun purchaseProduct(product: AdaptyPaywallProduct) {
    Adapty.makePurchase(product = product)
        .onSuccess { purchaseResult ->
            when (purchaseResult) {
                is AdaptyPurchaseResult.Success -> {
                    val profile = purchaseResult.profile
                    // Purchase successful, profile updated
                }
                is AdaptyPurchaseResult.UserCanceled -> {
                    // User canceled the purchase
                }
                is AdaptyPurchaseResult.Pending -> {
                    // Purchase is pending (e.g., user will pay offline with cash)
                }
            }
        }
        .onError { error ->
            // Handle the error
        }
}

Paso 3. Restaurar compras

Los stores exigen que todas las apps con suscripciones ofrezcan una forma de restaurar las compras.

Llama al método restorePurchases cuando el usuario pulse el botón de restaurar. Esto sincronizará su historial de compras con Adapty y devolverá el perfil actualizado.

fun restorePurchases() {
    Adapty.restorePurchases()
        .onSuccess { profile ->
            // Restore successful, profile updated
        }
        .onError { error ->
            // Handle the error
        }
}

Paso 4. Comprueba el estado de la suscripción

Tras una compra o restauración, comprueba el nivel de acceso del usuario para decidir si mostrar el paywall o desbloquear las funciones de pago. Los métodos makePurchase y restorePurchases ya devuelven el perfil actualizado; cuando necesites el estado actual en otro punto de la app, usa el método getProfile:

fun checkPremiumAccess() {
    Adapty.getProfile()
        .onSuccess { profile ->
            val hasPremiumAccess = profile.accessLevels["premium"]?.isActive == true
            // Grant access to paid features if hasPremiumAccess is true
        }
        .onError { error ->
            // Handle the error
        }
}

Para más formas de verificar y monitorizar el estado de la suscripción, incluida la escucha de actualizaciones en tiempo real, consulta Verificar el estado de la suscripción.

Próximos pasos

Tu paywall está listo para mostrarse en la app. Prueba tus compras en el sandbox de App Store o en Google Play Store para asegurarte de que puedes completar una compra de prueba desde el paywall. Para ver cómo funciona esto en una implementación lista para producción, consulta el AppViewModel.kt en nuestra app de ejemplo, que muestra el manejo de compras con gestión de errores y estado adecuados.