Android SDK'da 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 önemli bir adımıdır. Ancak bir paywall’ın satın alma işlemlerini kendi başına desteklemesi yalnızca Adapty’nin ekranı render ettiği durumlarda geçerlidir; yani bir flow veya eski Paywall Builder ile oluşturulan bir paywall söz konusu olduğunda.

Ekranı kendi kodunuzda render ediyorsanız, satın alma işlemini tamamlamak ve istenen içeriğin kilidini açmak için .makePurchase() adlı ayrı bir yöntem kullanmanız gerekir. Bu yöntem, kullanıcıların paywall’larla etkileşime girmesi ve istedikleri işlemleri gerçekleştirmesi için bir köprü görevi görür.

Eğer 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.

Warning

Unutmayın ki başlangıç teklifi yalnızca ekranı Adapty render ettiğinde otomatik olarak uygulanır.

Diğer durumlarda kullanıcının iOS’ta başlangıç teklifine uygunluğunu doğrulamanız gerekir. Bu adımı atlamak uygulamanızın yayın sırasında reddedilmesine yol açabilir. Ayrıca başlangıç teklifine hak kazanmış kullanıcıların tam fiyat üzerinden ücretlendirilmesine neden olabilir.

Tek bir adımı bile atlamadan başlangıç yapılandırmasını tamamladığınızdan emin olun. Bu olmadan satın almaları doğrulayamayız.

Satın alma işlemi

Note

Ekranı Adapty mı oluşturuyor? Bir flow veya Paywall Builder paywalli için satın almalar otomatik olarak işlenir; bu adımı atlayabilirsiniz.

Adım adım rehber mi arıyorsunuz? Tam bağlam ile uçtan uca uygulama talimatları için hızlı başlangıç kılavuzuna göz atın.

Adapty.makePurchase(activity, product, null) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                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)
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

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();
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");

            if (premium != null && premium.isActive()) {
                // Grant access to the paid features
            }
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // Handle the case where the user canceled the purchase
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // Handle deferred purchases (e.g., the user will pay offline with cash)
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
Product	zorunlu	Paywall’dan alınan bir `AdaptyPaywallProduct` nesnesi.

Yanıt parametreleri:

Parametre	Açıklama
Profile	İstek başarılı olursa yanıt bu nesneyi içerir. Bir AdaptyProfile nesnesi, kullanıcının uygulama içindeki access level’ları, abonelikleri ve abonelik dışı satın almaları hakkında kapsamlı bilgi sağlar. Kullanıcının uygulamaya erişimi olup olmadığını belirlemek için access level durumunu kontrol edin.

Parametre

Açıklama

Profile

İstek başarılı olursa yanıt bu nesneyi içerir. Bir AdaptyProfile nesnesi, kullanıcının uygulama içindeki access level’ları, abonelikleri ve abonelik dışı satın almaları hakkında kapsamlı bilgi sağlar.

Kullanıcının uygulamaya erişimi olup olmadığını belirlemek için access level durumunu kontrol edin.

Warning

Not: Apple’ın StoreKit sürümü v2.0’dan düşük ve Adapty SDK sürümü v2.9.0’dan düşükse, bunun yerine Apple App Store paylaşımlı sırrı sağlamanız gerekir. Bu yöntem Apple tarafından artık kullanım dışı bırakılmıştır.

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

Bir kullanıcı mevcut aboneliğini yenilemek yerine yeni bir abonelik seçtiğinde, bu işlemin nasıl çalışacağı uygulama mağazasına göre değişir. Google Play’de abonelik otomatik olarak güncellenmez. Geçişi aşağıda açıklandığı şekilde mobil uygulama kodunuzda yönetmeniz gerekir.

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

Warning

subscriptionUpdateParams parametresini yalnızca kullanıcı aynı Google hesabında satın alınmış aktif bir abonelikten geçiş yaptığında kullanın. Yeni bir satın alma için makePurchase’ı bu parametre olmadan çağırın — parametreyi geçirmek, mesajı yanıltıcı biçimde etkin olmayan bir aboneliğe veya farklı bir Google hesabına işaret eden CURRENT_SUBSCRIPTION_TO_UPDATE_NOT_FOUND_IN_HISTORY hatasıyla satın almanın başarısız olmasına neden olur.

Adapty.makePurchase(
    activity, 
    product, 
    AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build()
) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            when (val purchaseResult = result.value) {
                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
                }
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // Handle the error
        }
    }
}

Ek istek parametresi:

Parametre	Zorunluluk	Açıklama
subscriptionUpdateParams	zorunlu	Bir `AdaptySubscriptionUpdateParameters` nesnesi.

Adapty.makePurchase(
    activity, 
    product, 
    new AdaptyPurchaseParameters.Builder()
        .withSubscriptionUpdateParams(subscriptionUpdateParams)
        .build(),
    result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPurchaseResult purchaseResult = ((AdaptyResult.Success<AdaptyPurchaseResult>) result).getValue();

        if (purchaseResult instanceof AdaptyPurchaseResult.Success) {
            AdaptyProfile profile = ((AdaptyPurchaseResult.Success) purchaseResult).getProfile();

            // successful cross-grade
        } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
            // user canceled the purchase flow
        } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
            // the purchase has not been finished yet, e.g. user will pay offline by cash
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // Handle the error
    }
});

Ek istek parametresi:

Parametre	Zorunluluk	Açıklama
subscriptionUpdateParams	zorunlu	Bir `AdaptySubscriptionUpdateParameters` nesnesi.

Abonelikler ve değiştirme modları hakkında daha fazla bilgiyi Google Geliştirici belgelerinde okuyabilirsiniz:

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

Ön ödemeli planları yönetme

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


AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build()


new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withEnablePendingPrepaidPlans(true)
    .build();