Implémenter des web paywalls dans le SDK Kotlin Multiplatform

Avant de commencer, assurez-vous d’avoir configuré votre web paywall dans le tableau de bord et d’avoir installé la version 3.15 ou ultérieure du SDK Adapty.

Ouvrir des web paywalls

Si vous travaillez avec un paywall que vous avez développé vous-même, vous devez gérer les web paywalls via la méthode SDK. La méthode openWebPaywall :

Génère une URL unique permettant à Adapty de relier un paywall spécifique affiché à un utilisateur particulier à la page web vers laquelle il est redirigé.
Détecte quand vos utilisateurs reviennent dans l’application, puis appelle getProfile à intervalles courts pour déterminer si les droits d’accès du profil ont été mis à jour.

Ainsi, si le paiement a été effectué avec succès et que les droits d’accès ont été mis à jour, l’abonnement s’active dans l’application presque immédiatement.

Après que les utilisateurs reviennent dans l’application, actualisez l’interface pour refléter les mises à jour du profil. Adapty recevra et traitera les événements de mise à jour du profil.


viewModelScope.launch {
    Adapty.openWebPaywall(product = product).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}

Il existe deux versions de la méthode openWebPaywall :

openWebPaywall(product = product) qui génère des URL par paywall et ajoute également les données du produit aux URL.
openWebPaywall(paywall = paywall) qui génère des URL par paywall sans ajouter les données du produit aux URL. Utilisez-la lorsque vos produits dans le paywall Adapty diffèrent de ceux du web paywall.

Dans le SDK v4, le paramètre paywall est remplacé par un paramètre flowPaywall qui prend un AdaptyFlowPaywall — l’une des variantes de paywall dans flow.paywalls. Consultez le guide de migration.

Ouvrir des web paywalls dans un navigateur intégré

Par défaut, les web paywalls s’ouvrent dans le navigateur externe.

Pour offrir une expérience utilisateur fluide, vous pouvez ouvrir les web paywalls dans un navigateur intégré à l’application. Cela affiche la page d’achat web au sein de votre application, permettant aux utilisateurs de finaliser leurs transactions sans changer d’application.

Pour activer cela, définissez le paramètre openIn sur AdaptyWebPresentation.IN_APP_BROWSER :


viewModelScope.launch {
    Adapty.openWebPaywall(
        product = product,
        openIn = AdaptyWebPresentation.IN_APP_BROWSER // default – EXTERNAL_BROWSER
    ).onSuccess {
        // the web paywall was opened successfully
    }.onError { error ->
        // handle the error
    }
}