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 bir adımıdır. Ancak, paywall’larınızı özelleştirmek için Paywall Builder kullanıyorsanız, yalnızca bu paywall’ları göstermek satın almaları desteklemek için yeterlidir.

Paywall Builder kullanmıyorsanı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 geçit işlevi görür.

Ödeme duvarı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 yapma

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
}