Afficher les flows & paywalls - iOS

Si vous avez créé un flow ou un paywall, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel flow ou paywall contient à la fois ce qui doit être affiché et comment cela doit l’être.

Pour obtenir l’objet AdaptyUI.FlowConfiguration utilisé ci-dessous, consultez Récupérer les flows et paywalls.

Présenter les flows et paywalls avec SwiftUI

Présenter comme une vue modale

Pour afficher un flow ou un paywall sur l’écran de l’appareil comme une vue modale, utilisez le modificateur .flow dans SwiftUI. L’appel minimal requiert isPresented, flowConfiguration et les cinq callbacks obligatoires :

.flow(
    isPresented: $flowPresented,
    flowConfiguration: <AdaptyUI.FlowConfiguration>,
    didFinishPurchase: { _, _ in /* dismiss, or do nothing to let the flow continue */ },
    didFailPurchase: { _, _ in /* handle the error */ },
    didFinishRestore: { _ in /* check access level and dismiss */ },
    didFailRestore: { _ in /* handle the error */ },
    didReceiveError: { _ in flowPresented = false }
)

Pour plus de contrôle, ajoutez des callbacks optionnels comme didPerformAction pour gérer les appuis sur les boutons :

@State var flowPresented = false // ensure that you manage this variable state and set it to `true` at the moment you want to show the flow or paywall

var body: some View {
  Text("Hello, AdaptyUI!")
      .flow(
          isPresented: $flowPresented,
          flowConfiguration: <AdaptyUI.FlowConfiguration>,
          didPerformAction: { action in
              switch action {
                  case .close:
                      flowPresented = false
                  default:
                      // Handle other actions
                      break
              }
          },
          didFinishPurchase: { product, purchaseResult in /* dismiss, or do nothing to let the flow continue */ },
          didFailPurchase: { product, error in /* handle the error */ },
          didFinishRestore: { profile in /* check access level and dismiss */ },
          didFailRestore: { error in /* handle the error */ },
          didReceiveError: { error in flowPresented = false }
      )
}

Paramètres :

Consultez la rubrique iOS - Gestion des événements pour plus de détails sur les paramètres.

Présenter comme une vue non modale

Vous pouvez également présenter les flows et paywalls comme destinations de navigation ou vues intégrées dans le flux de navigation de votre application. Utilisez AdaptyFlowView directement dans vos vues SwiftUI :

AdaptyFlowView(
    flowConfiguration: <AdaptyUI.FlowConfiguration>,
    didFinishPurchase: { product, purchaseResult in
        // Dismiss the view, or do nothing to let the flow continue
    },
    didFailPurchase: { product, error in
        // Handle purchase failure
    },
    didFinishRestore: { profile in
        // Handle successful restore
    },
    didFailRestore: { error in
        // Handle restore failure
    },
    didReceiveError: { error in
        // Handle the error (rendering or JS exception from the flow script).
    }
)

Présenter les flows et paywalls avec UIKit

Pour afficher le flow ou le paywall sur l’écran de l’appareil, procédez comme suit :

1. Initialisez le flow visuel que vous souhaitez afficher en utilisant la méthode AdaptyUI.flowController(with:delegate:) :

   import AdaptyUI
   
   let visualFlow = try AdaptyUI.flowController(
       with: <AdaptyUI.FlowConfiguration>,
       delegate: <AdaptyFlowControllerDelegate>
   )

   Paramètres de la requête :

   Paramètre	Présence	Description
   flowConfiguration	requis	Un objet AdaptyUI.FlowConfiguration contenant les détails visuels du flow ou du paywall. Utilisez la méthode AdaptyUI.getFlowConfiguration(forFlow:). Consultez la rubrique Récupérer les flows et paywalls pour plus de détails.
   delegate	requis	Un AdaptyFlowControllerDelegate pour écouter les événements du flow et du paywall. Consultez la rubrique Gérer les événements de flow & paywall pour plus de détails.

   Valeur retournée :

   Objet	Description
   AdaptyFlowController	Un objet représentant l’écran du flow ou du paywall demandé.

2. Une fois l’objet créé avec succès, vous pouvez l’afficher sur l’écran de l’appareil :

   present(visualFlow, animated: true)

Si vous avez personnalisé un paywall avec le Paywall Builder, vous n’avez pas à vous soucier de son rendu dans le code de votre application mobile pour l’afficher à l’utilisateur. Un tel paywall contient à la fois ce qui doit être affiché et comment cela doit l’être.

Pour obtenir l’objet AdaptyUI.PaywallConfiguration utilisé ci-dessous, consultez Récupérer les paywalls Paywall Builder et leur configuration.

Présenter les paywalls avec SwiftUI

Présenter comme une vue modale

Pour afficher le paywall visuel sur l’écran de l’appareil comme une vue modale, utilisez le modificateur .paywall dans SwiftUI :

@State var paywallPresented = false // ensure that you manage this variable state and set it to `true` at the moment you want to show the paywall

var body: some View {
  Text("Hello, AdaptyUI!")
      .paywall(
          isPresented: $paywallPresented,
          paywallConfiguration: <AdaptyUI.PaywallConfiguration>,
          didPerformAction: { action in
              switch action {
                  case .close:
                      paywallPresented = false
                  default:
                      // Handle other actions
                      break
              }
          },
          didFinishPurchase: { product, profile in paywallPresented = false },
          didFailPurchase: { product, error in /* handle the error */ },
          didFinishRestore: { profile in /* check access level and dismiss */  },
          didFailRestore: { error in /* handle the error */ },
          didFailRendering: { error in paywallPresented = false }
      )
}

Paramètres :

Consultez la rubrique iOS - Gestion des événements pour plus de détails sur les paramètres.

Présenter comme une vue non modale

Vous pouvez également présenter les paywalls comme destinations de navigation ou vues intégrées dans le flux de navigation de votre application. Utilisez AdaptyPaywallView directement dans vos vues SwiftUI :

AdaptyPaywallView(
    paywallConfiguration: <AdaptyUI.PaywallConfiguration>,
    didFailPurchase: { product, error in
        // Handle purchase failure
    },
    didFinishRestore: { profile in
        // Handle successful restore
    },
    didFailRestore: { error in
        // Handle restore failure
    },
    didFailRendering: { error in
        // Handle rendering error
    }
)

Présenter les paywalls avec UIKit

Pour afficher le paywall visuel sur l’écran de l’appareil, procédez comme suit :

1. Initialisez le paywall visuel que vous souhaitez afficher en utilisant la méthode .paywallController(for:products:viewConfiguration:delegate:) :

   import AdaptyUI
   
   let visualPaywall = AdaptyUI.paywallController(
       with: <paywall configuration object>,
       delegate: <AdaptyPaywallControllerDelegate>
   )

   Paramètres de la requête :

   Paramètre	Présence	Description
   paywall configuration	requis	Un objet AdaptyUI.PaywallConfiguration contenant les détails visuels du paywall. Utilisez la méthode AdaptyUI.getPaywallConfiguration(forPaywall:locale:). Consultez la rubrique Récupérer les paywalls Paywall Builder et leur configuration pour plus de détails.
   delegate	requis	Un AdaptyPaywallControllerDelegate pour écouter les événements du paywall. Consultez la rubrique Gestion des événements de paywall pour plus de détails.

   Valeur retournée :

   Objet	Description
   AdaptyPaywallController	Un objet représentant l’écran du paywall demandé.

2. Une fois l’objet créé avec succès, vous pouvez l’afficher sur l’écran de l’appareil :

   present(visualPaywall, animated: true)