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

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 précédents.

Important

Ce guide est destiné aux développeurs qui implémentent des paywalls personnalisés. Si vous souhaitez activer les achats de la manière la plus simple possible, utilisez le Flow & Paywall Builder d’Adapty. Avec le Flow & Paywall Builder, vous créez des flows dans un éditeur visuel sans code, Adapty gère toute la logique d’achat automatiquement, et vous pouvez tester différents designs sans republier votre application.

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 les 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 identifiant 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é. Il s’agit simplement de la façon dont vous gérez les produits que vous vendez dans votre application.

Pour implémenter 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 comprendre 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 backend de votre côté.

Cependant, le SDK Adapty 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 que vous travaillez correctement avec les utilisateurs.

Étape 1. Récupérer les produits

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

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


fun loadPaywall() {
    Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val flow = result.value
                Adapty.getPaywallProducts(flow) { productResult ->
                    when (productResult) {
                        is AdaptyResult.Success -> {
                            val products = productResult.value
                            // Use products to build your custom paywall UI
                        }
                        is AdaptyResult.Error -> {
                            val error = productResult.error
                            // Handle the error
                        }
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}



public void loadPaywall() {
    Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
            
            Adapty.getPaywallProducts(flow, productResult -> {
                if (productResult instanceof AdaptyResult.Success) {
                    List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) productResult).getValue();
                    // Use products to build your custom paywall UI
                } else if (productResult instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) productResult).getError();
                    // Handle the error
                }
            });
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // 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 flux d’achat et retourne le profil mis à jour.


fun purchaseProduct(activity: Activity, product: AdaptyPaywallProduct) {
    Adapty.makePurchase(activity, product) { result ->
        when (result) {
            is AdaptyResult.Success -> {
                when (val purchaseResult = result.value) {
                    is AdaptyPurchaseResult.Success -> {
                        val profile = purchaseResult.profile
                        // Purchase successful, profile updated
                    }
                    is AdaptyPurchaseResult.UserCanceled -> {
                        // User canceled the purchase
                    }
                    is AdaptyPurchaseResult.Pending -> {
                        // Purchase is pending (e.g., user will pay offline with cash)
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void purchaseProduct(Activity activity, AdaptyPaywallProduct product) {
    Adapty.makePurchase(activity, product, null, result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();
            
            if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
                AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();
                // Achat réussi, profil mis à jour
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // L'utilisateur a annulé l'achat
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // L'achat est en attente (ex. : l'utilisateur paiera hors ligne en espèces)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Gérer l'erreur
        }
    });
}

Étape 3. Restaurer les achats

Google Play et les autres stores exigent que toutes les applications proposant des abonnements offrent un moyen aux utilisateurs de restaurer leurs achats.

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.


fun restorePurchases() {
    Adapty.restorePurchases { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val profile = result.value
                // Restore successful, profile updated
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void restorePurchases() {
    Adapty.restorePurchases(result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
            // Restore successful, profile updated
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

Étapes suivantes

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 paywall est prêt à être affiché dans l’application. Testez vos achats dans Google Play Store pour vous assurer de pouvoir effectuer un achat test depuis le paywall. Pour voir comment cela fonctionne dans une implémentation prête pour la production, consultez ProductListFragment.kt dans notre application exemple, qui illustre la gestion des achats avec une gestion des erreurs appropriée, des retours visuels et la gestion des abonnements.

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