Android - Yeni Paywall Builder paywall'larını gösterme
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 oluşturulduğunda onların yerine geçecek string değerleriyle eşleştiren bir sözlük ya da 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 13d 09h 03m 34s gibi — zamanlayıcının bitiş zamanından, yani Yılbaşı gibi bir tarihten, mevcut zamanın çıkarılmasıyla hesaplanan) 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 dinamik olarak belirtilen değerle (örneğin John) değiştirmesini sağlar.
tagResolver’ı paywall’ı göstermeden hemen önce oluşturup doldurmanızı öneririz. Hazır olduğunda, paywall’ı sunmak için kullandığınız AdaptyUI metoduna aktarın.
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>