Afficher un paywall conçu via Remote Config dans le SDK Kotlin Multiplatform
Si vous avez personnalisé un paywall via Remote Config, vous devrez implémenter son rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme 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 laissant toute liberté pour présenter votre paywall personnalisé.
Récupérer le Remote Config d’un flow et l’afficher
Dans la v4, un flow contient une entrée AdaptyRemoteConfig par locale configurée dans la liste remoteConfigs. Sélectionnez la locale correspondant à la préférence 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 toutes les valeurs nécessaires récupérées, il est temps de les assembler pour créer une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, afin d’offrir une expérience fluide et agréable sur tous les appareils.
Pensez à 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 l’affichage du paywall terminé, passez à la configuration du flux d’achat. Lorsque l’utilisateur effectue un achat, appelez simplement .makePurchase() avec le produit de votre flow. Pour en savoir plus 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 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. Si nous collectons automatiquement les données sur les achats, l’enregistrement des vues nécessite votre intervention, car vous seul savez quand un utilisateur voit un flow.
Pour enregistrer un événement de vue, appelez simplement .logShowFlow(flow) : il apparaîtra dans vos métriques dans les entonnoirs et les 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 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 | requis | Un objet AdaptyFlow obtenu via Adapty.getFlow. |
Si vous avez personnalisé un paywall via Remote Config, vous devrez implémenter son rendu dans le code de votre application mobile pour l’afficher aux utilisateurs. Comme 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 laissant toute liberté pour présenter votre paywall personnalisé configuré via Remote Config.
Récupérer 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(
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 toutes les valeurs nécessaires récupérées, il est temps de les assembler pour créer une page visuellement attrayante. Veillez à ce que le design s’adapte aux différentes tailles d’écran et orientations des téléphones mobiles, afin d’offrir une expérience fluide et agréable sur tous les appareils.
Pensez à 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 l’affichage du paywall terminé, 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 recommandons de créer un paywall de secours appelé fallback paywall. 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 paywalls. Si nous collectons automatiquement les données sur les achats, l’enregistrement des vues de paywall nécessite votre intervention, car vous seul savez quand un utilisateur voit un paywall.
Pour enregistrer un événement de vue de paywall, appelez simplement .logShowPaywall(paywall) : il apparaîtra dans vos métriques de paywall dans les entonnoirs 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 = 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. |