Android SDK'da özel paywallınızda satın alımları etkinleştirme

Bu kılavuz, Adapty’yi özel paywalllarınıza nasıl entegre edeceğinizi açıklar. Paywall uygulaması üzerinde tam kontrolü elinizde tutarken Adapty SDK ürünleri çeker, yeni satın alımları işler ve önceki satın alımları geri yükler.

Bu kılavuz, özel paywall uygulayan geliştiriciler içindir. Satın alımları etkinleştirmenin en kolay yolunu arıyorsanız Adapty Paywall Builder’ı kullanın. Paywall Builder ile kodsuz görsel düzenleyicide paywall oluşturursunuz, Adapty tüm satın alma mantığını otomatik olarak yönetir ve uygulamanızı yeniden yayınlamadan farklı tasarımları test edebilirsiniz.

Başlamadan önce

Ürünleri ayarlama

Uygulama içi satın alımları etkinleştirmek için üç temel kavramı anlamanız gerekir:

Ürünler – kullanıcıların satın alabileceği her şey (abonelikler, consumable’lar, süresiz erişim)
Paywalllar – hangi ürünlerin sunulacağını tanımlayan yapılandırmalar. Adapty’de ürünlere erişmenin tek yolu paywalllardır; bu tasarım sayesinde uygulama kodunuza dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz.
Placementlar – uygulamanızda paywallları nerede ve ne zaman göstereceğiniz (örneğin main, onboarding, settings). Kontrol panelinde placementlar için paywall ayarlarsınız, ardından kodunuzda placement ID’siyle bunları talep edersiniz. Bu yapı A/B testleri çalıştırmayı ve farklı kullanıcılara farklı paywalllar göstermeyi kolaylaştırır.

Özel paywall kullanıyor olsanız bile bu kavramları anladığınızdan emin olun. Bunlar, uygulamanızda sattığınız ürünleri yönetmenin temel yoludur.

Özel paywallınızı uygulamak için bir paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekir. Bu kurulum ürünlerinizi almanızı sağlar. Kontrol panelinde ne yapmanız gerektiğini anlamak için buradaki hızlı başlangıç kılavuzunu takip edin.

Kullanıcıları yönetme

Kendi tarafınızda backend kimlik doğrulamasıyla veya olmadan çalışabilirsiniz.

Ancak Adapty SDK, anonim ve kimliği doğrulanmış kullanıcıları farklı şekilde yönetir. Ayrıntıları anlamak ve kullanıcılarla doğru şekilde çalıştığınızdan emin olmak için kimlik doğrulama hızlı başlangıç kılavuzunu okuyun.

Adım 1. Ürünleri alın

Özel paywallınız için ürünleri almak amacıyla şunları yapmanız gerekir:

getPaywall metoduna placement ID’sini geçerek paywall nesnesini alın.
getPaywallProducts metodunu kullanarak bu paywall için ürünler dizisini alın.


fun loadPaywall() {
    Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val paywall = result.value
                Adapty.getPaywallProducts(paywall) { productResult ->
                    when (productResult) {
                        is AdaptyResult.Success -> {
                            val products = productResult.value
                            // Use products to build your custom paywall UI
                        }
                        is AdaptyResult.Error -> {
                            val error = productResult.error
                            // Handle the error
                        }
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}



public void loadPaywall() {
    Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
            
            Adapty.getPaywallProducts(paywall, productResult -> {
                if (productResult instanceof AdaptyResult.Success) {
                    List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) productResult).getValue();
                    // Use products to build your custom paywall UI
                } else if (productResult instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) productResult).getError();
                    // Handle the error
                }
            });
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

Adım 2. Satın alımları kabul edin

Kullanıcı özel paywallınızda bir ürüne dokunduğunda, seçilen ürünle birlikte makePurchase metodunu çağırın. Bu işlem satın alma akışını yönetecek ve güncellenmiş profili döndürecektir.


fun purchaseProduct(activity: Activity, product: AdaptyPaywallProduct) {
    Adapty.makePurchase(activity, product) { result ->
        when (result) {
            is AdaptyResult.Success -> {
                when (val purchaseResult = result.value) {
                    is AdaptyPurchaseResult.Success -> {
                        val profile = purchaseResult.profile
                        // Purchase successful, profile updated
                    }
                    is AdaptyPurchaseResult.UserCanceled -> {
                        // User canceled the purchase
                    }
                    is AdaptyPurchaseResult.Pending -> {
                        // Purchase is pending (e.g., user will pay offline with cash)
                    }
                }
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void purchaseProduct(Activity activity, AdaptyPaywallProduct product) {
    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();
                // Purchase successful, profile updated
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // User canceled the purchase
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // Purchase is pending (e.g., user will pay offline with cash)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

Adım 3. Satın alımları geri yükleyin

Google Play ve diğer uygulama mağazaları, abonelik içeren tüm uygulamaların kullanıcılara satın alımlarını geri yükleyebilecekleri bir yol sunmasını zorunlu kılar.

Kullanıcı geri yükleme düğmesine dokunduğunda restorePurchases metodunu çağırın. Bu işlem satın alma geçmişini Adapty ile senkronize edecek ve güncellenmiş profili döndürecektir.


fun restorePurchases() {
    Adapty.restorePurchases { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val profile = result.value
                // Restore successful, profile updated
            }
            is AdaptyResult.Error -> {
                val error = result.error
                // Handle the error
            }
        }
    }
}


public void restorePurchases() {
    Adapty.restorePurchases(result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyProfile profile = ((AdaptyResult.Success<AdaptyProfile>) result).getValue();
            // Restore successful, profile updated
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Handle the error
        }
    });
}

Sonraki adımlar

Sorularınız mı var ya da sorunlarla mı karşılaşıyorsunuz? Sık sorulan soruların yanıtlarını bulabileceğiniz veya kendi sorularınızı sorabileceğiniz destek forumumuza göz atın. Ekibimiz ve topluluğumuz yardımcı olmak için burada!

Paywallınız uygulamada gösterilmeye hazır. Paywalldan test satın alımını tamamlayabildiğinizden emin olmak için Google Play Store’da satın alımlarınızı test edin. Bunun üretime hazır bir uygulamada nasıl çalıştığını görmek için örnek uygulamamızdaki ProductListFragment.kt dosyasına göz atın; bu dosya hata yönetimi, kullanıcı arayüzü geri bildirimi ve abonelik yönetimiyle birlikte satın alma işlemlerini göstermektedir.

Ardından, paywallı gösterip göstermeyeceğinizi veya ücretli özelliklere erişim izni verip vermeyeceğinizi belirlemek için kullanıcıların satın alma işlemini tamamlayıp tamamlamadığını kontrol edin.