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.

Aşağıda kullanılan viewConfiguration nesnesini edinmek için bkz. Paywall Builder paywalllarını ve yapılandırmalarını getirme.

İstek parametreleri:

ParametreZorunlulukAçıklama
viewConfigurationzorunluPaywall’ın görsel ayrıntılarını içeren bir AdaptyUI.LocalizedViewConfiguration nesnesi sağlayın. Bunu 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.
productsisteğe bağlıÜrünlerin ekranda görüntülenme zamanlamasını optimize etmek için bir AdaptyPaywallProduct dizisi sağlayın. null geçilirse AdaptyUI gerekli ürünleri otomatik olarak getirir.
eventListeneristeğe bağlıPaywall olaylarını izlemek için bir AdaptyUiEventListener sağlayın. Kullanım kolaylığı açısından AdaptyUiDefaultEventListener’ı genişletmeniz önerilir. Daha fazla bilgi için Paywall olaylarını yönetme konusuna bakın.
insetsisteğe bağlı

Insets, paywall etrafındaki tıklanabilir öğelerin sistem çubuklarının arkasına gizlenmesini önleyen boşluklardır.

Varsayılan: UNSPECIFIED — bu, Adapty’nin insets değerlerini otomatik olarak ayarlayacağı anlamına gelir; edge-to-edge paywall’lar için mükemmel çalışır.

Paywall’ınız edge-to-edge değilse özel insets değerleri ayarlamak isteyebilirsiniz. Bunun nasıl yapılacağını aşağıdaki Paywall insets değerlerini değiştirme bölümünde okuyabilirsiniz.

personalizedOfferResolveristeğe bağlıKişiselleştirilmiş fiyatlandırmayı (daha fazla bilgi) belirtmek için AdaptyUiPersonalizedOfferResolver uygulayın ve AdaptyPaywallProduct’ı ürünün fiyatı kişiselleştirilmişse true, değilse false olarak eşleyen kendi mantığınızı geçirin.
tagResolveristeğe bağlıPaywall metnindeki özel etiketleri çözümlemek için AdaptyUiTagResolver kullanın. Bu resolver bir etiket parametresi alır ve bunu karşılık gelen bir string’e dönüştürür. Daha fazla bilgi için Paywall Builder’da Özel Etiketler konusuna bakın.
timerResolveristeğe bağlıÖzel zamanlayıcı işlevselliğini kullanacaksanız resolver’ı 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:

  • AdaptyPaywallView ile ne durum çubuğu ne de gezinme çubuğu çakışmıyorsa AdaptyPaywallInsets.NONE kullanı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’i 0 olarak 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>