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

Si vous avez personnalisé un paywall avec Remote Config, vous devrez implémenter le rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme Remote Config offre une flexibilité adaptée à vos besoins, vous contrôlez ce qui est inclus et l’apparence de votre paywall. Adapty fournit une méthode pour récupérer la configuration distante, vous donnant toute latitude pour présenter votre paywall personnalisé.

Récupérer la Remote Config d’un flow et l’afficher

Dans la v4, un flow contient une entrée AdaptyRemoteConfig par locale configurée dans le tableau remoteConfigs. Sélectionnez la locale qui correspond à la préférence 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 toutes les valeurs nécessaires récupérées, il est temps de les assembler en une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des mobiles, pour une expérience fluide et agréable sur tous les appareils.

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 funnels et les tests A/B.

Une fois l’affichage du paywall terminé, configurez le 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 de secours s’affichera pour l’utilisateur en l’absence de connexion internet ou de cache disponible, garantissant une expérience fluide même dans ces situations.

Suivre les événements d’affichage du paywall

Adapty vous aide à mesurer les performances de vos flows et paywalls. Bien que nous collectons automatiquement les données sur les achats, l’enregistrement des affichages 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 de funnels et de tests A/B.

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 les affichages automatiquement dans ces cas.

Adapty.logShowFlow(flow)

Paramètres de la requête :

Paramètre	Obligatoire	Description
flow	obligatoire	Un objet `AdaptyFlow` obtenu via `Adapty.getFlow`.

Si vous avez personnalisé un paywall avec Remote Config, vous devrez implémenter le rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme Remote Config offre une flexibilité adaptée à vos besoins, vous contrôlez ce qui est inclus et l’apparence de votre paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous donnant toute latitude pour présenter votre paywall personnalisé configuré via Remote Config.

Récupérer la Remote Config d’un paywall et l’afficher

Pour obtenir la 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
    }
});

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 funnels et les tests A/B.

Une fois l’affichage du paywall terminé, configurez le flow d’achat. Lorsque 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.

Suivre les événements d’affichage du paywall

Adapty vous aide à mesurer les performances de vos paywalls. Bien que nous collectons automatiquement les données sur les achats, l’enregistrement des affichages 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 sera reflété dans vos métriques de paywall dans les funnels et les tests A/B.

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	Obligatoire	Description
paywall	obligatoire	Un objet `AdaptyPaywall`.