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
flowConfigurationobligatoireFournissez 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érera 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 & 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 les images et vidéos de votre flow à l’exécution. Consultez Personnaliser les assets pour plus de détails.
tagResolveroptionnelUn AdaptyUiTagResolver qui retourne les valeurs de votre application pour les balises personnalisées du flow. Pour plus de détails, consultez Passer des données aux flows.
observerModeHandlerobligatoire 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.