Unity SDK'da özel paywall'ları ve ürünleri çekme

Özel paywallları göstermeden önce bunlara ilişkin bilgileri çekmeniz gerekir. Bu konunun özel paywalllarla ilgili olduğunu unutmayın. Flow & Paywall Builder veya old Paywall Builder ile özelleştirilen flow’ları ya da paywallları çekme konusunda rehberlik için lütfen Flow’ları ve paywallları alma bölümüne bakın.

Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Mobil uygulamanızda flow ve ürünleri getirmeye başlamadan önce (genişletmek için tıklayın)
  1. Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.

  2. Adapty Kontrol Paneli’nde bir flow veya paywall oluşturun ve ürünleri ekleyin.

  3. Adapty Kontrol Paneli’nde placement’lar oluşturun ve flow veya paywall’ınızı placement’a ekleyin.

  4. 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 birleşimini temsil eder. Bu çapraz platform ürünler, flow’lara ve paywall’lara entegre edilerek belirli mobil uygulama placement’larında gösterilmenizi sağlar.

Ürünleri görüntülemek için GetFlow metoduyla placement’larınızdan birinden bir AdaptyFlow nesnesi almanız gerekir.

Important

Ü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östermelisiniz.

Adapty.GetFlow(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    TimeSpan.FromSeconds(5),
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow
    }
);
ParametreZorunlulukAçıklama
placementIdzorunluPlacement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
fetchPolicyvarsayılan: AdaptyPlacementFetchPolicy.Default

fetchPolicy, SDK’nın önce hangi katmanı okuyacağını belirler; önbelleği kullanıp kullanamayacağını değil. Varsayılan olarak SDK önce sunucuya gider ve bu istek 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 veriyi alması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 uğraştığını düşünüyorsanız, bu sırayı tersine çeviren AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad seçeneğini değerlendirin; önce önbelleği okur ve yalnızca önbellekte hiçbir şey yoksa sunucuya gider. Kullanıcılar mutlak en güncel veriyi alamayabilir, ancak internet bağlantıları ne kadar kesintili olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, dolayısıyla ağ isteklerinden kaçınmak için oturum sırasında kullanmak güvenlidir.

Üçüncü bir politika olan AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), ikisi arasında bir yerde durur: önbelleğe alınmış kopya, ilettiğiniz TimeSpan değerinden daha yeni olduğu sürece önce önbelleği okur ve daha eski olduğunda sunucuya gider.

Önbelleğin uygulama yeniden başlatıldığında silinmediğini, yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yapıldığında temizlendiğini unutmayın.

Adapty SDK, flow’ları ve paywall’ları iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Ayrıca flow’ları ve paywall’ları daha hızlı getirmek için CDN kullanıyoruz ve CDN’e ulaşılamadığı durumlarda bağımsız bir yedek sunucu bulunuyor. Bu sistem, internet bağlantısının yetersiz olduğu durumlarda bile güvenilirliği sağlarken her zaman flow’larınızın ve paywall’larınızın en güncel sürümünü almanızı garanti edecek şekilde tasarlanmıştır.

loadTimeoutvarsayılan: 5 sn

Bu değer, söz konusu yöntem için zaman aşımı süresini sınırlar. Adapty sunucusu zamanında yanıt vermezse veya hata döndürürse SDK, önbelleğe alınmış flow’u döndürür. Önbellekte hiçbir şey yoksa ve sunucu zaman aşımına uğradıysa ya da sunucu hatası döndürdüyse SDK, flow’u yedek sunucudan ister (yalnızca placement’ın All Users kitlesine hizmet eden bir CDN kopyası). Son çare olarak SDK, flow’u yedek dosyanızdan döndürür.

İşlem arka planda farklı isteklerden oluşabileceğinden, bu yöntemin nadir durumlarda loadTimeout içinde belirtilenden biraz daha geç zaman aşımına uğrayabileceğini unutmayın.

Tip

Bu önbelleği kullanıcı flow’a ihtiyaç duymadan önce doldurmak için birkaç placement için aynı anda Adapty.PreloadFlows (Unity SDK 4.3.0+) çağırın. Ön yüklenmiş kopyayı ağ bağlantısından önce okumak için AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad parametresini kullanın.

Ürün ID’lerini hardcode etmeyin! Flow’lar uzaktan yapılandırıldığından, mevcut ürünler, ürün sayısı ve özel teklifler (ücretsiz denemeler 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ün tamamını göstermelidir. Hardcode etmeniz gereken tek şey placement ID’dir.

Yanıt parametreleri:

ParametreAçıklama
FlowŞu özelliklere sahip bir AdaptyFlow nesnesi: flow tanımlayıcısı, paywall varyasyonları (Paywalls — her biri kendi ürün tanımlayıcılarına sahip), yapılandırılmış her yerel ayar için bir giriş içeren RemoteConfigs listesi ve çeşitli diğer özellikler. Flow için ürünleri çekmek üzere GetPaywallProducts(flow) çağrısını kullanın.
Note

v4’te GetFlow’un locale parametresi yoktur. CreateFlowView ile bir flow render ettiğinizde yerelleştirme otomatik olarak çözümlenir. Özel paywalllar için mevcut tüm locale’ler flow.RemoteConfigs içinde birlikte döner — kullanıcının cihazına veya uygulamanızın ayarına uyan locale’i seçin. Ayrıntılar için bkz. Yerelleştirmeler ve locale kodları.

Ürünleri getir

Flow’u aldıktan sonra, flow’a karşılık gelen ürün dizisini sorgulayabilirsiniz:

Adapty.GetPaywallProducts(flow, (products, error) => {
    if (error != null) {
        // handle the error
        return;
    }

    // products - the requested products array
});

Yanıt parametreleri:

ParametreAçıklama
ProductsŞu bilgileri içeren 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, büyük olasılıkla AdaptyPaywallProduct nesnesinden bu özelliklere erişmeniz gerekecektir. Aşağıda en sık kullanılan özellikler gösterilmektedir.

ÖzellikAçıklama
BaşlıkÜrünün başlığını göstermek için product.LocalizedTitle kullanın. Yerelleştirme, cihazın yerel ayarına değil kullanıcının seçtiği mağaza ülkesine göre yapılır.
FiyatFiyatın yerelleştirilmiş sürümünü göstermek için product.Price.LocalizedString kullanın. Bu yerelleştirme cihazın yerel ayar bilgisine göre yapılır. Fiyata sayı olarak erişmek için product.Price.Amount kullanabilirsiniz; değer yerel para birimiyle döner. İlgili para birimi sembolünü almak için product.Price.CurrencySymbol kullanın.
Abonelik DönemiDönemi (örn. hafta, ay, yıl vb.) göstermek için product.Subscription?.LocalizedPeriod 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.Subscription?.Period kullanın. Buradan Unit enum’una erişerek uzunluğu öğrenebilirsiniz (AdaptySubscriptionPeriodUnit.Day, AdaptySubscriptionPeriodUnit.Week, AdaptySubscriptionPeriodUnit.Month, AdaptySubscriptionPeriodUnit.Year veya AdaptySubscriptionPeriodUnit.Unknown). NumberOfUnits değeri, dönem birimi sayısını verir. Örneğin üç aylık bir abonelik için Unit özelliğinde AdaptySubscriptionPeriodUnit.Month, NumberOfUnits özelliğinde ise 3 görürsünüz.
Fatura planıYalnızca iOS. 12 aylık taahhütlü bir ürün için Apple’ın gerektirdiği iki fiyatı göstermek amacıyla product.Subscription?.PricingTerms kullanın: aylık taksit için BillingPrice.LocalizedString ve BillingPeriod; yıllık toplam için CommitmentInfo.Price.LocalizedString ve CommitmentInfo.Period. Taahhüt planı için BillingPlan değeri AdaptySubscriptionBillingPlan.Monthly, diğer durumlarda ise AdaptySubscriptionBillingPlan.UpFront olur. Taahhüt planında product.Price ve product.Subscription?.Period, taksiti değil yıllık toplam tutarı ve dönemi döndürür. Android’de PricingTerms değeri null’dur. Adapty SDK 4.3.0 veya üstü gerektirir.
Başlangıç TeklifiBir aboneliğin başlangıç teklifi içerip içermediğini gösteren bir rozet veya başka bir gösterge eklemek için product.Subscription?.Offer?.Phases ö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: AdaptyPaymentMode.FreeTrial, AdaptyPaymentMode.PayAsYouGo, AdaptyPaymentMode.PayUpFront ve AdaptyPaymentMode.Unknown değerlerine sahip bir enum. Ücretsiz denemeler AdaptyPaymentMode.FreeTrial türünde olur.
• Price: İndirimli fiyatı içeren bir AdaptyPrice nesnesi — sayı değeri için Price.Amount, görüntülemek için Price.LocalizedString kullanın. Ücretsiz denemeler için Price.Amount alanında 0 değerini arayın.
• LocalizedNumberOfPeriods: Teklifin uzunluğunu cihazın yerel ayarına göre yerelleştirilmiş bir dize olarak döndürür. Örneğin üç günlük bir deneme teklifi bu alanda "3 days" gösterir.
• SubscriptionPeriod: Alternatif olarak bu özellik ile teklif döneminin ayrıntılarına tek tek erişebilirsiniz. Teklifler için önceki bölümde açıklanan yöntemle aynı şekilde çalışır.
• LocalizedSubscriptionPeriod: Kullanıcının yerel ayarına göre biçimlendirilmiş indirim abonelik dönemi.

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ırmak için endişelenmenize gerek yoktur. Ancak çok sayıda kitleniz ve placement’ınız varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, 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 amacıyla varsayılan bir flow göstermek isteyebilirsiniz.

Bunu ele almak için, belirtilen placement’ın All Users kitlesi için flow’unu getiren GetFlowForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın yukarıdaki Flow bilgisini getirme bölümünde ayrıntılı olarak açıklandığı gibi GetFlow metoduyla flow’u getirmek olduğunu anlamak kritik öneme sahiptir.

Warning

Neden GetFlow kullanmanızı öneriyoruz

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

  • Olası geriye dönük uyumluluk sorunları: Farklı uygulama sürümleri (mevcut ve gelecekteki) için farklı flow’lar göstermeniz gerekiyorsa, zorluklarla karşılaşabilirsiniz. Ya mevcut (eski) sürümü destekleyen flow’lar tasarlamak zorunda kalırsınız ya da mevcut (eski) sürüme sahip kullanıcıların render edilemeyen flow’larla sorun yaşayabileceğini kabul etmek durumunda olursunuz.
  • Hedeflemenin kaybı: Tüm kullanıcılar All Users kitlesi için tasarlanmış aynı flow’u görür; bu da ülkelere, pazarlama attribution’ına veya kendi özel niteliklerinize dayalı kişiselleştirilmiş hedeflemeyi kaybetmeniz anlamına gelir.

Bu dezavantajları kabul ederek daha hızlı flow çekme işleminden yararlanmak istiyorsanız, GetFlowForDefaultAudience metodunu aşağıdaki gibi kullanın. Aksi takdirde, yukarıda açıklanan GetFlow metodunu kullanmaya devam edin.

Adapty.GetFlowForDefaultAudience(
    "YOUR_PLACEMENT_ID",
    AdaptyPlacementFetchPolicy.Default,
    (flow, error) => {
        if (error != null) {
            // handle the error
            return;
        }

        // flow - the requested flow
    }
);
ParametreZorunlulukAçıklama
placementIdzorunluPlacement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
fetchPolicyvarsayılan: AdaptyPlacementFetchPolicy.Default

fetchPolicy, SDK’nın önbelleği kullanıp kullanamayacağını değil, hangi katmanı önce okuyacağını belirler. Varsayılan olarak SDK önce sunucuya gider ve istek başarısız olursa önbelleğe alınmış veriyi döner. Kullanıcılarınızın her zaman en güncel veriyi alması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 mücadele ettiğini düşünüyorsanız AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad seçeneğini değerlendirebilirsiniz; bu seçenek sırayı tersine çevirir — önce önbelleği okur, önbellekte hiçbir şey yoksa sunucuya gider. Kullanıcılar en güncel veriyi alamayabilir, ancak internet bağlantıları ne kadar kesintili olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerini azaltmak için oturum boyunca kullanmak güvenlidir.

Üçüncü bir politika olan AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), ikisinin arasında yer alır: önbelleğe alınmış kopya, ilettiğiniz TimeSpan değerinden daha yeniyken önbelleği okur; daha eskiyse sunucuya gider.

Önbelleğin uygulama yeniden başlatıldığında silinmediğini, yalnızca uygulama kaldırılıp yeniden yüklendiğinde veya manuel temizlik yapıldığında temizlendiğini unutmayın.

Özel paywallları sergilemeden önce bunlar hakkındaki bilgileri çekmeniz gerekmektedir. Bu konunun özel paywalllara atıfta bulunduğunu lütfen unutmayın. Paywall Builder ile özelleştirilmiş paywallları çekme konusunda rehberlik için Paywall Builder paywalllarını ve yapılandırmalarını çekme sayfasına bakın.

Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

Mobil uygulamanızda paywallları ve ürünleri çekmeye başlamadan önce (genişletmek için tıklayın)
  1. Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.

  2. Adapty Kontrol Paneli’nde bir paywall oluşturun ve ürünleri paywalla ekleyin.

  3. Adapty Kontrol Paneli’nde placement’lar oluşturun ve paywallınızı placement’a ekleyin.

  4. Mobil uygulamanıza Adapty SDK’yı yükleyin.

Paywall bilgilerini çekme

Adapty’de bir ürün, App Store ve Google Play’deki ürünlerin birleşimidir. Bu platformlar arası ürünler paywallara entegre edilerek belirli mobil uygulama placement’larında gösterilmesini sağlar.

Ürünleri görüntülemek için getPaywall metodunu kullanarak placement’larınızdan birinden bir Paywall almanız gerekir.

Important

Ürün ID’lerini koda sabit olarak yazmayın. Koda sabit olarak yazmanız gereken tek ID, placement ID’sidir. Paywalllar 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 işleyebilmelidir — bugün bir paywall iki ürün döndürüyorsa ve yarın üç ürün döndürüyorsa, kod değişikliği gerektirmeden hepsini görüntüleyin.

Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});
ParametreVarlıkAçıklama
placementIdzorunluPlacement 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 parametrenin, eksi (-) karakteriyle ayrılmış bir veya daha fazla alt etiket içeren bir dil kodu olması beklenmektedir. İlk alt etiket dil içindir, ikincisi bölge içindir.

Örnek: en İngilizce anlamına gelir, pt-br 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ı bölümüne bakın.

fetchPolicyvarsayılan: AdaptyPlacementFetchPolicy.Default

fetchPolicy, SDK’nın önbelleği kullanıp kullanamayacağını değil, hangi katmanı önce okuyacağını belirler. Varsayılan olarak SDK önce sunucuya gider ve bu istek başarısız olursa önbelleğe alınan veriyi döndürür. Kullanıcılarınızın her zaman en güncel verileri almasını sağladığından bu seçeneği öneririz.

Ancak kullanıcılarınızın kararsız internet bağlantısıyla karşılaştığını düşünüyorsanız AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad seçeneğini değerlendirin; bu seçenek sırayı tersine çevirir — önce önbelleği okur ve hiçbir şey önbelleğe alınmamışsa sunucuya gider. Kullanıcılar mutlak olarak en son verilere ulaşamayabilir, ancak internet bağlantısı ne kadar kesintili olursa olsun daha hızlı yükleme süresiyle karşılaşırlar. Önbellek düzenli olarak güncellenmektedir, dolayısıyla ağ isteklerini önlemek amacıyla oturum boyunca güvenle kullanılabilir.

Üçüncü bir politika olan AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), ikisi arasında bir yerde durur: önbelleğe alınan kopya, ilettiğiniz TimeSpan değerinden daha yeni olduğu sürece önbelleği okur; daha eski olduğunda ise sunucuya gider.

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

Adapty SDK, paywallları iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywalllar. Paywallları daha hızlı getirmek için CDN, CDN’e ulaşılamadığı durumlarda ise bağımsız bir yedek sunucu kullanılmaktadır. Bu sistem, internet bağlantısının yetersiz olduğu durumlarda bile güvenilirliği sağlarken her zaman paywalllarınızın en güncel sürümünü almanızı garanti edecek şekilde tasarlanmıştır.

loadTimeoutvarsayılan: 5 sn

Bu değer, söz konusu yöntem için zaman aşımını sınırlar. Adapty sunucusu zamanında yanıt vermezse veya hata döndürürse SDK, paywall’ı yedek sunucudan (yalnızca placement’ın All Users kitlesine hizmet eden bir CDN kopyası), önbellekten veya yedek dosyanızdan döndürür.

Nadir durumlarda bu yöntemin, işlem arka planda farklı isteklerden oluşabileceğinden loadTimeout içinde belirtilenden biraz daha geç zaman aşımına uğrayabileceğini unutmayın.

Ürün ID’lerini koda sabit olarak yazmayın! Paywalllar uzaktan yapılandırıldığından, mevcut ürünler, ürün sayısı ve özel teklifler (ücretsiz denemeler gibi) zamanla değişebilir. Kodunuzun bu senaryoları işlediğinden emin olun.
Örneğin, başlangıçta 2 ürün alırsanız uygulamanız o 2 ürünü görüntülemelidir. Ancak daha sonra 3 ürün alırsanız, uygulamanız herhangi bir kod değişikliği gerektirmeden 3 ürünün tamamını görüntülemelidir. Koda sabit olarak yazmanız gereken tek şey placement ID’sidir.

Yanıt parametreleri:

ParametreAçıklama
PaywallÜrün ID’leri listesi, paywall tanımlayıcısı, remote config ve diğer çeşitli özelliklerle birlikte bir AdaptyPaywall nesnesi.

Ürünleri çekme

Paywallı aldıktan sonra, ona karşılık gelen ürün dizisini sorgulayabilirsiniz:

Adapty.GetPaywallProducts(paywall, (products, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // products - the requested products array
});

Yanıt parametreleri:

ParametreAçıklama
ProductsÜrün tanımlayıcısı, ürün adı, fiyat, para birimi, abonelik süresi ve diğer çeşitli özelliklerle birlikte AdaptyPaywallProduct nesnelerinin listesi.

Kendi paywall tasarımınızı uygularken, AdaptyPaywallProduct nesnesindeki bu özelliklere erişmeniz gerekecektir. Aşağıda en sık kullanılan özellikler gösterilmektedir; ancak mevcut tüm özelliklere ilişkin tam ayrıntılar için bağlantılı belgeye başvurun.

ÖzellikAçıklama
TitleÜ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 seçtiği mağaza ülkesine göre yapıldığını unutmayın.
PriceFiyatın yerelleştirilmiş halini göstermek için product.Price.LocalizedString kullanın. Bu yerelleştirme, cihazın yerel ayar bilgisine dayanır. Fiyata sayı olarak da erişmek için product.Price.Amount kullanabilirsiniz. Değer, yerel para birimi cinsinden sağlanacaktır. İlgili para birimi sembolünü almak için product.Price.CurrencySymbol kullanın.
Subscription PeriodPeriyodu (örn. hafta, ay, yıl vb.) göstermek için product.Subscription?.LocalizedPeriod kullanın. Bu yerelleştirme, cihazın yerel ayarına dayanır. Abonelik periyodunu programatik olarak almak için product.Subscription?.Period kullanın. Buradan uzunluğu elde etmek üzere Unit enum’una erişebilirsiniz (yani AdaptySubscriptionPeriodUnit.Day, AdaptySubscriptionPeriodUnit.Week, AdaptySubscriptionPeriodUnit.Month, AdaptySubscriptionPeriodUnit.Year veya AdaptySubscriptionPeriodUnit.Unknown). NumberOfUnits değeri, periyot birimi sayısını verir. Örneğin üç aylık bir abonelik için Unit özelliğinde AdaptySubscriptionPeriodUnit.Month, NumberOfUnits özelliğinde ise 3 görürsünüz.
Introductory OfferBir aboneliğin başlangıç teklifi içerdiğini belirten bir rozet veya başka bir gösterge görüntülemek için product.Subscription?.Offer?.Phases özelliğine bakın. Bu, en fazla iki indirim aşaması içerebilen bir listedir: ücretsiz deneme aşaması ve başlangıç fiyatı aşaması. Her aşama nesnesi içinde aşağıdaki faydalı özellikler bulunur:
• PaymentMode: AdaptyPaymentMode.FreeTrial, AdaptyPaymentMode.PayAsYouGo, AdaptyPaymentMode.PayUpFront ve AdaptyPaymentMode.Unknown değerlerine sahip bir enum. Ücretsiz denemeler AdaptyPaymentMode.FreeTrial türünde olacaktır.
• Price: İndirimli fiyatı içeren bir AdaptyPrice nesnesi — sayı için Price.Amount, görüntülemek için Price.LocalizedString kullanın. Ücretsiz denemeler için Price.Amount içinde 0 değerini arayın.
• LocalizedNumberOfPeriods: Teklifin süresini cihazın yerel ayarıyla yerelleştirilmiş biçimde açıklayan bir dize. Örneğin, üç günlük bir deneme teklifi bu alanda "3 days" gösterir.
• SubscriptionPeriod: Alternatif olarak, bu özellikle teklif periyodunun ayrıntılarını tek tek alabilirsiniz. Teklifler için bir önceki bölümde açıklananla aynı şekilde çalışır.
• LocalizedSubscriptionPeriod: Kullanıcının yerel ayarı için biçimlendirilmiş indirim abonelik periyodu.

Varsayılan kitle paywallıyla paywall çekmeyi hızlandırma

Genellikle paywalllar neredeyse anında çekilir, bu nedenle bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitleniz ve paywallınız varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, bir paywallı çekmek 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, belirli bir placement’ın All Users kitlesi için paywallını getiren GetPaywallForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın yukarıdaki Paywall Getir bölümünde ayrıntılı olarak açıklanan getPaywall metoduyla paywallı getirmek olduğunu anlamak çok önemlidir.

Warning

GetPaywallForDefaultAudience yerine GetPaywall kullanmayı tercih edin; ikincisinin önemli kısıtlamaları vardır:

  • Uyumluluk sorunları: Birden fazla uygulama sürümünü desteklerken sorun çıkarabilir; ya geriye dönük uyumlu tasarımlar gerektirir ya da eski sürümlerin hatalı görüntüleneceğini kabul etmeniz gerekir.
  • Kişiselleştirme yok: Yalnızca “Tüm Kullanıcılar” kitlesi için içerik gösterir; ülke, attribution veya özel özniteliklere dayalı hedefleme devre dışı kalır.

Bu dezavantajlara rağmen daha hızlı veri çekme kullanım durumunuz için daha önemliyse, aşağıda gösterildiği gibi GetPaywallForDefaultAudience kullanın. Aksi takdirde, yukarıda açıklanan GetPaywall yöntemini kullanın.

Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
  if(error != null) {
    // handle the error
    return;
  }
  
  // paywall - the resulting object
});

Parametreler:

ParametreZorunlulukAçıklama
placementIdzorunluİstenen Placement tanımlayıcısı. Bu, 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 parametrenin, eksi (-) karakteriyle ayrılmış bir veya iki alt etiketten oluşan bir dil kodu olması beklenir. İlk alt etiket dil, ikincisi ise bölge içindir.

Örnek: en İngilizce anlamına gelir, pt-br Brezilya Portekizcesini temsil eder.

fetchPolicyvarsayılan: AdaptyPlacementFetchPolicy.Default

fetchPolicy, SDK’nın önce hangi katmanı okuyacağını belirler; önbelleği kullanıp kullanamayacağını değil. Varsayılan olarak SDK önce sunucuya gider ve istek başarısız olursa önbelleğe alınmış veriyi döndürür. Bu seçeneği öneriyoruz çünkü kullanıcılarınızın her zaman en güncel verileri almasını sağlar.

Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla karşılaştığını düşünüyorsanız AdaptyPlacementFetchPolicy.ReturnCacheDataElseLoad seçeneğini değerlendirin; bu seçenek sırayı tersine çevirir — önce önbelleği okur ve yalnızca önbellekte hiçbir şey yoksa sunucuya gider. Kullanıcılar en son verileri alamayabilir, ancak internet bağlantıları ne kadar kesintili olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerini önlemek amacıyla oturum sırasında güvenle kullanılabilir.

Üçüncü bir politika olan AdaptyPlacementFetchPolicy.ReturnCacheDataIfNotExpiredElseLoad(maxAge), ikisi arasında yer alır: önbelleğe alınan kopya, geçirdiğiniz TimeSpan değerinden daha yeni olduğu sürece önce önbelleği okur ve bu değerden daha eski olduğunda sunucuya gider.

Önbelleğin, uygulama yeniden başlatıldığında bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yapıldığında silindiğini unutmayın.

Adapty SDK, paywallları yerel olarak iki katmanda saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywalllar. Paywallları daha hızlı getirmek için CDN, CDN’ye ulaşılamadığı durumlarda ise bağımsız bir yedek sunucu kullanırız. Bu sistem, internet bağlantısının yetersiz olduğu durumlarda bile güvenilirliği sağlarken her zaman paywalllarınızın en son sürümünü almanızı garantilemek için tasarlanmıştır.