Android - Yeni Paywall Builder paywalllarını sunma
Paywall Builder ile bir paywall özelleştirdiyseniz, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmenize gerek yoktur. Böyle bir paywall, paywall içinde neyin gösterileceğini ve nasıl gösterileceğini zaten içerir.
Bu rehber yalnızca SDK v3.0 gerektiren yeni Paywall Builder paywallları içindir. Paywall sunma süreci, Paywall Builder’ın farklı sürümleriyle tasarlanan paywalllar, remote config paywalllar ve Observer modu için farklılık gösterir.
- Remote config paywalllarını sunmak için bkz. Remote config ile tasarlanan paywall’ı render etme.
- Observer modu paywalllarını sunmak için bkz. Android - Observer modunda Paywall Builder paywalllarını sunma
Aşağıda kullanılan viewConfiguration nesnesini edinmek için bkz. Paywall Builder paywalllarını ve yapılandırmalarını getirme.
İstek parametreleri:
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| viewConfiguration | zorunlu | Paywallın görsel ayrıntılarını içeren bir AdaptyUI.LocalizedViewConfiguration nesnesi sağlayın. Yüklemek için Adapty.getViewConfiguration(paywall) metodunu kullanın. Daha fazla bilgi için Paywall’ın görsel yapılandırmasını getirme konusuna bakın. |
| products | isteğe bağlı | Ekranda ürünlerin gösterim zamanlamasını optimize etmek için bir AdaptyPaywallProduct dizisi sağlayın. null geçilirse AdaptyUI gerekli ürünleri otomatik olarak getirir. |
| eventListener | isteğe bağlı | Paywall olaylarını izlemek için bir AdaptyUiEventListener sağlayın. Kullanım kolaylığı için AdaptyUiDefaultEventListener’ı genişletmeniz önerilir. Daha fazla bilgi için Paywall olaylarını yönetme konusuna bakın. |
| insets | isteğe bağlı | Insets, tıklanabilir öğelerin sistem çubukları arkasında gizlenmesini engelleyen paywall etrafındaki boşluklardır. Varsayılan: Paywallınız kenar-kenara değilse özel insets ayarlamak isteyebilirsiniz. Bunu nasıl yapacağınızı öğrenmek için aşağıdaki Paywall insets’lerini değiştirme bölümüne bakın. |
| personalizedOfferResolver | isteğe bağlı | Kişiselleştirilmiş fiyatlandırmayı (daha fazla bilgi) belirtmek için AdaptyUiPersonalizedOfferResolver’ı uygulayın ve AdaptyPaywallProduct’ı ürün fiyatı kişiselleştirilmişse true, değilse false olarak eşleştiren kendi mantığınızı geçirin. |
| tagResolver | isteğe bağlı | Paywall metnindeki özel etiketleri çözümlemek için AdaptyUiTagResolver kullanın. Bu çözümleyici bir etiket parametresi alır ve bunu karşılık gelen bir dizeye dönüştürür. Daha fazla bilgi için Paywall Builder’da özel etiketler konusuna bakın. |
| timerResolver | isteğe bağlı | Özel zamanlayıcı işlevselliği kullanacaksanız çözümleyiciyi buraya geçirin. |
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.
Paywall insets’lerini değiştirme
Insets, tıklanabilir öğelerin sistem çubukları arkasında gizlenmesini engelleyen paywall etrafındaki boşluklardır. Varsayılan olarak Adapty, kenar-kenara paywalllar için harika çalışan insets’leri otomatik olarak ayarlar.
Paywallınız kenar-kenara değilse özel insets ayarlamak isteyebilirsiniz:
AdaptyPaywallViewile ne durum çubuğu ne de gezinme çubuğu çakışmıyorsaAdaptyPaywallInsets.NONEkullanın.- Paywallınız üst durum çubuğuyla çakışıyor ama alt kısımla çakışmıyorsa gibi daha özel durumlarda, aşağıdaki örnekte gösterildiği gibi yalnızca
bottomInset’i0olarak ayarlayabilirsiniz:
Geliştirici tanımlı zamanlayıcı kullanma
Mobil uygulamanızda geliştirici tanımlı zamanlayıcılar kullanmak için bir timerResolver nesnesi oluşturun; bu nesne, özel zamanlayıcıları paywall render edildiğinde onların yerini alacak dize değerleriyle eşleştiren bir sözlük veya haritadır. İşte bir örnek:
Bu örnekte CUSTOM_TIMER_NY, Adapty kontrol panelinde ayarladığınız geliştirici tanımlı zamanlayıcının Timer ID’sidir. timerResolver, uygulamanızın zamanlayıcıyı doğru değerle (örneğin Yılbaşı gibi zamanlayıcının bitiş zamanından mevcut zaman çıkarılarak hesaplanan 13d 09h 03m 34s) dinamik olarak güncellemesini sağlar.
Özel etiketleri kullanma
Mobil uygulamanızda özel etiketler kullanmak için bir tagResolver nesnesi oluşturun; bu nesne, özel etiketleri paywall render edildiğinde onların yerini alacak dize değerleriyle eşleştiren bir sözlük veya haritadır. İşte bir örnek:
Bu örnekte USERNAME, Adapty kontrol panelinde <USERNAME/> olarak girdiğiniz özel bir etikettir. tagResolver, uygulamanızın bu özel etiketi belirtilen değerle (örneğin John) dinamik olarak değiştirmesini sağlar.
tagResolver’ı paywallınızı sunmadan hemen önce oluşturup doldurmayı öneririz. Hazır olduğunda, paywall sunmak için kullandığınız AdaptyUI metoduna geçirin.
Paywall yükleme göstergesi rengini değiştirme
Yükleme göstergesinin varsayılan rengini şu şekilde geçersiz kılabilirsiniz:
<style name="AppTheme" parent="android:Theme.Material.Light.NoActionBar">
<item name="adapty_progressIndicatorColor">@color/yourColor</item>
</style>