Kotlin Multiplatform SDK'da remote config ile tasarlanmış paywall'ı render etme

Remote config kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcılara göstermek için mobil uygulamanızın kodunda render işlemini kendiniz uygulamanız gerekir. Remote config, ihtiyaçlarınıza göre esneklik sunduğundan, paywall görünümünüze nelerin dahil edileceğini ve nasıl görüneceğini siz belirlersiniz. Adapty, remote configuration’ı almanız için bir yöntem sunar; özel paywall’ınızı nasıl göstereceğiniz tamamen size kalmıştır.

Flow remote config’ini alın ve sunun

v4’te bir flow, remoteConfigs listesinde yapılandırılmış her locale için bir AdaptyRemoteConfig girişi taşır. Kullanıcının tercihine uyan locale’i seçin, ardından ihtiyacınız olan değerleri okuyun.


Adapty.getFlow("YOUR_PLACEMENT_ID")
    .onSuccess { flow ->
        val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
            ?: flow.remoteConfigs.firstOrNull()
        val headerText = config?.dataMap?.get("header_text") as? String
        // use the remote config values
    }
    .onError { error ->
        // handle the error
    }

Bu noktada, gerekli tüm değerleri aldıktan sonra bunları görsel açıdan çekici bir sayfada işleme ve bir araya getirme zamanı gelmiştir. Tasarımın farklı mobil telefon ekranlarına ve yönlendirmelerine uyum sağladığından, çeşitli cihazlarda sorunsuz ve kullanıcı dostu bir deneyim sunduğundan emin olun.

Adapty analytics’in funnel’lar ve A/B testleri için bilgi toplayabilmesi amacıyla, aşağıda açıklandığı şekilde paywall görüntüleme olayını kaydettiğinizden emin olun.

Paywallı görüntüledikten sonra satın alma flow’unu ayarlamaya devam edin. Kullanıcı bir satın alma işlemi yaptığında, flow’unuzdaki ürünle birlikte .makePurchase() metodunu çağırmanız yeterlidir. .makePurchase() metodu hakkında daha fazla bilgi için Satın alma yapma sayfasını okuyun.

Yedek paywall olarak adlandırılan bir yedek paywall oluşturmanızı öneririz. Bu yedek, internet bağlantısı olmadığında veya önbellek mevcut olmadığında kullanıcıya gösterilerek bu durumlarda bile sorunsuz bir deneyim sağlar.

Flow görüntüleme olaylarını takip edin

Adapty, flow’larınızın ve paywall’larınızın performansını ölçmenize yardımcı olur. Satın alma verilerini otomatik olarak toplasak da, görüntüleme olaylarını kaydetmek için sizin müdahaleniz gereklidir; çünkü bir kullanıcının flow’u ne zaman gördüğünü yalnızca siz bilebilirsiniz.

Görüntüleme olayı kaydetmek için .logShowFlow(flow) metodunu çağırmanız yeterlidir; bu, huniler ve A/B testlerindeki metriklerinize yansıyacaktır.

Flow Builder veya Paywall Builder tarafından oluşturulan flow veya paywall’ları görüntülüyorsanız .logShowFlow(flow) çağrısı yapmanıza gerek yoktur. Bu durumlarda Adapty görüntülemeleri otomatik olarak takip eder.

Adapty.logShowFlow(flow)
    .onSuccess {
        // flow view logged successfully
    }
    .onError { error ->
        // handle the error
    }

İstek parametreleri:

Parametre	Varlık	Açıklama
flow	zorunlu	`Adapty.getFlow` aracılığıyla elde edilen bir `AdaptyFlow` nesnesi.

Remote config kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcılara göstermek için mobil uygulamanızın kodunda render işlemini kendiniz uygulamanız gerekir. Remote config, ihtiyaçlarınıza göre esneklik sunduğundan, paywallınızın içeriği ve görünümü tamamen size kalmıştır. Remote config aracılığıyla yapılandırılan özel paywallınızı göstermek için remote config’i çekmeye yarayan bir metot sunuyoruz.

Paywall remote config’ini alma ve gösterme

Bir paywall’ın remote config’ini almak için remoteConfig özelliğine erişin ve ihtiyacınız olan değerleri çıkarın.


Adapty.getPaywall(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
    // use the remote config values
}.onError { error ->
    // handle the error
}

Bu noktada, gerekli tüm değerleri aldıktan sonra bunları görsel açıdan çekici bir sayfada render etme ve bir araya getirme zamanı gelmiştir. Tasarımın farklı mobil telefon ekranlarına ve yönlendirmelerine uyum sağladığından, farklı cihazlarda sorunsuz ve kullanıcı dostu bir deneyim sunduğundan emin olun.

Adapty analitiğinin dönüşüm hunileri ve A/B testleri için bilgi toplayabilmesi amacıyla aşağıda açıklandığı şekilde paywall görüntüleme olayını kaydettiğinizden emin olun.

Paywall’ı gösterdikten sonra satın alma akışını kurmaya devam edin. Kullanıcı bir satın alma yaptığında, paywall’ınızdaki ürünle birlikte .makePurchase() metodunu çağırmanız yeterlidir. .makePurchase() metodu hakkında ayrıntılı bilgi için Satın alma yapma bölümüne bakın.

Yedek paywall olarak bir fallback paywall oluşturmanızı öneririz. Bu yedek, internet bağlantısı olmadığında veya önbellekte veri bulunmadığında kullanıcılara gösterilecek ve her koşulda sorunsuz bir deneyim sağlayacaktır.

Paywall görüntüleme olaylarını kaydetme

Adapty, paywall’larınızın performansını ölçmenize yardımcı olur. Satın alma verilerini otomatik olarak toplasak da paywall görüntülemelerini kaydetmek için sizin müdahaleniz gerekir; çünkü bir kullanıcının paywall’ı ne zaman gördüğünü yalnızca siz bilebilirsiniz.

Bir paywall görüntüleme olayını kaydetmek için .logShowPaywall(paywall) metodunu çağırın; bu, huni ve A/B testi metriklerinize yansıyacaktır.

Paywall Builder ile oluşturulan paywall’ları gösteriyorsanız .logShowPaywall(paywall) çağrısı yapmanıza gerek yoktur.

Adapty.logShowPaywall(paywall = paywall)
    .onSuccess {
        // paywall view logged successfully
    }
    .onError { error ->
        // handle the error
    }

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
paywall	zorunlu	Bir `AdaptyPaywall` nesnesi.