Activer les achats dans votre paywall personnalisé avec le SDK iOS

Ce guide explique comment intégrer Adapty dans vos paywalls personnalisés. Gardez le contrôle total sur l’implémentation du paywall, tandis que le SDK Adapty récupère les produits, gère les nouveaux achats et restaure les achats précédents.

Avant de commencer

Configurer les produits

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)
• Paywalls – configurations qui définissent quels produits proposer. Dans Adapty, les paywalls sont le seul moyen de récupérer des produits, mais cette conception vous permet de modifier les produits, les prix et les offres sans toucher au code de votre application.
• Placements – où et quand vous affichez vos paywalls dans votre application (comme main, onboarding, settings). Vous configurez les paywalls pour les 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 paywalls différents selon les utilisateurs.

Assurez-vous de bien comprendre ces concepts, même si vous utilisez votre propre paywall personnalisé. En résumé, il s’agit simplement de la façon dont vous gérez les produits que vous vendez dans votre application.

Pour mettre en œuvre votre paywall personnalisé, vous devrez créer un paywall et l’ajouter à un placement. Cette configuration vous permet de récupérer vos produits. Pour savoir ce que vous devez faire dans le tableau de bord, suivez le guide de démarrage rapide ici.

Gérer les utilisateurs

Vous pouvez travailler avec ou sans authentification côté backend.

Cependant, le SDK gère différemment les utilisateurs anonymes et identifiés. Lisez le guide de démarrage rapide sur l’identification pour comprendre les spécificités et vous assurer de gérer correctement vos utilisateurs.

Étape 1. Récupérer les produits

Pour récupérer les produits de votre paywall personnalisé, vous devez :

1. Obtenir l’objet flow en passant l’ID du placement à la méthode getFlow.
2. Obtenir le tableau de produits pour ce flow à l’aide de la méthode getPaywallProducts.

func loadPaywall() async {
    do {
        let flow = try await Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID")
        let products = try await Adapty.getPaywallProducts(flow: flow)

        // Use products to build your custom paywall UI
    } catch {
        // Handle the error
    }
}

func loadPaywall() {
    Adapty.getFlow(placementId: "YOUR_PLACEMENT_ID") { result in
        switch result {
        case let .success(flow):
            Adapty.getPaywallProducts(flow: flow) { result in
                switch result {
                case let .success(products):
                    // Use products to build your custom paywall UI
                case let .failure(error):
                    // Handle the error
                }
            }
        case let .failure(error):
            // Handle the error
        }
    }
}

Étape 2. Accepter les achats

Quand un utilisateur appuie sur un produit dans votre paywall personnalisé, appelez la méthode makePurchase avec le produit sélectionné. Cela gère le processus d’achat et retourne le profil mis à jour.

func purchaseProduct(_ product: AdaptyPaywallProduct) async {
    do {
        let purchaseResult = try await Adapty.makePurchase(product: product)
        
        switch purchaseResult {
        case .userCancelled:
            // L'utilisateur a annulé l'achat
            break
        case .pending:
            // Achat en attente (ex. : en attente d'approbation parentale)
            break
        case let .success(profile, transaction):
            // Achat réussi, profil mis à jour
            break
        }
    } catch {
        // Gérer l'erreur
    }
}

func purchaseProduct(_ product: AdaptyPaywallProduct) {
    Adapty.makePurchase(product: product) { result in
        switch result {
        case let .success(purchaseResult):
            switch purchaseResult {
            case .userCancelled:
                // L'utilisateur a annulé l'achat
                break
            case .pending:
                // Achat en attente (ex. : en attente de l'approbation parentale)
                break
            case let .success(profile, transaction):
                // Achat réussi, profil mis à jour
                break
            }
        case let .failure(error):
            // Gérer l'erreur
        }
    }
}

Étape 3. Restaurer les achats

Apple exige que toutes les applications avec des abonnements offrent un moyen aux utilisateurs de restaurer leurs achats. Bien que les achats soient automatiquement restaurés lorsqu’un utilisateur se connecte avec son identifiant Apple, vous devez tout de même implémenter un bouton de restauration dans votre application.

Appelez la méthode restorePurchases lorsque l’utilisateur appuie sur le bouton de restauration. Cela synchronisera son historique d’achats avec Adapty et renverra le profil mis à jour.

func restorePurchases() async {
    do {
        let profile = try await Adapty.restorePurchases()
        // Restore successful, profile updated
    } catch {
        // Handle the error
    }
}

func restorePurchases() {
    Adapty.restorePurchases { result in
        switch result {
        case let .success(profile):
            // Restore successful, profile updated
        case let .failure(error):
            // Handle the error
        }
    }
}

Prochaines étapes

Votre paywall est prêt à être affiché dans l’application. Testez vos achats en mode sandbox pour vérifier que vous pouvez effectuer un achat test depuis le paywall.

Ensuite, vérifiez si les utilisateurs ont finalisé leur achat pour décider d’afficher le paywall ou d’accorder l’accès aux fonctionnalités payantes.