Afficher un paywall conçu avec Remote Config dans le SDK Android

Si vous avez personnalisé un paywall à l’aide d’un Remote Config, vous devrez implémenter le rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Étant donné que le Remote Config offre une flexibilité adaptée à vos besoins, c’est vous qui décidez de ce qui est inclus et de l’apparence de votre paywall. Adapty fournit une méthode pour récupérer la configuration distante, vous donnant toute liberté pour afficher votre paywall personnalisé.

Obtenir la Remote Config d’un flow et l’afficher

En v4, un flow contient une entrée AdaptyRemoteConfig par locale configurée dans le tableau remoteConfigs. Sélectionnez la locale correspondant aux préférences de l’utilisateur, puis lisez les valeurs dont vous avez besoin.

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
    }
});

À ce stade, une fois que vous avez reçu toutes les valeurs nécessaires, il est temps d’afficher votre paywall et de l’assembler en une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des appareils mobiles, afin d’offrir une expérience fluide et agréable sur tous les appareils.

Warning

Assurez-vous d’enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin qu’Adapty Analytics puisse collecter les données nécessaires aux entonnoirs de conversion et aux tests A/B.

Une fois le paywall affiché, passez à la configuration du flow d’achat. Lorsque l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre flow. Pour plus de détails sur la méthode .makePurchase(), consultez Effectuer des achats.

Nous vous recommandons de créer un paywall de secours. Ce paywall s’affiche à l’utilisateur en l’absence de connexion internet ou de cache disponible, garantissant ainsi une expérience fluide même dans ces situations.

Suivre les événements d’affichage des paywalls

Adapty vous aide à mesurer la performance de vos flows et paywalls. Les données sur les achats sont collectées automatiquement, mais l’enregistrement des vues nécessite votre intervention, car vous seul savez quand un utilisateur voit un flow.

Pour enregistrer un événement d’affichage, appelez simplement .logShowFlow(flow) : cela sera reflété dans vos métriques dans les funnels et les tests A/B.

Important

Il n’est pas nécessaire d’appeler .logShowFlow(flow) si vous affichez des flows ou des paywalls rendus par le Flow Builder ou le Paywall Builder. Adapty suit automatiquement les vues dans ces cas.

Adapty.logShowFlow(flow)

Paramètres de la requête :

Paramètre	Présence	Description
flow	required	Un objet `AdaptyFlow` obtenu via `Adapty.getFlow`.

Si vous avez personnalisé un paywall avec un Remote Config, vous devrez implémenter son rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme le Remote Config offre une flexibilité adaptée à vos besoins, c’est vous qui décidez de ce qu’il contient et de l’apparence de votre paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous laissant toute liberté pour afficher votre paywall personnalisé configuré via Remote Config.

Obtenir le Remote Config d’un paywall et l’afficher

Pour obtenir le Remote Config d’un paywall, accédez à la propriété remoteConfig et extrayez les valeurs nécessaires.

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
    }
});

À ce stade, une fois que vous avez récupéré toutes les valeurs nécessaires, il est temps de les afficher et de les assembler dans une page visuellement attractive. Assurez-vous que le design s’adapte aux différentes tailles d’écran et orientations des smartphones, offrant une expérience fluide et conviviale sur tous les appareils.

Warning

Veillez à enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin qu’Adapty Analytics puisse collecter les données pour les entonnoirs et les tests A/B.

Une fois le paywall affiché, configurez le flux d’achat. Quand l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre paywall. Pour plus de détails sur la méthode .makePurchase(), consultez Effectuer des achats.

Nous recommandons de créer un paywall de secours. Ce paywall s’affichera à l’utilisateur en l’absence de connexion internet ou de cache disponible, garantissant ainsi une expérience fluide dans ces situations.

Suivre les événements d’affichage de paywall

Adapty vous aide à mesurer les performances de vos paywalls. Si les achats sont enregistrés automatiquement, la journalisation des affichages de paywall nécessite votre intervention, car vous seul savez quand un utilisateur voit un paywall.

Pour enregistrer un événement d’affichage de paywall, appelez simplement .logShowPaywall(paywall) : cela se reflétera dans vos métriques de paywall dans les funnels et les tests A/B.

Important

Il n’est pas nécessaire d’appeler .logShowPaywall(paywall) si vous affichez des paywalls créés dans le Paywall Builder.

Adapty.logShowPaywall(paywall)

Paramètres de la requête :

Paramètre	Présence	Description
paywall	requis	Un objet `AdaptyPaywall`.