Android SDK'da remote config ile tasarlanan paywallı render etme

Remote config ile bir paywall özelleştirdiyseniz, kullanıcılara göstermek için mobil uygulama kodunuzda render işlemini kendiniz uygulamanız gerekir. Remote config, ihtiyaçlarınıza göre esneklik sunduğundan, paywall görünümünüzde nelerin yer alacağını ve nasıl görüneceğini siz belirlersiniz. Adapty, remote config’i çekmeniz için bir metot sağlar; özel paywallınızı nasıl göstereceğiniz tamamen size kalmıştır.

Flow remote config’i alın ve sunun

v4’te bir flow, remoteConfigs dizisindeki yapılandırılmış her locale için bir AdaptyRemoteConfig girdisi taşır. Kullanıcının tercihiyle eşleşen locale’i seçin, ardından ihtiyacınız olan değerleri okuyun.

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
                ?: flow.remoteConfigs.firstOrNull()
            val headerText = config?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();

        AdaptyRemoteConfig config = null;
        for (AdaptyRemoteConfig remoteConfig : flow.getRemoteConfigs()) {
            if ("en".equals(remoteConfig.getLocale())) {
                config = remoteConfig;
                break;
            }
        }
        if (config == null && !flow.getRemoteConfigs().isEmpty()) {
            config = flow.getRemoteConfigs().get(0);
        }

        if (config != null && config.getDataMap().get("header_text") instanceof String) {
            String headerText = (String) config.getDataMap().get("header_text");
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // 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 ekranlarını ve yönlerini desteklediğinden emin olun; böylece farklı cihazlarda sorunsuz ve kullanıcı dostu bir deneyim sunabilirsiniz.

Adapty analitiğinin huni ve A/B testleri için bilgi toplayabilmesi amacıyla, aşağıda açıklandığı şekilde paywall görüntüleme etkinliğini kaydedin.

Paywallı görüntüledikten sonra satın alma akışını 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 ayrıntılı bilgi için Satın alma yapma bölümünü okuyun.

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

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

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

Bir görüntüleme olayı kaydetmek için .logShowFlow(flow) metodunu çağırmanız yeterlidir; bu olay, dönüşüm hunileri ve A/B testlerindeki metriklerinize yansıyacaktır.

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

Adapty.logShowFlow(flow)

İstek parametreleri:

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

Remote config kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcılara göstermek için mobil uygulamanızın koduna render işlemini eklemeniz gerekir. Remote config, ihtiyaçlarınıza göre şekillendirilmiş bir esneklik sunduğundan, paywall görünümünüzde nelerin yer alacağını ve nasıl görüneceğini tamamen siz belirlersiniz. Remote config aracılığıyla yapılandırdığınız özel paywall’ı göstermek için remote configuration’ı çeken bir metot sunuyoruz.

Paywall remote config’ini alın ve gösterin

Bir paywallın remote config’ini almak için remoteConfig özelliğine erişin ve gerekli değerleri oradan çekin.

Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        
        AdaptyPaywall.RemoteConfig remoteConfig = paywall.getRemoteConfig();
        
        if (remoteConfig != null) {
            if (remoteConfig.getDataMap().get("header_text") instanceof String) {
                String headerText = (String) remoteConfig.getDataMap().get("header_text");
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

Gerekli tüm değerleri aldıktan sonra, bunları görsel açıdan çekici bir sayfaya dönüştürme zamanı gelmiştir. Tasarımın farklı ekran boyutlarına ve yönlendirmelerine uyum sağladığından emin olun; böylece kullanıcılara her cihazda sorunsuz ve kullanışlı bir deneyim sunabilirsiniz.

Aşağıda açıklandığı gibi paywall görüntüleme olayını kaydettiğinizden emin olun; bu sayede Adapty analitiği huni ve A/B testi veilerini doğru şekilde toplayabilir.

Paywallı gösterdikten sonra satın alma akışını kurarak 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ünü inceleyin.

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

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

Adapty, paywalllarınızın performansını ölçmenize yardımcı olur. Satın almaları otomatik olarak takip etsek de, paywall görüntülemelerini kaydetmek için sizin müdahaleniz gerekir; çünkü bir müşterinin paywallı ne zaman gördüğünü yalnızca siz bilebilirsiniz.

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

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

Adapty.logShowPaywall(paywall)

İstek parametreleri:

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