Android SDK'da mobil uygulamada satın almaları geri yükleme

Satın Almaları Geri Yükleme, kullanıcıların abonelikler veya uygulama içi satın almalar gibi daha önce satın aldıkları içeriklere tekrar ücret ödemeden erişmesini sağlayan bir özelliktir. Bu özellik, uygulamayı silip yeniden yükleyen ya da yeni bir cihaza geçip daha önce satın aldıkları içeriklere tekrar erişmek isteyen kullanıcılar için oldukça faydalıdır.

Note

Paywall Builder ile oluşturulmuş paywallerde, satın almalar sizin tarafınızdan ek bir kod yazılmasına gerek kalmadan otomatik olarak geri yüklenir. Bu sizin durumunuzsa bu adımı atlayabilirsiniz.

Paywalli özelleştirmek için Paywall Builder kullanmıyorsanız satın almayı geri yüklemek için .restorePurchases() metodunu çağırın:

Adapty.restorePurchases { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val profile = result.value
                      
            if (profile.accessLevels["YOUR_ACCESS_LEVEL"]?.isActive == true) {
            // successful access restore
            }
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.restorePurchases(result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
        
        if (profile != null) {
            AdaptyProfile.AccessLevel premium = profile.getAccessLevels().get("YOUR_ACCESS_LEVEL");
            
            if (premium != null && premium.isActive()) {
                // successful access restore
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Yanıt parametreleri:

Parametre Açıklama

Parametre	Açıklama
Profile	Bir `AdaptyProfile` nesnesi. Bu model, access level’lar, abonelikler ve abonelik dışı satın almalar hakkında bilgi içerir. Kullanıcının uygulamaya erişimi olup olmadığını belirlemek için access level durumunu kontrol edin.

Profile

Bir AdaptyProfile nesnesi. Bu model, access level’lar, abonelikler ve abonelik dışı satın almalar hakkında bilgi içerir.

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

Info

Adapty Android SDK 4.0.2 ve sonraki sürümlerde, restorePurchases() yöntemini çağırdığınızda geri yüklenecek bir şey olmasa bile işlem başarıyla tamamlanır: mevcut profil döndürülür, bu nedenle içindeki access level durumunu kontrol edin. Daha eski SDK sürümlerinde bu durumda yöntem NO_PURCHASES_TO_RESTORE hatasıyla başarısız olur.

Neler geri yüklenebilir

restorePurchases, Google Play’deki aktif abonelikleri ve tüketilmemiş tek seferlik satın almaları kurtarır.

Google Play Billing Library 8’i kullanan Adapty Android SDK 4.0.2 ve sonrasında, Play Store artık süresi dolmuş abonelikleri veya tüketilmiş tek seferlik satın almaları döndürmemektedir. Kullanıcıların bu satın almaları farklı cihazlarda ve yeniden kurulumlardan sonra geri yükleyebilmesi için Adapty.identify ile tanımlayın. Adapty bu durumda satın alma geçmişini mağaza yerine kendi arka ucundan geri yükler.

Note

Google Play yalnızca hâlihazırda sahip olunan satın almaları raporladığından, restorePurchases() Adapty’yi entegre etmeden önce süresi dolmuş abonelikleri bulamaz. Bunları Adapty’ye eklemek için geçmiş verilerinizi içe aktarın.

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek bir örnekle görmek ister misiniz? Tam kurulumu, paywall’ların gösterimini, satın alma işlemlerini ve diğer temel işlevleri içeren örnek uygulamalarımıza göz atın.