Implementar web paywalls en el SDK de Kotlin Multiplatform

Antes de comenzar, asegúrate de haber configurado tu web paywall en el dashboard e instalado la versión 3.15 o posterior del SDK de Adapty.

Paywalls web abiertos

Si estás trabajando con un paywall que desarrollaste tú mismo, debes gestionar los paywalls web usando el método del SDK. El método openWebPaywall:

Genera una URL única que permite a Adapty vincular un paywall específico mostrado a un usuario concreto con la página web a la que es redirigido.
Detecta cuando tus usuarios regresan a la app y luego solicita getProfile a intervalos cortos para determinar si los derechos de acceso del perfil han sido actualizados.

De esta forma, si el pago se ha realizado con éxito y los derechos de acceso han sido actualizados, la suscripción se activa en la app casi de inmediato.

Cuando los usuarios vuelvan a la app, actualiza la interfaz para reflejar los cambios del perfil. Adapty recibirá y procesará los eventos de actualización del perfil.


viewModelScope.launch {
    Adapty.openWebPaywall(product = product).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}

Hay dos versiones del método openWebPaywall:

openWebPaywall(product = product) que genera URLs por paywall y también añade los datos del producto a las URLs.
openWebPaywall(paywall = paywall) que genera URLs por paywall sin añadir los datos del producto a las URLs. Úsalo cuando los productos de tu paywall en Adapty difieran de los del paywall web.

En SDK v4, el parámetro paywall se reemplaza por un parámetro flowPaywall que recibe un AdaptyFlowPaywall — una de las variantes del paywall en flow.paywalls. Consulta la guía de migración.

Abrir paywalls web en un navegador in-app

Por defecto, los paywalls web se abren en el navegador externo.

Para ofrecer una experiencia de usuario fluida, puedes abrirlos en un navegador in-app. Esto muestra la página de compra web dentro de tu aplicación, permitiendo a los usuarios completar las transacciones sin cambiar de app.

Para activarlo, establece el parámetro openIn en AdaptyWebPresentation.IN_APP_BROWSER:


viewModelScope.launch {
    Adapty.openWebPaywall(
        product = product,
        openIn = AdaptyWebPresentation.IN_APP_BROWSER // default – EXTERNAL_BROWSER
    ).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}