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

Satın Almaları Geri Yükleme, kullanıcıların daha önce satın aldıkları içeriklere (abonelikler veya uygulama içi satın almalar gibi) tekrar ücret ödemeksizin erişmesini sağlayan bir özelliktir. Bu özellik, özellikle uygulamayı kaldırıp yeniden yükleyen ya da yeni bir cihaza geçen ve daha önce satın aldıkları içeriklere tekrar ödeme yapmadan erişmek isteyen kullanıcılar için oldukça kullanışlıdır.

Note

Ekranı bir builder’da oluşturduysanız, satın almaları manuel olarak geri yüklemenize gerek yoktur. Geri yükleme kontrolünü bağlayın — Flow & Paywall Builder’daki Restore purchases eylemi ya da eski builder’daki bir geri yükleme bağlantısı veya düğmesi — ve SDK geri yüklemeyi tamamlar.

Ekranı kendiniz oluşturduysanız, .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 3.17.3 ve 4.0.2 sürümlerinden itibaren, restorePurchases() geri yüklenecek hiçbir şey olmasa bile başarıyla tamamlanır: mevcut profili döndürür, dolayısıyla içindeki access level durumunu kontrol edin. Daha eski SDK sürümlerinde bu durumda metot 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.

Android SDK 3.17.3 ve 4.0.2 sürümlerinden itibaren Google Play Billing Library 8 kullanan Adapty, Play Store’un artık süresi dolmuş abonelikleri veya tüketilmiş tek seferlik satın almaları döndürmediğini belirtir. Kullanıcıların bu satın almaları farklı cihazlarda ve yeniden yüklemelerde kurtarabilmesi için Adapty.identify ile onları tanımlayın. Böylece Adapty, satın alma geçmişini mağaza yerine kendi backend’inden 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.

Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.