Effectuer des achats dans une application mobile avec le SDK Unity

Afficher des paywalls dans votre application mobile est une étape essentielle pour offrir aux utilisateurs l’accès à des contenus ou services premium. Cependant, afficher ces paywalls suffit à gérer les achats uniquement si vous utilisez le Paywall Builder pour personnaliser vos paywalls.

Si vous n’utilisez pas le Paywall Builder, vous devez utiliser une méthode distincte appelée .makePurchase() pour finaliser un achat et débloquer le contenu souhaité. Cette méthode constitue le point d’entrée permettant aux utilisateurs d’interagir avec les paywalls et d’effectuer leurs transactions.

Si votre paywall comporte une offre promotionnelle active pour le produit qu’un utilisateur souhaite acheter, Adapty l’appliquera automatiquement au moment de l’achat.

Assurez-vous d’avoir effectué la configuration initiale sans passer aucune étape. Sans elle, nous ne pouvons pas valider les achats.

Effectuer un achat

using AdaptySDK;

void MakePurchase(AdaptyPaywallProduct product) {
  Adapty.MakePurchase(product, (result, error) => {
    switch (result.Type) {
      case AdaptyPurchaseResultType.Pending:
        // handle pending purchase
        break;
      case AdaptyPurchaseResultType.UserCancelled:
        // handle purchase cancellation
        break;
      case AdaptyPurchaseResultType.Success:
        var profile = result.Profile;
        // handle successfull purchase
        break;
      default:
        break;
    }
  });
}

Paramètres de la requête :

Paramètres de réponse :

Modifier l’abonnement lors d’un achat

Lorsqu’un utilisateur choisit un nouvel abonnement plutôt que de renouveler l’abonnement en cours, le comportement dépend du store :

• Pour l’App Store, l’abonnement est automatiquement mis à jour au sein du groupe d’abonnements. Si un utilisateur souscrit à un abonnement d’un groupe alors qu’il possède déjà un abonnement d’un autre groupe, les deux abonnements seront actifs simultanément.
• Pour Google Play, l’abonnement n’est pas automatiquement mis à jour. Vous devrez gérer le changement dans le code de votre application mobile, comme décrit ci-dessous.

Pour remplacer un abonnement par un autre sur Android, appelez la méthode .makePurchase() avec le paramètre supplémentaire suivant :

// Create subscription update parameters
var subscriptionUpdateParams = new AdaptySubscriptionUpdateParameters(
    "old_product_id", // Product ID of the current subscription
    AdaptySubscriptionUpdateReplacementMode.WithTimeProration
);

Adapty.MakePurchase(product, subscriptionUpdateParams, (profile, error) => {
  if(error != null) {
      // Handle the error
      return;
  }

  // successful cross-grade
});

Paramètre de requête supplémentaire :

Pour en savoir plus sur les abonnements et les modes de remplacement, consultez la documentation Google Developer :

• À propos des modes de remplacement
• Recommandations de Google sur les modes de remplacement
• Mode de remplacement CHARGE_PRORATED_PRICE. Remarque : cette méthode est disponible uniquement pour les mises à niveau d’abonnement. Les rétrogradations ne sont pas prises en charge.
• Mode de remplacement DEFERRED. Remarque : le changement d’abonnement effectif n’aura lieu qu’à la fin de la période de facturation en cours.

Utiliser les codes promotionnels sur iOS

Pour afficher la feuille de saisie de code dans votre app :

Adapty.PresentCodeRedemptionSheet((error) => {
  // handle the error
});

Achats intégrés depuis l’App Store

Lorsqu’un utilisateur initie un achat depuis la page produit de votre App Store et que la transaction est transférée vers votre application, le SDK la complète automatiquement — l’écran d’achat Apple s’affiche immédiatement, et Adapty traite la transaction comme n’importe quel autre achat.

Si le produit mis en avant comporte une offre d’abonnement, le SDK l’applique automatiquement lors de l’achat. L’offre est lue depuis l’intention d’achat App Store, qui l’expose sur iOS 18.0 et versions ultérieures. Sur iOS 16.4–17.x, l’achat se finalise au prix de base.

Pour gérer les achats mis en avant dans votre code, IAdaptyEventListener inclut la méthode requise OnReceivePromotedPurchase(AdaptyPromotedProduct), associée à Adapty.MakePromotedPurchase pour finaliser un achat reçu :

public void OnReceivePromotedPurchase(AdaptyPromotedProduct product) {
    Adapty.MakePromotedPurchase(product, (result, error) => {
        // process the purchase result
    });
}

Le SDK ne transmet pas encore les achats promus à cette méthode — il les finalise automatiquement — vous ne pouvez donc pas différer un achat promu pour afficher quelque chose de personnalisé au préalable. Implémentez quand même la méthode (elle est requise par l’interface) ; un corps vide est une implémentation valide.

Gérer les plans prépayés (Android)

Si vos utilisateurs peuvent acheter des plans prépayés (par exemple, souscrire un abonnement non renouvelable pour plusieurs mois), vous pouvez activer les transactions en attente pour les plans prépayés.

using UnityEngine;
using AdaptySDK;

var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
    .SetGoogleEnablePendingPrepaidPlans(true);

Adapty.Activate(builder.Build(), (error) => {
    if (error != null) {
        // handle the error
        return;
    }
});