Activer les achats avec Flow & Paywall Builder dans le SDK iOS

Pour activer les achats intégrés, vous devez comprendre trois concepts clés :

  • Produits – tout ce que les utilisateurs peuvent acheter (abonnements, consommables, accès à vie)
  • Flows & paywalls – les écrans qui présentent les produits aux utilisateurs, créés dans le Flow & Paywall Builder sans code. Le SDK les récupère via getFlow. Si vous préférez construire l’interface dans votre propre code, consultez Implémenter des paywalls personnalisés.
  • Placements – où et quand vous affichez les flows & paywalls dans votre app (par exemple main, onboarding, settings). Vous les associez à des placements dans le tableau de bord, puis vous les demandez par ID de placement dans votre code. Cela facilite l’exécution de tests A/B et l’affichage de contenus différents selon les utilisateurs.

Adapty vous propose trois façons d’activer les achats dans votre application. Choisissez celle qui correspond à vos besoins :

ImplémentationComplexitéQuand l’utiliser
Adapty Flow & Paywall Builder✅ FacileVous créez un flow ou un paywall complet et prêt à l’achat dans le builder no-code. Adapty l’affiche automatiquement et gère toute la logique d’achat complexe, la validation des reçus et la gestion des abonnements en arrière-plan.
Paywalls personnalisés🟡 MoyenVous implémentez l’interface de votre paywall dans le code de votre application, mais récupérez quand même l’objet flow depuis Adapty pour garder de la flexibilité sur les offres de produits. Consultez le guide.
Mode Observateur🔴 DifficileVous disposez déjà de votre propre infrastructure de gestion des achats et souhaitez continuer à l’utiliser. Notez que le mode observateur présente certaines limitations dans Adapty. Consultez l’article.
Important

Les étapes ci-dessous montrent comment intégrer un flow ou un paywall créé dans l’Adapty Flow & Paywall Builder.

Si vous préférez construire l’interface du paywall vous-même, consultez Implémenter des paywalls personnalisés.

Pour afficher un flow ou un paywall créé dans l’Adapty Flow & Paywall Builder dans votre application, il vous suffit de :

  1. Récupérer le flow ou le paywall : Obtenez-le depuis Adapty.
  2. Affichez-le et Adapty gère les achats pour vous : Intégrez la vue dans votre app.
  3. Gérer les actions des boutons : Associez les interactions utilisateur aux réponses de votre app. Par exemple, ouvrir des liens ou fermer le paywall lorsque l’utilisateur clique sur un bouton.

Avant de commencer

Avant de commencer, effectuez les étapes suivantes :

  1. Connectez votre application à l’App Store dans l’Adapty Dashboard.
  2. Créez vos produits dans Adapty.
  3. Créez un flow ou un paywall et ajoutez-y des produits.
  4. Créez un placement et ajoutez-y votre flow ou paywall.
  5. Installez et activez le SDK Adapty dans le code de votre application. Ce guide utilise les API du SDK Adapty iOS v4.

1. Récupérer le flow ou le paywall

Vos flows et paywalls sont associés à des placements configurés dans le tableau de bord. Les placements vous permettent d’afficher différents flows ou paywalls selon les audiences, ou de lancer des tests A/B.

Pour récupérer un flow ou un paywall créé dans l’Adapty Flow & Paywall Builder, vous devez :

  1. Récupérer l’objet flow par l’ID du placement en utilisant la méthode getFlow, puis vérifier s’il contient une configuration de vue.
  2. Récupérer la configuration de vue via la méthode getFlowConfiguration. Elle contient les éléments d’interface et le style nécessaires à l’affichage.

func loadFlow() async {
    let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")

    guard flow.hasViewConfiguration else {
        print("Flow doesn't have a view configuration")
        return
    }

    flowConfiguration = try await AdaptyUI.getFlowConfiguration(forFlow: flow)
}

2. Afficher le flow ou le paywall

Maintenant que vous disposez de la configuration du flow, il suffit d’ajouter quelques lignes pour afficher votre flow ou votre paywall.

Info

Pour plus de détails sur la façon d’afficher un flow ou un paywall, consultez notre guide.

3. Gérer les actions des boutons

Lorsque les utilisateurs cliquent sur des boutons, le SDK iOS gère automatiquement les achats, la restauration, la fermeture de l’écran et l’ouverture des liens.

Cependant, d’autres boutons ont des IDs personnalisés ou prédéfinis et nécessitent une gestion des actions dans votre code. Vous pouvez également souhaiter remplacer leur comportement par défaut.

Par exemple, voici comment gérer le bouton de fermeture. Avec UIKit, le SDK ferme automatiquement le contrôleur quand .close se déclenche — ne le surchargez que si vous souhaitez un comportement personnalisé. Avec SwiftUI, vous devez vous-même définir votre binding isPresented à false.

Tip

Consultez nos guides pour gérer les actions et les événements des boutons.

Prochaines étapes

Tip

Des questions ou des problèmes ? Consultez notre forum d’assistance où vous trouverez des réponses aux questions fréquentes ou pourrez poser les vôtres. Notre équipe et notre communauté sont là pour vous aider !

Votre flow ou paywall est prêt à être affiché dans l’app. Testez vos achats en mode sandbox pour vous assurer de pouvoir effectuer un achat test.

Ensuite, vous devez vérifier le niveau d’accès des utilisateurs pour vous assurer d’afficher un paywall ou de donner accès aux fonctionnalités payantes aux bons utilisateurs.

Exemple complet

Voici comment toutes les étapes de ce guide peuvent être intégrées dans votre application.