Android SDK'da remote config paywalllar için paywall ve ürün çekme

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

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.

Mobil uygulamanızda flow’ları ve ürünleri getirmeye başlamadan önce (genişletmek için tıklayın)

Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.
Adapty Kontrol Paneli’nde bir flow veya paywall oluşturun ve ürünleri ekleyin.
Adapty Kontrol Paneli’nde placement’lar oluşturun ve flow ya da paywall’ınızı placement’a ekleyin.
Mobil uygulamanıza Adapty SDK’yı yükleyin.

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.

Ürün ID’lerini hardcode etmeyin. Hardcode etmeniz gereken tek ID, placement ID’sidir. Flow’lar uzaktan yapılandırıldığından, ürün sayısı ve mevcut teklifler her an değişebilir. Uygulamanız bu değişiklikleri dinamik olarak ele almalıdır; bir flow bugün iki ürün döndürüyorsa ve yarın üç ürün döndürüyorsa, kod değişikliği yapmadan hepsini gösterin.

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
      
    }
});

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
loadTimeout	varsayılan: 5 sn	Bu değer, metodun zaman aşımı süresini sınırlar. Zaman aşımına ulaşıldığında önbellekteki veri veya yerel yedek döndürülür. Nadir durumlarda bu metodun `loadTimeout` içinde belirtilen süreden biraz daha geç zaman aşımına uğrayabileceğini unutmayın; çünkü işlem arka planda farklı isteklerden oluşabilir.
Ü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:

Parametre	Açıklama
Flow	Placement, tanımlayıcılar (`id`, `variationId`), ad, `remoteConfigs` dizisi (yapılandırılmış her yerel ayar için bir giriş) ve `hasViewConfiguration` bayrağını içeren bir `AdaptyFlow` nesnesi. Flow için ürünleri almak üzere `getPaywallProducts(flow)` çağrısını kullanın.

v4’te locale parametresi getFlow’dan getFlowConfiguration’a taşındı (yalnızca AdaptyUI ile render ederken kullanılır). Özel paywalllar için mevcut tüm locale’ler flow.remoteConfigs içinde birlikte döndürülür; kullanıcının cihaz diline veya uygulamanızın ayarına uygun locale’i seçin.

Ü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:

Parametre	Açıklama
Products	`AdaptyPaywallProduct` nesnelerinin listesi: ürün tanımlayıcısı, ürün adı, fiyat, para birimi, abonelik süresi ve diğer çeşitli özellikler.
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.
Özellik	Açıklama
----------------------------	-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Başlık	Ürünün başlığını göstermek için `product.localizedTitle` kullanın. Yerelleştirmenin cihazın yerel ayarına değil, kullanıcının mağazada seçtiği ülkeye göre yapıldığını unutmayın.
Fiyat	Fiyatın yerelleştirilmiş halini göstermek için `product.price.localizedString` kullanın. Bu yerelleştirme cihazın yerel ayarına göre yapılır. Fiyata sayı olarak erişmek için `product.price.amount` özelliğini kullanabilirsiniz; değer yerel para biriminde döner. İlgili para birimi sembolünü almak için `product.price.currencySymbol` kullanın.
Abonelik Dönemi	Dönemi (hafta, ay, yıl vb.) göstermek için `product.subscriptionDetails?.localizedSubscriptionPeriod` kullanın. Bu yerelleştirme cihazın yerel ayarına göre yapılır. Abonelik dönemine programatik olarak erişmek için `product.subscriptionDetails?.subscriptionPeriod` kullanın. Buradan `unit` enum değerine ulaşarak dönem uzunluğunu alabilirsiniz (DAY, WEEK, MONTH, YEAR veya UNKNOWN). `numberOfUnits` değeri ise dönem birimi sayısını verir. Örneğin üç aylık bir abonelik için `unit` özelliğinde `MONTH`, `numberOfUnits` özelliğinde `3` görürsünüz.
Başlangıç Teklifi	Bir aboneliğin başlangıç teklifi içerip içermediğini rozet veya başka bir gösterge ile belirtmek için `product.subscriptionDetails?.introductoryOfferPhases` özelliğine bakın. Bu liste, ücretsiz deneme aşaması ve başlangıç fiyatı aşaması olmak üzere en fazla iki indirim aşaması içerebilir. Her aşama nesnesinde şu kullanışlı özellikler yer alır: • `paymentMode`: `FREE_TRIAL`, `PAY_AS_YOU_GO`, `PAY_UPFRONT` ve `UNKNOWN` değerlerine sahip bir enum. Ücretsiz denemeler `FREE_TRIAL` türünde olur. • `price`: İndirimli fiyatı sayı olarak verir. Ücretsiz denemeler için bu değer `0` olur. • `localizedNumberOfPeriods`: Teklifin uzunluğunu cihazın yerel ayarına göre biçimlendirilmiş bir string olarak gösterir. Örneğin üç günlük bir deneme teklifi bu alanda `3 days` şeklinde görünür. • `subscriptionPeriod`: Teklif döneminin ayrıntılarına tek tek erişmek için bu özelliği kullanabilirsiniz. Abonelikler için açıklanan önceki bölümle aynı şekilde çalışır. • `localizedSubscriptionPeriod`: İndirimin abonelik dönemini kullanıcının yerel ayarına göre biçimlendirilmiş olarak döndürür.

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.

getFlow kullanımını neden öneriyoruz

getFlowForDefaultAudience metodunun birkaç önemli dezavantajı vardır:

Olası geriye dönük uyumluluk sorunları: Farklı uygulama sürümleri için (mevcut ve gelecek) farklı flow’lar göstermeniz gerekiyorsa, zorluklarla karşılaşabilirsiniz. Ya mevcut (eski) sürümü destekleyen flow’lar tasarlamak ya da mevcut (eski) sürüme sahip kullanıcıların render edilemeyen flow’larla sorun yaşabileceğini kabul etmek zorunda kalırsınız.
Hedefleme kaybı: Tüm kullanıcılar All Users kitlesi için tasarlanmış aynı flow’u görecektir; bu da kişiselleştirilmiş hedeflemeyi (ülkelere, marketing attribution’a veya kendi özel niteliklerinize göre hedefleme dahil) kaybetmeniz anlamına gelir. Bu dezavantajları kabul ederek daha hızlı flow getirme işleminden yararlanmak istiyorsanız, getFlowForDefaultAudience metodunu aşağıdaki şekilde kullanın. Aksi takdirde, yukarıda açıklanan getFlow metodunu kullanmaya devam edin.

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
      
    }
});

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.

Remote config ve özel paywallları sergilemeye başlamadan önce, bunlarla ilgili bilgileri getirmeniz gerekiyor. Bu konunun remote config ve özel paywalllar ile ilgili olduğunu unutmayın. Paywall Builder ile özelleştirilmiş paywallları getirme konusunda rehberlik için lütfen Paywall Builder paywalllarını ve yapılandırmalarını getirme sayfasına bakın.

Mobil uygulamanızda paywallları ve ürünleri getirmeye başlamadan önce (genişletmek için tıklayın)

Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.
Bir paywall oluşturun ve ürünlerinizi paywall’unuza ekleyin Adapty Kontrol Paneli’nde.
Placement’lar oluşturun ve paywall’unuzu placement’a ekleyin Adapty Kontrol Paneli’nde.
Adapty SDK’yı yükleyin mobil uygulamanıza.

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.

Ürün ID’lerini doğrudan koda yazmayın. Doğrudan yazmanız gereken tek ID, placement ID’sidir. Paywall’lar uzaktan yapılandırıldığından, ürün sayısı ve mevcut teklifler her an değişebilir. Uygulamanız bu değişiklikleri dinamik olarak ele almalıdır; bir paywall bugün iki ürün döndürüyorsa ve yarın üç ürün döndürüyorsa, kod değişikliği yapmadan hepsini gösterin.

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
      
    }
});

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
locale	isteğe bağlı varsayılan: `en`	Paywall yerelleştirmesinin tanımlayıcısı. Bu parametre, eksi (-) karakteriyle ayrılmış bir veya daha fazla alt etiket içeren bir dil kodu olmalıdır. İlk alt etiket dil, ikincisi ise bölge içindir. Örnek: `en` İngilizce, `pt-br` ise Brezilya Portekizcesini temsil eder. Yerel ayar kodları ve bunların nasıl kullanılması gerektiği hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları sayfasına bakın.
fetchPolicy	varsayılan: `.reloadRevalidatingCacheData`	SDK varsayılan olarak sunucudan veri yüklemeye çalışır; başarısız olursa önbelleğe alınmış veriyi döndürür. Kullanıcılarınızın her zaman en güncel verilere erişmesini sağladığından bu seçeneği öneriyoruz. Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla çalıştığını düşünüyorsanız, önbellekte veri varsa önbellekten döndürmek için `.returnCacheDataElseLoad` kullanmayı değerlendirin. Bu senaryoda kullanıcılar en güncel verilere ulaşamayabilir; ancak internet bağlantısı ne kadar zayıf olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir; bu nedenle oturum sırasında ağ isteklerini azaltmak amacıyla güvenle kullanılabilir. Önbelleğin uygulama yeniden başlatıldığında silinmediğini; yalnızca uygulama kaldırıldığında veya manuel temizlik yapıldığında temizlendiğini unutmayın. Adapty SDK, paywall’ları iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Paywall’ların daha hızlı getirilmesi için CDN, CDN’e erişilemeyen durumlarda ise bağımsız bir yedek sunucu kullanıyoruz. Bu sistem, internet bağlantısının yetersiz olduğu durumlarda bile güvenilirliği sağlarken her zaman en güncel paywall sürümünü almanızı garanti edecek şekilde tasarlanmıştır.
loadTimeout	varsayılan: 5 sn	Bu değer, metodun zaman aşımı süresini sınırlar. Zaman aşımına ulaşıldığında önbelleğe alınmış veri veya yerel yedek döndürülür. Nadir durumlarda bu metodun `loadTimeout` içinde belirtilen süreden biraz daha geç zaman aşımına uğrayabileceğini unutmayın; çünkü işlem arka planda farklı isteklerden oluşuyor olabilir.
Ü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:

Parametre	Açıklama
Paywall	Ürün kimliklerinin listesi, paywall tanımlayıcısı, remote config ve diğer çeşitli özellikleri içeren bir `AdaptyPaywall` nesnesi.

Ü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:

Parametre	Açıklama
Products	`AdaptyPaywallProduct` nesnelerinin listesi; ürün tanımlayıcısı, ürün adı, fiyat, para birimi, abonelik süresi ve diğer çeşitli özellikleri içerir.
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.
Özellik	Açıklama
------------------------	-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Başlık	Ürünün başlığını göstermek için `product.localizedTitle` kullanın. Yerelleştirmenin, cihazın dil ayarına değil, kullanıcının seçtiği mağaza ülkesine göre yapıldığını unutmayın.
Fiyat	Fiyatın yerelleştirilmiş halini göstermek için `product.price.localizedString` kullanın. Bu yerelleştirme cihazın dil bilgisine göre yapılır. Fiyata sayısal olarak erişmek için `product.price.amount` kullanabilirsiniz; değer yerel para birimi cinsinden döner. İlgili para birimi sembolünü almak için `product.price.currencySymbol` kullanın.
Abonelik Dönemi	Dönemi (hafta, ay, yıl vb.) göstermek için `product.subscriptionDetails?.localizedSubscriptionPeriod` kullanın. Bu yerelleştirme cihazın dil ayarına göre yapılır. Abonelik dönemine programatik olarak erişmek için `product.subscriptionDetails?.subscriptionPeriod` kullanın. Buradan `unit` enum’una erişerek süreyi (DAY, WEEK, MONTH, YEAR veya UNKNOWN) alabilirsiniz. `numberOfUnits` değeri ise dönem birimlerinin sayısını verir. Örneğin üç aylık bir abonelikte `unit` özelliğinde `MONTH`, `numberOfUnits` özelliğinde ise `3` görürsünüz.
Başlangıç Teklifi	Bir aboneliğin başlangıç teklifi içerip içermediğini göstermek için `product.subscriptionDetails?.introductoryOfferPhases` özelliğine bakın. Bu liste, ücretsiz deneme aşaması ve başlangıç fiyatı aşaması olmak üzere en fazla iki indirim aşaması içerebilir. Her aşama nesnesinde şu yararlı özellikler yer alır: • `paymentMode`: `FREE_TRIAL`, `PAY_AS_YOU_GO`, `PAY_UPFRONT` ve `UNKNOWN` değerlerine sahip bir enum. Ücretsiz denemeler `FREE_TRIAL` türünde olur. • `price`: İndirimli fiyatın sayısal değeri. Ücretsiz denemelerde bu değer `0` olur. • `localizedNumberOfPeriods`: Cihazın dil ayarına göre yerelleştirilmiş, teklifin süresini açıklayan bir metin. Örneğin üç günlük bir deneme teklifi bu alanda `3 days` olarak gösterilir. • `subscriptionPeriod`: Teklif döneminin ayrıntılı bilgisini almak için bu özelliği kullanabilirsiniz; önceki bölümde abonelikler için açıklanan şekilde çalışır. • `localizedSubscriptionPeriod`: Kullanıcının dil ayarına göre biçimlendirilmiş, indirim için abonelik dönemi metni.

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.

Neden getPaywall kullanmanızı öneriyoruz

getPaywallForDefaultAudience metodunun birkaç önemli dezavantajı vardır:

Olası geriye dönük uyumluluk sorunları: Farklı uygulama sürümleri (mevcut ve gelecekteki) için farklı paywall’lar göstermeniz gerekirse zorluklarla karşılaşabilirsiniz. Ya mevcut (eski) sürümü destekleyen paywall’lar tasarlamanız ya da mevcut (eski) sürüme sahip kullanıcıların render edilemeyen paywall’larla sorun yaşamasını kabul etmeniz gerekecektir.
Hedefleme kaybı: Tüm kullanıcılar All Users kitlesi için tasarlanmış aynı paywall’ı görür; bu da ülkelere, pazarlama attribution’ına veya kendi özel özelliklerinize dayalı kişiselleştirilmiş hedeflemeyi kaybetmeniz anlamına gelir. Bu dezavantajları kabul edip daha hızlı paywall yükleme avantajından faydalanmak istiyorsanız, getPaywallForDefaultAudience yöntemini aşağıdaki şekilde kullanın. Aksi takdirde, yukarıda açıklanan getPaywall yöntemini kullanmaya devam edin.

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
      
    }
});

getPaywallForDefaultAudience metodu Android SDK 2.11.3 sürümünden itibaren kullanılabilir.

Parametre Zorunluluk Açıklama

placementId zorunlu Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirlediğiniz değerdir.

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirlediğiniz değerdir.
locale	isteğe bağlı varsayılan: `en`	Paywall yerelleştirmesinin tanımlayıcısı. Bu parametre, eksi (-) karakteriyle ayrılmış bir veya daha fazla alt etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dili, ikincisi ise bölgeyi belirtir. Örnek: `en` İngilizce, `pt-br` ise Brezilya Portekizcesini temsil eder. Yerel ayar kodları ve kullanım önerilerimiz hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları bölümüne bakın.
fetchPolicy	varsayılan: `.reloadRevalidatingCacheData`	SDK varsayılan olarak sunucudan veri yüklemeye çalışır; başarısız olursa önbelleğe alınmış veriyi döndürür. Kullanıcılarınızın her zaman en güncel verilere ulaşmasını sağladığı için bu seçeneği öneriyoruz. Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla çalıştığını düşünüyorsanız, önbellekte veri varsa onu döndürmek için `.returnCacheDataElseLoad` seçeneğini kullanabilirsiniz. Bu durumda kullanıcılar her zaman en güncel veriye ulaşamayabilir; ancak internet bağlantısından bağımsız olarak daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle oturum sırasında gereksiz ağ isteklerinden kaçınmak için güvenle kullanılabilir. Önbelleğin, uygulama yeniden başlatıldığında korunduğunu; yalnızca uygulama yeniden yüklendiğinde veya manuel temizleme yapıldığında sıfırlandığını unutmayın.

locale

isteğe bağlı

varsayılan: en

Paywall yerelleştirmesinin tanımlayıcısı. Bu parametre, eksi (-) karakteriyle ayrılmış bir veya daha fazla alt etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dili, ikincisi ise bölgeyi belirtir.

Örnek: en İngilizce, pt-br ise Brezilya Portekizcesini temsil eder.

Yerel ayar kodları ve kullanım önerilerimiz hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları bölümüne bakın.

fetchPolicy

varsayılan: .reloadRevalidatingCacheData

SDK varsayılan olarak sunucudan veri yüklemeye çalışır; başarısız olursa önbelleğe alınmış veriyi döndürür. Kullanıcılarınızın her zaman en güncel verilere ulaşmasını sağladığı için bu seçeneği öneriyoruz.

Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla çalıştığını düşünüyorsanız, önbellekte veri varsa onu döndürmek için .returnCacheDataElseLoad seçeneğini kullanabilirsiniz. Bu durumda kullanıcılar her zaman en güncel veriye ulaşamayabilir; ancak internet bağlantısından bağımsız olarak daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle oturum sırasında gereksiz ağ isteklerinden kaçınmak için güvenle kullanılabilir.

Önbelleğin, uygulama yeniden başlatıldığında korunduğunu; yalnızca uygulama yeniden yüklendiğinde veya manuel temizleme yapıldığında sıfırlandığını unutmayın.