Mostrar paywall diseñado con Remote Config en Kotlin Multiplatform SDK

Si has personalizado un paywall mediante Remote Config, necesitarás implementar el renderizado en el código de tu aplicación móvil para mostrárselo a los usuarios. Como Remote Config ofrece flexibilidad adaptada a tus necesidades, tienes el control sobre qué se incluye y cómo se ve tu paywall. Adapty proporciona un método para obtener la configuración remota, dándote la autonomía de mostrar tu paywall personalizado.

Obtener la configuración remota del flow y mostrarla

En la versión 4, un flow incluye una entrada AdaptyRemoteConfig por cada idioma configurado en la lista remoteConfigs. Elige el idioma que coincida con la preferencia del usuario y lee los valores que necesites.


Adapty.getFlow("YOUR_PLACEMENT_ID")
    .onSuccess { flow ->
        val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
            ?: flow.remoteConfigs.firstOrNull()
        val headerText = config?.dataMap?.get("header_text") as? String
        // use the remote config values
    }
    .onError { error ->
        // handle the error
    }

En este punto, una vez que hayas recibido todos los valores necesarios, es momento de renderizarlos y ensamblarlos en una página visualmente atractiva. Asegúrate de que el diseño se adapte a las distintas pantallas y orientaciones de los dispositivos móviles, ofreciendo una experiencia fluida y fácil de usar en todos ellos.

Asegúrate de registrar el evento de visualización del paywall tal como se describe a continuación, para que los análisis de Adapty puedan capturar la información necesaria para los funnels y las pruebas A/B.

Una vez que hayas terminado de mostrar el paywall, continúa configurando el flow de compra. Cuando el usuario realice una compra, simplemente llama a .makePurchase() con el producto de tu flow. Para más detalles sobre el método .makePurchase(), consulta Realizar compras.

Te recomendamos crear un paywall de respaldo llamado paywall de respaldo. Este paywall de respaldo se mostrará al usuario cuando no haya conexión a internet ni caché disponible, garantizando una experiencia fluida incluso en esas situaciones.

Rastrear eventos de visualización de paywall

Adapty te ayuda a medir el rendimiento de tus flows y paywalls. Aunque los datos de compras se recopilan automáticamente, registrar las visualizaciones requiere tu intervención, ya que solo tú sabes cuándo un usuario ve un flow.

Para registrar un evento de visualización, simplemente llama a .logShowFlow(flow) y se reflejará en tus métricas en los embudos y las pruebas A/B.

No es necesario llamar a .logShowFlow(flow) si estás mostrando flows o paywalls renderizados por el Flow Builder o el Paywall Builder. En esos casos, Adapty registra las vistas automáticamente.

Adapty.logShowFlow(flow)
    .onSuccess {
        // flow view logged successfully
    }
    .onError { error ->
        // handle the error
    }

Parámetros de la solicitud:

Parámetro	Presencia	Descripción
flow	requerido	Un objeto `AdaptyFlow` obtenido a través de `Adapty.getFlow`.

Si has personalizado un paywall mediante Remote Config, tendrás que implementar el renderizado en el código de tu app para mostrárselo a los usuarios. Como Remote Config ofrece flexibilidad adaptada a tus necesidades, tú decides qué incluir y cómo se muestra la vista de tu paywall. Proporcionamos un método para obtener la configuración remota, dándote la autonomía de mostrar tu paywall personalizado configurado mediante Remote Config.

Obtener el Remote Config de un paywall y mostrarlo

Para obtener el Remote Config de un paywall, accede a la propiedad remoteConfig y extrae los valores que necesites.


Adapty.getPaywall(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
    // use the remote config values
}.onError { error ->
    // handle the error
}

En este punto, una vez que hayas recibido todos los valores necesarios, es momento de renderizarlos y ensamblarlos en una página visualmente atractiva. Asegúrate de que el diseño se adapte a distintos tamaños de pantalla y orientaciones de dispositivos móviles, ofreciendo una experiencia fluida y fácil de usar en diferentes dispositivos.

Asegúrate de registrar el evento de visualización del paywall como se describe a continuación, para que Adapty Analytics pueda capturar información para los funnels y las pruebas A/B.

Cuando hayas terminado de mostrar el paywall, continúa con la configuración del flujo de compra. Cuando el usuario realice una compra, simplemente llama a .makePurchase() con el producto de tu paywall. Para más detalles sobre el método .makePurchase(), consulta Realizar compras.

Te recomendamos crear un paywall de respaldo llamado paywall de respaldo. Este paywall se mostrará al usuario cuando no haya conexión a internet ni caché disponible, garantizando una experiencia fluida incluso en esas situaciones.

Registrar eventos de visualización de paywall

Adapty te ayuda a medir el rendimiento de tus paywalls. Aunque los datos de compras se recopilan automáticamente, registrar las visualizaciones de paywalls requiere tu intervención, ya que solo tú sabes cuándo un usuario ve un paywall.

Para registrar un evento de visualización de paywall, simplemente llama a .logShowPaywall(paywall), y aparecerá reflejado en las métricas de tu paywall en los embudos y pruebas A/B.

No es necesario llamar a .logShowPaywall(paywall) si estás mostrando paywalls creados en el Paywall Builder.

Adapty.logShowPaywall(paywall = paywall)
    .onSuccess {
        // paywall view logged successfully
    }
    .onError { error ->
        // handle the error
    }

Parámetros de la solicitud:

Parámetro	Presencia	Descripción
paywall	requerido	Un objeto `AdaptyPaywall`.