Renderizar paywall diseñado con Remote Config en el SDK de Android

Si has personalizado un paywall usando Remote Config, necesitarás 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 tu paywall. Adapty proporciona un método para obtener la configuración remota, dándote autonomía para mostrar tu paywall personalizado.

Obtener la Remote Config de un flow y presentarla

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

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
                ?: flow.remoteConfigs.firstOrNull()
            val headerText = config?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();

        AdaptyRemoteConfig config = null;
        for (AdaptyRemoteConfig remoteConfig : flow.getRemoteConfigs()) {
            if ("en".equals(remoteConfig.getLocale())) {
                config = remoteConfig;
                break;
            }
        }
        if (config == null && !flow.getRemoteConfigs().isEmpty()) {
            config = flow.getRemoteConfigs().get(0);
        }

        if (config != null && config.getDataMap().get("header_text") instanceof String) {
            String headerText = (String) config.getDataMap().get("header_text");
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // 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 distintas pantallas de móvil y orientaciones, 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 los análisis de Adapty puedan capturar información para los funnels y las pruebas A/B.

Una vez que hayas mostrado el paywall, continúa configurando el flujo 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 fallback paywall. Este paywall de respaldo se mostrará al usuario cuando no haya conexión a internet o 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 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 quedará reflejado en tus métricas de embudos y 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 visualizaciones automáticamente.

Adapty.logShowFlow(flow)

Parámetros de la solicitud:

Parámetro	Presencia	Descripción
flow	obligatorio	Un objeto `AdaptyFlow` obtenido mediante `Adapty.getFlow`.

Si has personalizado un paywall usando 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ú controlas qué se incluye y cómo se ve tu paywall. Te 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 necesitas.

Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        
        AdaptyPaywall.RemoteConfig remoteConfig = paywall.getRemoteConfig();
        
        if (remoteConfig != null) {
            if (remoteConfig.getDataMap().get("header_text") instanceof String) {
                String headerText = (String) remoteConfig.getDataMap().get("header_text");
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

En este punto, una vez que hayas recibido todos los valores necesarios, es hora de renderizarlos y ensamblarlos en una página visualmente atractiva. Asegúrate de que el diseño se adapte a distintas pantallas de móviles y orientaciones, 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 los análisis de Adapty puedan capturar información para funnels y pruebas A/B.

Cuando hayas terminado de mostrar el paywall, continúa configurando el 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 fallback paywall. 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.

Registrar eventos de visualización de paywall

Adapty te ayuda a medir el rendimiento de tus paywalls. Aunque recopilamos datos sobre las compras de forma automática, registrar las visualizaciones de paywall 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, llama a .logShowPaywall(paywall) y se reflejará en las métricas de tu paywall en los embudos y las pruebas A/B.

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

Adapty.logShowPaywall(paywall)

Parámetros de la solicitud:

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