Présenter des flows en mode Observer dans le SDK Android
Si vous utilisez le mode Observer, vous êtes responsable de votre propre logique d’achat. Mais vous pouvez déléguer l’interface du paywall au Flow & Paywall Builder.
Concevez l’écran dans le builder, et le SDK Adapty l’affiche nativement. Mettez à jour les textes, la mise en page et les prix quand vous le souhaitez, sans publier de nouvelle version de l’application. Quand un utilisateur appuie sur un bouton d’achat, le SDK appelle votre code pour finaliser l’achat.
Ce guide explique comment afficher cet écran et gérer l’appel d’achat. Si Adapty gère les achats à votre place, consultez Afficher les flows & paywalls.
Avant de commencer
Vous avez besoin de :
- SDK Android Adapty v4 ou version ultérieure : les versions antérieures ne peuvent pas afficher les flows. Pour migrer une application existante depuis la v3, consultez le guide de migration.
observerModedéfini surtrue: consultez le guide d’installation du SDK Android.- Intégration initiale avec le store : configurez Adapty avec Google Play.
- Un flow publié avec des produits : créez-le dans le Flow & Paywall Builder et associez-y des produits.
- Un placement pour le flow : créez un placement et assignez-y votre flow.
- Le flow récupéré dans votre application : récupérez le flow et sa configuration avant de l’afficher.
Implémentation
- Implémentez l’
AdaptyUiObserverModeHandler.
L’événement onPurchaseInitiated vous informe que l’utilisateur a initié un achat. Vous pouvez déclencher votre flow d’achat personnalisé en réponse à ce callback :
Pour gérer les restaurations en mode Observer, surchargez getRestoreHandler(). Par défaut, cette méthode retourne null, ce qui utilise le flow intégré d’Adapty via Adapty.restorePurchases(). Pour fournir votre propre implémentation de restauration :
Se souvenir d’invoquer les callbacks suivants pour notifier AdaptyUI du processus d’achat ou de restauration. Cela est nécessaire pour un comportement correct du flow, par exemple pour afficher le loader :
| Callback | Description |
|---|---|
| onStartPurchase() | Ce callback doit être invoqué pour notifier AdaptyUI que l’achat a démarré. |
| onFinishPurchase() | Ce callback doit être invoqué pour notifier AdaptyUI que l’achat est terminé. |
| onStartRestore() | Optionnel. Ce callback peut être invoqué pour notifier AdaptyUI que la restauration a démarré. |
| onFinishRestore() | Optionnel. Ce callback peut être invoqué pour notifier AdaptyUI que la restauration est terminée. |
- Pour afficher le flow visuel sur l’écran de l’appareil, vous devez d’abord le configurer.
Paramètres de la requête :
| Paramètre | Présence | Description |
|---|---|---|
| flowConfiguration | requis | Fournissez un objet AdaptyUI.FlowConfiguration contenant les détails visuels du flow. Utilisez la méthode AdaptyUI.getFlowConfiguration(flow) pour le charger. Consultez la rubrique Récupérer la configuration de la vue pour plus de détails. |
| products | optionnel | Fournissez un tableau d’AdaptyPaywallProduct pour optimiser le moment d’affichage des produits à l’écran. Si null est passé, AdaptyUI récupère automatiquement les produits requis. |
| eventListener | optionnel | Fournissez un AdaptyFlowEventListener pour observer les événements du flow. Il est recommandé d’étendre AdaptyFlowDefaultEventListener pour plus de simplicité. Consultez la rubrique Gérer les événements de flow et de paywall pour plus de détails. |
| insets | optionnel | Les insets sont les espaces autour du flow qui empêchent les éléments interactifs d’être masqués derrière les barres système. Par défaut : Unspecified, ce qui laisse Adapty ajuster les insets automatiquement. Voir Modifier les insets du flow. |
| customAssets | optionnel | Passez un objet AdaptyCustomAssets pour remplacer des images et des vidéos dans votre flow à l’exécution. Consultez Personnaliser les assets pour plus de détails. |
| tagResolver | optionnel | Utilisez AdaptyUiTagResolver pour résoudre les balises personnalisées dans le texte du flow. Ce resolver prend un paramètre de balise et le résout en chaîne de caractères correspondante. |
| observerModeHandler | requis pour le mode Observer | L’AdaptyUiObserverModeHandler que vous avez implémenté à l’étape précédente. |
N’oubliez pas d’associer les paywalls aux transactions d’achat. Sinon, Adapty ne pourra pas déterminer le flow source de l’achat.