Android SDK'da remote config paywalllar için paywallları ve ürünleri getirme

Remote config ve özel paywall’lar hakkındaki bilgileri göstermeden önce, bunlara ilişkin bilgileri çekmeniz gerekir. Bu konunun remote config ve özel paywall’larla ilgili olduğunu unutmayın. Flow & Paywall Builder veya old Paywall Builder ile özelleştirilmiş flow’ları veya paywall’ları çekme konusunda rehberlik için lütfen Flow ve paywall’ları alın sayfasına bakın.

Flow bilgilerini getirme

Adapty’de bir ürün, hem App Store hem de Google Play’den gelen ürünlerin bir kombinasyonudur. Bu platformlar arası ürünler, flow’lara ve paywall’lara entegre edilerek belirli mobil uygulama placement’larında sergilenebilir.

Ürünleri göstermek için getFlow metoduyla placement’larınızdan birinden bir AdaptyFlow almanız gerekir.

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            // istenen flow
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // hatayı işle
        }
    }
}

Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
        // istenen flow
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // hatayı işle
      
    }
});

Ürün ID’lerini kodunuza sabit olarak yazmayın! Flow’lar uzaktan yapılandırıldığından, mevcut ürünler, ürün sayısı ve özel teklifler (ücretsiz deneme süresi gibi) zaman içinde değişebilir. Kodunuzun bu senaryoları ele aldığından emin olun. Örneğin, başlangıçta 2 ürün alıyorsanız uygulamanız bu 2 ürünü göstermelidir. Ancak daha sonra 3 ürün alırsanız, herhangi bir kod değişikliği gerektirmeden uygulamanız 3 ürünü de göstermelidir. Kodunuza sabit olarak yazmanız gereken tek şey placement ID’sidir.

Yanıt parametreleri:

Ürünleri getir

Flow’a sahip olduktan sonra, o flow’a karşılık gelen ürün dizisini sorgulayabilirsiniz:

Adapty.getPaywallProducts(flow) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val products = result.value
            // the requested products
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywallProducts(flow, result -> {
    if (result instanceof AdaptyResult.Success) {
        List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) result).getValue();
        // istenen ürünler
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // hatayı işle
      
    }
});

Yanıt parametreleri:

Kendi flow tasarımınızı uygularken, AdaptyPaywallProduct nesnesindeki bu özelliklere erişmeniz muhtemelen gerekecektir. Aşağıda en sık kullanılan özellikler gösterilmektedir; mevcut tüm özellikler hakkında ayrıntılı bilgi için bağlantılı dokümana bakın.

Varsayılan kitle flow’u ile flow getirmeyi hızlandırın

Genellikle flow’lar neredeyse anında getirilir, bu yüzden bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitle ve placement’ınız olduğunda ve kullanıcılarınızın internet bağlantısı zayıf olduğunda, bir flow’un getirilmesi istediğinizden daha uzun sürebilir. Böyle durumlarda, hiçbir şey göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir flow görüntülemek isteyebilirsiniz.

Bunu çözmek için, belirtilen placement’ın All Users kitlesi için flow’unu getiren getFlowForDefaultAudience metodunu kullanabilirsiniz. Ancak şunu anlamak kritik önem taşır: önerilen yaklaşım, yukarıdaki Flow bilgisini getirme bölümünde ayrıntılandırıldığı gibi getFlow metoduyla flow’u getirmektir.

Adapty.getFlowForDefaultAudience("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            // the requested flow
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getFlowForDefaultAudience("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
        // istenen flow
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // hatayı işle
      
    }
});

Remote config ve özel paywallları tanıtmadan önce, bunlarla ilgili bilgileri almanız gerekir. Bu konunun remote config ve özel paywalllarla ilgili olduğunu lütfen unutmayın. Paywall Builder ile özelleştirilmiş paywallların getirilmesi için rehber olarak Paywall Builder paywalllarını ve yapılandırmalarını getirme konusuna bakabilirsiniz.

Paywall bilgilerini getirme

Adapty’de bir ürün, hem App Store hem de Google Play’den gelen ürünlerin bir kombinasyonunu temsil eder. Bu platformlar arası ürünler, belirli mobil uygulama placement’larında sergilenebilmesi için paywall’lara entegre edilir.

Ürünleri gösterebilmek için getPaywall metoduyla placement’larınızdan birinden bir Paywall almanız gerekir.

Adapty.getPaywall("YOUR_PLACEMENT_ID", locale = "en") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            // istenen paywall
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // hatayı işle
        }
    }
}

Adapty.getPaywall("YOUR_PLACEMENT_ID", "en", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        // istenen paywall
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // hatayı işle
      
    }
});

Ürün ID’lerini hardcode etmeyin! Paywall’lar uzaktan yapılandırıldığından, mevcut ürünler, ürün sayısı ve özel teklifler (ücretsiz deneme gibi) zamanla değişebilir. Kodunuzun bu senaryoları ele aldığından emin olun.

Örneğin, başlangıçta 2 ürün alıyorsanız uygulamanız o 2 ürünü göstermelidir. Ancak daha sonra 3 ürün alırsanız, herhangi bir kod değişikliği gerektirmeden uygulamanız 3 ürünü de göstermelidir. Hardcode etmeniz gereken tek şey placement ID’sidir.

Yanıt parametreleri:

Ürünleri getir

Paywall’a sahip olduktan sonra, buna karşılık gelen ürün dizisini sorgulayabilirsiniz:

Adapty.getPaywallProducts(paywall) { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val products = result.value
            // the requested products
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywallProducts(paywall, result -> {
    if (result instanceof AdaptyResult.Success) {
        List<AdaptyPaywallProduct> products = ((AdaptyResult.Success<List<AdaptyPaywallProduct>>) result).getValue();
        // istenen ürünler
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // hatayı işle
      
    }
});

Yanıt parametreleri:

Kendi paywall tasarımınızı uygularken, büyük ihtimalle AdaptyPaywallProduct nesnesindeki bu özelliklere ihtiyaç duyacaksınız. Aşağıda en sık kullanılan özellikler gösterilmektedir; mevcut tüm özellikler hakkında ayrıntılı bilgi için bağlantılı belgeye bakın.

Varsayılan kitle paywallı ile paywall getirmeyi hızlandırın

Genellikle paywalllar neredeyse anında getirilir, bu yüzden bu süreci hızlandırmak için endişelenmenize gerek yoktur. Ancak çok sayıda kitle ve paywalliniz varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, paywall getirme işlemi istediğinizden daha uzun sürebilir. Bu gibi durumlarda, hiç paywall göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir paywall görüntülemek isteyebilirsiniz.

Bunu çözmek için, belirtilen placement’ın All Users kitlesi için paywall’ı çeken getPaywallForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın yukarıdaki Paywall Bilgisini Çekme bölümünde açıklandığı gibi getPaywall metoduyla paywall’ı çekmek olduğunu anlamanız kritik önem taşır.

Adapty.getPaywallForDefaultAudience("YOUR_PLACEMENT_ID", locale = "en") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            // istenen paywall
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // hatayı işle
        }
    }
}

Adapty.getPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        // the requested paywall
      
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
      
    }
});