Effectuer des achats dans une application mobile avec le SDK iOS

Dans le SDK 3.x, le SDK appelle la méthode déléguée shouldAddStorePayment à la place :

• Traiter la transaction immédiatement : Retournez true dans shouldAddStorePayment. L’écran d’achat Apple s’affichera aussitôt.
• Stocker l’objet produit pour un traitement ultérieur : Retournez false dans shouldAddStorePayment, puis appelez makePurchase avec le produit stocké plus tard.

final class YourAdaptyDelegateImplementation: AdaptyDelegate {
    nonisolated func shouldAddStorePayment(for product: AdaptyDeferredProduct) -> Bool {
        // 1a.
        // Return `true` to continue the transaction in your app. The Apple purchase system screen will show automatically.

        // 1b.
        // Store the product object and return `false` to defer or cancel the transaction.
        false
    }
    
    // 2. Continue the deferred purchase later on by passing the product to `makePurchase` when the timing is appropriate
    func continueDeferredPurchase() async {
        let storedProduct: AdaptyDeferredProduct = // get the product object from 1b.
        do {
            try await Adapty.makePurchase(product: storedProduct)
        } catch {
            // handle the error
        }
    }
}

Les codes d’offre vous permettent d’accorder des remises ou des essais gratuits à des utilisateurs spécifiques. Contrairement aux offres classiques appliquées automatiquement, les codes d’offre sont distribués en dehors de l’application — par e-mail, réseaux sociaux ou supports imprimés. Les utilisateurs les échangent en saisissant le code dans l’App Store, en suivant une URL de remboursement ou via une boîte de dialogue intégrée à l’application.

Pour configurer des codes d’offre, ouvrez un abonnement dans App Store Connect et accédez à sa section Offer Codes. Vous pouvez créer trois types de codes d’offre :

• Free — l’abonnement est gratuit pendant une durée définie, puis le renouvellement suivant s’effectue au plein tarif.
• Pay as you go — l’utilisateur paie un prix réduit à chaque cycle de facturation pendant une durée définie, puis l’abonnement se renouvelle au plein tarif.
• Pay up front — l’utilisateur paie un prix réduit unique pour toute la durée de l’offre, puis l’abonnement se renouvelle au plein tarif.

Il n’est pas nécessaire d’ajouter des codes d’offre à Adapty. Apple associe chaque transaction pendant la période d’offre à la catégorie du code d’offre. Cela inclut l’échange initial et tous les renouvellements à prix réduit qui suivent. Adapty détecte ce marqueur et enregistre chaque transaction avec la catégorie d’offre offer_code. Une fois la période d’offre terminée et l’abonnement renouvelé au plein tarif, le marqueur n’est plus présent. Vous pouvez filtrer les analytics par le type d’offre Offer Code dans l’Adapty Dashboard.

Résolution des écarts de revenus

Si vous constatez qu’une transaction liée à un code d’offre apparaît dans Adapty au prix plein du produit au lieu du prix réduit, vérifiez les points suivants dans App Store Connect :

• Le code d’offre dispose d’une tarification correctement configurée pour toutes les régions où les utilisateurs peuvent l’échanger.
• Le prix de l’offre est défini pour le pays ou la région spécifique de l’utilisateur. Apple envoie le prix régional dans la transaction. Si aucun prix régional n’est configuré pour l’offre, Apple peut envoyer le prix plein du produit à la place.

Vous pouvez filtrer et vérifier les transactions liées aux codes d’offre dans l’Adapty Dashboard grâce aux filtres Offer Code et Offer Discount Type.

Anciens codes promo (obsolètes)

Les anciens codes promo (limités à 100 par application et par version) accordaient un accès gratuit à un abonnement. Contrairement aux codes d’offre, Apple n’incluait pas les informations de remise dans les transactions de codes promo — il envoyait le prix plein du produit dans le reçu. Par conséquent, Adapty enregistrait ces transactions au prix plein, ce qui provoquait des écarts de revenus entre les analytics Adapty et App Store Connect.

Si vous constatez des transactions historiques au prix plein qui auraient dû être gratuites, il s’agit probablement d’anciens codes promo. Ces codes étant désormais obsolètes, passez aux codes d’offre pour un suivi précis des revenus.