Implémenter les paywalls web dans le SDK Android

Important

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

Paywalls web ouverts

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

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

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

Note

Après le retour des utilisateurs 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.

Adapty.openWebPaywall(
    activity = activity,
    product = product,
) { error ->
    if (error == null) {
        // the web paywall was opened successfully
    } else {
        // handle the error
    }
}

Note

Il existe deux versions de la méthode openWebPaywall :

openWebPaywall(product) qui génère des URLs à partir du paywall et y ajoute également les données du produit.
openWebPaywall(paywall) qui génère des URLs à partir du paywall sans ajouter les données du produit. Dans le SDK v4, cela prend un AdaptyFlowPaywall — une variante paywall du flow récupéré. Vérifiez que flow.paywalls n’est pas vide avant d’y accéder par index, par exemple flow.paywalls[0].

Ouvrir les paywalls web dans un navigateur intégré

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

Pour offrir une expérience utilisateur fluide, vous pouvez ouvrir les paywalls web dans un navigateur intégré. La page d’achat web s’affiche alors directement dans votre application, permettant aux utilisateurs de finaliser leurs transactions sans changer d’application.

Pour activer cette option, définissez le paramètre presentation sur AdaptyWebPresentation.InAppBrowser :

Adapty.openWebPaywall(
    activity = activity,
    product = product,
    presentation = AdaptyWebPresentation.InAppBrowser,
) { error ->
    if (error == null) {
        // the web paywall was opened successfully
    } else {
        // handle the error
        val adaptyError = error
    }
}