Kotlin Multiplatform SDK ile mobil uygulamada satın alma yapma

Mobil uygulamanızda paywall’ları görüntülemek, kullanıcılara premium içerik veya hizmetlere erişim sunmanın temel adımlarından biridir. Ancak, yalnızca Adapty’nin ekranı oluşturduğu durumlarda — yani bir flow ya da eski Paywall Builder’dan bir paywall kullanıldığında — paywall, satın almaları kendi başına destekler.

Ekranı kendi kodunuzda oluşturuyorsanız, satın alma işlemini tamamlamak ve istenen içeriğin kilidini açmak için .makePurchase() adlı ayrı bir metot kullanmanız gerekir. Bu metot, kullanıcıların paywall’larla etkileşime geçmesi ve istedikleri işlemleri gerçekleştirmesi için bir kapı görevi görür.

Paywall’ınızda, kullanıcının satın almaya çalıştığı ürün için aktif bir promosyon teklifi varsa, Adapty bunu satın alma sırasında otomatik olarak uygular.

Başlangıç yapılandırmasını tek bir adım atlamadan tamamladığınızdan emin olun. Aksi takdirde satın almaları doğrulayamayız.

Satın alma işlemi

Adapty.makePurchase(product = product).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
                // Grant access to the paid features
            }
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // Handle the case where the user canceled the purchase
        }
        is AdaptyPurchaseResult.Pending -> {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    }
}.onError { error ->
    // Handle the error
}

İstek parametreleri:

Yanıt parametreleri:

Satın alma sırasında abonelik değiştirme

Kullanıcı mevcut aboneliğini yenilemek yerine yeni bir abonelik seçtiğinde, bu sürecin işleyişi uygulama mağazasına göre değişir. Google Play’de abonelik otomatik olarak güncellenmez. Aşağıda açıklandığı gibi geçişi mobil uygulama kodunuzda yönetmeniz gerekir.

Android’de aboneliği başka biriyle değiştirmek için .makePurchase() metodunu ek parametre ile çağırın:

val subscriptionUpdateParams = AdaptyAndroidSubscriptionUpdateParameters(
    oldSubVendorProductId = "old_subscription_product_id",
    replacementMode = AdaptyAndroidSubscriptionUpdateReplacementMode.CHARGE_FULL_PRICE
)

val purchaseParams = AdaptyPurchaseParameters.Builder()
    .setSubscriptionUpdateParams(subscriptionUpdateParams)
    .build()

Adapty.makePurchase(
    product = product,
    parameters = purchaseParams
).onSuccess { purchaseResult ->
    when (purchaseResult) {
        is AdaptyPurchaseResult.Success -> {
            val profile = purchaseResult.profile
            // successful cross-grade
        }
        is AdaptyPurchaseResult.UserCanceled -> {
            // user canceled the purchase flow
        }
        is AdaptyPurchaseResult.Pending -> {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    }
}.onError { error ->
    // Handle the error
}

Ek istek parametresi:

Abonelikler ve değiştirme modları hakkında daha fazla bilgi için Google Geliştirici belgelerine bakabilirsiniz:

• Değiştirme modları hakkında
• Google’ın değiştirme modları önerileri
• CHARGE_PRORATED_PRICE değiştirme modu. Not: Bu yöntem yalnızca abonelik yükseltmeleri için kullanılabilir. Düşürme desteklenmez.
• DEFERRED değiştirme modu. Not: Gerçek abonelik değişikliği yalnızca mevcut abonelik fatura dönemi sona erdiğinde gerçekleşir.

iOS’ta teklif kodlarını kullanma

Uygulamanızda kod kullanma sayfasını görüntülemek için:

Adapty.presentCodeRedemptionSheet()
    .onSuccess {
        // code redemption sheet presented successfully
    }
    .onError { error ->
        // handle the error
    }

Ön ödemeli planları yönetme (Android)

Uygulama kullanıcılarınız ön ödemeli planlar satın alabiliyorsa (örneğin birkaç aylık yenilenemez abonelik), ön ödemeli planlar için bekleyen işlemleri etkinleştirebilirsiniz.

Adapty.activate(
    AdaptyConfig.Builder("PUBLIC_SDK_KEY")
        .withGoogleEnablePendingPrepaidPlans(true)
        .build()
).onSuccess {
    // successful activation
}.onError { error ->
    // handle the error
}

App Store’dan tanıtılan uygulama içi satın almalar

Bir kullanıcı, App Store ürün sayfanızdan satın alma işlemi başlattığında ve bu işlem uygulamanıza aktarıldığında, SDK ürünü OnPromotedPurchaseListener aracılığıyla size iletir. Satın alma işlemini tamamlamak uygulamanıza kalmıştır: ürünü makePromotedPurchase fonksiyonuna geçirin. Bu adımı ne zaman gerçekleştireceğinizi siz kontrol ettiğinizden, satın alma başlamadan önce kendi ekranınızı gösterebilirsiniz.

Promosyon satın almalarını desteklemek için dinleyiciyi kaydedin ve satın alma işlemini dinleyici içinden tamamlayın:

Adapty.setOnPromotedPurchaseListener(OnPromotedPurchaseListener { product ->
    scope.launch {
        Adapty.makePromotedPurchase(product)
            .onSuccess { result -> /* process the purchase result */ }
            .onError { error -> /* handle the error */ }
    }
})

Listener’ı uygulama başlangıcında, Adapty.activate’ten hemen sonra kaydedin. Promosyon satın alma işlemi genellikle uygulamayı soğuk başlatır, bu nedenle kaydınız çalışmadan önce SDK’ya ulaşabilir. SDK bu tür bir satın almayı bekletir ve siz kayıt olur olmaz iletir; yalnızca en son olanı saklar ve her seferinde konsolda bir uyarı yazar.

Tanıtılan ürün bir abonelik teklifi içeriyorsa, SDK bunu satın alma sırasında otomatik olarak uygular. Teklif, iOS 18.0 ve sonrasında bunu sunan App Store satın alma niyetinden okunur. iOS 16.4–17.x sürümlerinde ise satın alma temel fiyat üzerinden gerçekleşir.

makePromotedPurchase hiçbir satın alma parametresi almaz — tanıtılan bir ürün, bir paywall’dan değil App Store’dan geldiğinden paywall bağlamı taşımaz. makePurchase ile aynı AdaptyPurchaseResult değerini döndürür.

AdaptyPromotedProduct, vendorProductId, localizedTitle, localizedDescription, price, regionCode, isFamilyShareable ve AdaptyProductSubscription türünde bir subscription içerir.