Android SDK'da özel paywall'unuzda satın almaları etkinleştirin

Bu kılavuz, Adapty’yi özel paywall’larınıza nasıl entegre edeceğinizi açıklar. Paywall implementasyonunun tam kontrolü sizde kalırken Adapty SDK ürünleri getirir, yeni satın almaları yönetir ve önceki satın almaları geri yükler.

Bu rehber, özel paywall’lar uygulayan geliştiriciler içindir. Satın alma işlemlerini etkinleştirmenin en kolay yolunu arıyorsanız Adapty Flow Builder’ı kullanın. Flow Builder ile no-code görsel editörde flow’lar oluşturursunuz, tüm satın alma mantığını Adapty 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:

Products – kullanıcıların satın alabileceği her şey (abonelikler, consumable’lar, süresiz erişim)
Paywalls – hangi ürünlerin sunulacağını tanımlayan yapılandırmalar. Adapty’de ürünlere yalnızca paywall’lar aracılığıyla ulaşılabilir; bu tasarım sayesinde uygulama koduna dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz.
Placements – uygulamanızda paywall’ları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Paywall’ları kontrol panelinde placement’lara bağlar, ardından kodunuzda placement ID’siyle talep edersiniz. Bu yapı, A/B testleri çalıştırmayı ve farklı kullanıcılara farklı paywall’lar göstermeyi kolaylaştırır. Bu kavramları, özel paywallınızla çalışsanız bile anladığınızdan emin olun. Bunlar, uygulamanızda sattığınız ürünleri yönetmenin yollarından ibarettir.

Özel paywallınızı hayata geçirmek için bir paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekir. Bu yapı, ürünlerinizi almanızı sağlar. Kontrol panelinde yapmanız gerekenleri anlamak için hızlı başlangıç kılavuzunu buradan 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 üzere şunları yapmanız gerekir:

getFlow metoduna placement ID’sini geçirerek flow nesnesini alın.
Bu flow için getPaywallProducts metodunu kullanarak ürünler dizisini alın.


fun loadPaywall() {
    Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
        when (result) {
            is AdaptyResult.Success -> {
                val flow = result.value
                Adapty.getPaywallProducts(flow) { 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.getFlow("YOUR_PLACEMENT_ID", result -> {
        if (result instanceof AdaptyResult.Success) {
            AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
            
            Adapty.getPaywallProducts(flow, productResult -> {
                if (productResult instanceof AdaptyResult.Success) {
                    List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) productResult).getValue();
                    // Özel paywall UI'ınızı oluşturmak için ürünleri kullanın
                } else if (productResult instanceof AdaptyResult.Error) {
                    AdaptyError error = ((AdaptyResult.Error) productResult).getError();
                    // Hatayı işleyin
                }
            });
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Hatayı işleyin
        }
    });
}

Adım 2. Satın almaları kabul etme

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


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();
                // Satın alma başarılı, profil güncellendi
            } else if (purchaseResult instanceof AdaptyPurchaseResult.UserCanceled) {
                // Kullanıcı satın almayı iptal etti
            } else if (purchaseResult instanceof AdaptyPurchaseResult.Pending) {
                // Satın alma beklemede (örn. kullanıcı nakit ile ödeyecek)
            }
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Hatayı işle
        }
    });
}

3. Adım: Satın almaları geri yükle

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

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


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();
            // Geri yükleme başarılı, profil güncellendi
        } else if (result instanceof AdaptyResult.Error) {
            AdaptyError error = ((AdaptyResult.Error) result).getError();
            // Hatayla ilgilen
        }
    });
}

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ı tamamlayabildiğinizden emin olmak için Google Play Store’da satın alımlarınızı test edin. Bunun gerçek 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önetimi dahil olmak üzere satın alma işlemlerinin nasıl ele alındığını göstermektedir. Ardından, paywall’u gösterip göstermeyeceğinizi ya da ü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.