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.

Important

Bu kılavuz, özel paywall’lar geliştiren geliştiriciler içindir. Satın alımları etkinleştirmenin en kolay yolunu arıyorsanız Adapty Flow & Paywall Builder’ı kullanın. Flow & Paywall Builder ile flow’larınızı kod yazmadan görsel bir editörde oluşturursunuz, tüm satın alma mantığını Adapty otomatik olarak yönetir ve uygulamanızı yeniden yayımlamadan 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)
Özel paywalllar – hangi ürünlerin sunulacağını belirleyen konfigürasyonlar. Adapty’de paywalllar, ürünleri almanın tek yoludur; ancak bu tasarım sayesinde uygulama kodunuza dokunmadan ürünleri, fiyatları ve teklifleri değiştirebilirsiniz.
Placement’lar – uygulamanızda paywallları nerede ve ne zaman göstereceğiniz (main, onboarding, settings gibi). Kontrol panelinde placement’lar için paywallları ayarlayıp kodunuzda placement ID’siyle bunları talep edersiniz. Bu sayede A/B testleri çalıştırmak ve farklı kullanıcılara farklı paywalllar göstermek kolaylaşır.

Bu kavramları, özel paywall’ınızla çalışıyor olsanız bile anladığınızdan emin olun. Temel olarak bunlar, uygulamanızda sattığınız ürünleri yönetmenin bir yoludur.

Özel paywall’ınızı uygulamak için bir custom paywall oluşturmanız ve bunu bir placement’a eklemeniz gerekir. Bu yapı, ürünlerinizi almanızı sağlar. Kontrol panelinde ne yapmanız gerektiğini 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

Tip

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.