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 :

Implémentation

  1. 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 :

CallbackDescription
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.
  1. Pour afficher le flow visuel sur l’écran de l’appareil, vous devez d’abord le configurer.

Paramètres de la requête :

ParamètrePrésenceDescription
flowConfigurationrequisFournissez 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.
productsoptionnelFournissez 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.
eventListeneroptionnelFournissez 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.
insetsoptionnelLes 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.
customAssetsoptionnelPassez 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.
tagResolveroptionnelUtilisez 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.
observerModeHandlerrequis pour le mode ObserverL’AdaptyUiObserverModeHandler que vous avez implémenté à l’étape précédente.
Warning

N’oubliez pas d’associer les paywalls aux transactions d’achat. Sinon, Adapty ne pourra pas déterminer le flow source de l’achat.