Présenter des paywalls personnalisés dans le SDK Kotlin Multiplatform

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. Remote Config offre une flexibilité adaptée à vos besoins, vous laissant ainsi le contrôle total sur le contenu et l’apparence de votre paywall. Adapty fournit une méthode pour récupérer la configuration distante, vous donnant toute latitude pour afficher votre paywall personnalisé.

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

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


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
    }

À 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 attrayante. Assurez-vous que le design s’adapte aux différentes tailles d’écran et orientations des appareils mobiles, pour une expérience fluide et intuitive 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 informations nécessaires aux funnels 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 recommandons de créer un paywall de secours appelé fallback paywall. Ce paywall de secours s’affichera pour l’utilisateur en cas d’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 de paywall

Adapty vous aide à mesurer les performances de vos flows et paywalls. Les données d’achat sont collectées automatiquement, mais 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 se reflétera dans vos métriques dans les entonnoirs 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 les vues automatiquement dans ces cas.

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

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 à l’aide d’un Remote Config, vous devrez implémenter le 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 qui est inclus et de l’apparence de votre paywall. Nous fournissons une méthode pour récupérer la configuration distante, vous donnant ainsi toute latitude pour afficher votre paywall personnalisé configuré via Remote Config.

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

Pour récupérer le Remote Config d’un paywall, accédez à la propriété remoteConfig et extrayez les valeurs dont vous avez besoin.


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
}

À 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 en une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, pour une expérience fluide et conviviale sur tous les appareils.

Warning

Assurez-vous d’enregistrer l’événement d’affichage du paywall comme décrit ci-dessous, afin que l’analytique Adapty puisse collecter les données pour les entonnoirs et les tests A/B.

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

Nous vous recommandons de créer une paywall de secours. Cette paywall de secours 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. Les achats sont enregistrés automatiquement, mais 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 sera reflété dans vos métriques de paywall dans les entonnoirs et les tests A/B.

Important

L’appel de .logShowPaywall(paywall) n’est pas nécessaire si vous affichez des paywalls créés dans le Paywall Builder.

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

Paramètres de la requête :

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