Flow ve paywallları getir - Unity
GetFlow ile alınanlar flow’unuzu tasarladıktan sonra, onu mobil uygulamanızda görüntüleyebilirsiniz. İlk adım, aşağıda açıklandığı gibi placement ile ilişkilendirilmiş flow veya paywall’ı ve görünüm yapılandırmasını almaktır.
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.
Başlamadan önce
İhtiyacınız olanlar:
- Adapty Kontrol Paneli’nde ürünler: Ürünlerinizi oluşturun.
- Ürünlere sahip bir flow: Flow & Paywall Builder’da oluşturun ve ürünleri atayın.
- Bir placement: Placement oluşturun ve flow’unuzu atayın.
- Adapty SDK kurulu: Unity SDK kurulum kılavuzuna bakın.
Flow/paywall’u getir
Bir flow veya paywall’u builder’da tasarladıysanız, kullanıcıya göstermek için mobil uygulama kodunuzda nasıl render edileceğini düşünmenize gerek yok. Böyle bir flow veya paywall, içinde nelerin gösterileceğini ve nasıl gösterileceğini birlikte barındırır. Yine de placement aracılığıyla ID’sini, görünüm konfigürasyonunu almanız ve ardından mobil uygulamanızda sunmanız gerekir.
En iyi performansı sağlamak için, görsellerin kullanıcıya sunulmadan önce indirilmesine yeterli zaman tanımak amacıyla flow veya paywall ile görünüm yapılandırmasını mümkün olduğunca erken almanız kritik öneme sahiptir.
Birden fazla placement’ı aynı anda ısıtmak için Adapty.PreloadFlows metodunu çağırın (Unity SDK 4.3.0+). Bu yalnızca placement JSON’ını önbelleğe alır, dolayısıyla CreateFlowView yine de düzeni ve görselleri yükler.
Bir flow veya paywall almak için GetFlow metodunu kullanın:
Adapty.GetFlow(
"YOUR_PLACEMENT_ID",
AdaptyPlacementFetchPolicy.Default,
TimeSpan.FromSeconds(5),
(flow, error) => {
if (error != null) {
// handle the error
return;
}
// flow - the requested flow/paywall
}
);Parametreler:
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| placementId | zorunlu | İstenen Placement tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir. |
| fetchPolicy | varsayılan: AdaptyPlacementFetchPolicy.Default |
Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla uğraştığını düşünüyorsanız Üçüncü bir politika olan Önbelleğin uygulama yeniden başlatıldığında bozulmadan kaldığını, yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yapıldığında temizlendiğini unutmayın. Adapty SDK, flow’ları ve paywall’ları yerel olarak iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Ayrıca bunları daha hızlı çekmek için CDN ve CDN’e ulaşılamadığı durumlarda 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 son sürümü almanızı garantilemek için tasarlanmıştır. |
| loadTimeout | varsayılan: 5 sn | Bu değer, söz konusu metodun zaman aşımını sınırlar. Adapty sunucusu zamanında yanıt vermezse veya bir hata döndürürse SDK önbelleğe alınan 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 kitlesini sunan bir CDN kopyası). Son çare olarak SDK, flow’u yedek dosyanızdan döndürür. Nadir durumlarda bu metodun |
Response parametreleri:
| Parametre | Açıklama |
|---|---|
| Flow | Placement, tanımlayıcılar (InstanceIdentity, VariationId), isim, varyant adı (VariationName, SDK 4.3.0+), paywall varyantları (Paywalls — AdaptyFlowPaywall listesi) ve remote config’leri (RemoteConfigs — her locale için bir girdi içeren liste) barındıran bir AdaptyFlow nesnesi. Gerçek ürünleri ön yükleme, özel UI veya programatik kontroller için almak üzere GetPaywallProducts(flow) çağrısını kullanın. |
View yapılandırmasını getirme
Flow veya paywall’ı getirdikten sonra, view yapılandırmasını yükleyin ve CreateFlowView metoduyla view’ı tek adımda oluşturun. Kontrol edilecek ayrı bir bayrak yoktur: placement Flow & Paywall Builder (bir flow) veya old Paywall Builder (bir paywall) ile tasarlanmışsa, CreateFlowView sunuma hazır view’ı döndürür. Placement, Builder arayüzü olmayan özel bir paywall ise CreateFlowView bir hata döndürür — kendiniz render edin.
Flow’u yayınladığınızdan emin olun. Yayınlanmamış düzenlemeleri olan bir flow Dirty statüsünde görünür ve bu flow’un placement’ı en son yayınlanan sürümü sunmaya devam eder.
var parameters = new AdaptyUICreateFlowViewParameters()
.SetPreloadProducts(true)
.SetLoadTimeout(TimeSpan.FromSeconds(5));
AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
if (error != null) {
// the flow has no view configured, or view creation failed
return;
}
// use view
});
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| flow | zorunlu | Adapty.GetFlow aracılığıyla elde edilen bir AdaptyFlow nesnesi. |
| Locale | isteğe bağlı | Flow veya paywallın hangi Builder yerelleştirmesiyle gösterileceğini belirten tanımlayıcı; örneğin en veya pt-br. Bir flow, görünümü oluşturulurken yerelleştirilir; dolayısıyla yerelleştirmeyi seçebileceğiniz tek yer burasıdır. SDK, cihaz dilini okumaz: bu parametreyi atlarsanız flow en dilinde ya da en yerelleştirmesi yoksa varsayılan dilinde görüntülenir. Kod, flow’un yerelleştirme koduyla tam olarak eşleşmelidir. Bkz. Yerelleştirmeleri ve dil kodlarını kullanma. |
| LoadTimeout | isteğe bağlı | Bu değer, metodun zaman aşımı süresini sınırlar. Zaman aşımına ulaşılırsa önbelleğe alınmış veriler veya yerel yedek döndürülür. İşlem arka planda farklı isteklerden oluşabileceğinden, nadir durumlarda bu metod LoadTimeout içinde belirtilenden biraz daha geç zaman aşımına uğrayabilir. |
| PreloadProducts | isteğe bağlı | Daha iyi performans için ürünleri önceden yüklemek amacıyla true olarak ayarlayın. Etkinleştirildiğinde ürünler önceden yüklenir ve flow veya paywallın gösterilmesi için gereken süre kısalır. |
| CustomTags | isteğe bağlı | Flow’un özel etiketleri için uygulamanızın değerleri; her etiketin tam adına göre anahtarlanmış bir sözlükte yer alır. Sözlüğü SetCustomTags metoduna aktarın. Ayrıntılar için bkz. Flow’lara veri aktarma. |
| CustomTimers | isteğe bağlı | Flow’un Geliştirici tanımlı zamanlayıcılarının bitiş tarihleri; Zamanlayıcı kimliklerinden DateTime değerlerine eşlenen bir sözlükte yer alır. Sözlüğü SetCustomTimers metoduna aktarın. Ayrıntılar için bkz. Geliştirici tanımlı zamanlayıcıları ayarlama. |
| ProductPurchaseParameters | isteğe bağlı | Yalnızca Android (iOS’ta yoksayılır). AdaptyProductIdentifier ile AdaptyPurchaseParameters arasında eşleme yapan bir sözlük. Flow veya paywallda yer alan bireysel ürünler için kişiselleştirilmiş teklifler ya da abonelik güncelleme parametreleri gibi satın alma’ya özgü parametreleri yapılandırmak için kullanın. |
| EnableSafeAreaPaddings | isteğe bağlı | Yalnızca Android (iOS’ta yoksayılır). true olduğunda flow görünümü güvenli alan dolgularını uygular. Varsayılan: true. Varsayılan değer çoğu durum için uygundur. |
Birden fazla dil kullanıyorsanız, Builder yerelleştirmesi eklemeyi öğrenin.
Yüklendikten sonra flow veya paywall’ı gösterin.
Varsayılan kitle için bir flow veya paywall alarak daha hızlı yükleme sağlayın
Genellikle flow’lar ve paywall’lar 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 placement’ınız olduğunda ve kullanıcılarınızın internet bağlantısı zayıf olduğunda, bir flow veya paywall getirme işlemi istediğinizden daha uzun sürebilir. Bu tür durumlarda, hiçbir şey göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir flow veya paywall görüntülemek isteyebilirsiniz.
Bunu çözmek için, belirtilen placement’ın All Users kitlesi için flow veya paywall’ı getiren GetFlowForDefaultAudience metodunu kullanabilirsiniz. Ancak önerilen yaklaşımın, yukarıdaki Flow/paywall getirme bölümünde anlatıldığı gibi GetFlow metoduyla flow veya paywall getirmek olduğunu anlamak kritik öneme sahiptir.
Neden GetFlow kullanmanızı öneriyoruz
GetFlowForDefaultAudience metodu birkaç önemli dezavantajla birlikte gelir:
- Olası geriye dönük uyumluluk sorunları: Farklı uygulama sürümleri (mevcut ve gelecek) için farklı flow’lar göstermeniz gerekiyorsa, zorluklarla karşılaşabilirsiniz. Ya mevcut (eski) sürümü destekleyen flow’lar tasarlamanız gerekecek ya da mevcut (eski) sürümdeki kullanıcıların render edilmeyen flow’larla sorun yaşamasını kabul etmeniz gerekecek.
- Hedefleme kaybı: Tüm kullanıcılar All Users kitlesi için tasarlanmış aynı flow’u görecek; 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 veya paywall getirme 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
}
);
| Parametre | Varlık | Açıklama |
|---|---|---|
| placementId | gerekli | Placement tanımlayıcısı. Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir. |
| fetchPolicy | varsayılan: AdaptyPlacementFetchPolicy.Default |
Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla karşılaştığını düşünüyorsanız Üçüncü bir politika olan Önbelleğin uygulama yeniden başlatıldığında bozulmadan kaldığını, yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yoluyla silindiğini unutmayın. |
Varlıkları özelleştirme
Flow veya paywallınızdaki görselleri ve videoları özelleştirmek için özel varlıklar uygulayın.
Hero görseller ve videolar önceden tanımlanmış ID’lere sahiptir: hero_image ve hero_video. Özel bir varlık paketinde, bu öğeleri ID’leriyle hedefler ve davranışlarını özelleştirirsiniz.
Diğer görseller ve videolar için Adapty kontrol panelinde özel bir ID ayarlamanız gerekir.
Örneğin şunları yapabilirsiniz:
- Bazı kullanıcılara farklı bir görüntü veya video gösterin.
- Uzak bir ana görüntü yüklenirken yerel bir önizleme görüntüsü gösterin.
- Bir video çalıştırmadan önce önizleme görüntüsü gösterin.
- Uygulamayla birlikte gelen medyayı gösterin; böylece ilk ekran indirme olmadan render edilir. Bkz. Uygulama paketinden ilk ekran medyasını gösterme.
Özel varlıkları basit bir sözlük aracılığıyla nasıl sağlayabileceğinize dair bir örnek:
var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
{ "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
{ "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};
var parameters = new AdaptyUICreateFlowViewParameters()
.SetCustomAssets(customAssets)
.SetLoadTimeout(TimeSpan.FromSeconds(3));
AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
// handle the result
});Bir varlık bulunamazsa veya yüklenemezse, flow veya paywall Builder’da yapılandırılmış varsayılan görünümüne geri döner.
Geliştirici tanımlı zamanlayıcıları ayarlayın
Bu bölümü, Flow & Paywall Builder’daki Developer defined davranışına sahip bir zamanlayıcı için kullanın. Builder’da her böyle zamanlayıcının bir Timer ID’si vardır (bkz. Uygulamanızın bitiş tarihini belirlemesine izin verin) ve uygulamanız bu zamanlayıcı için bitiş tarihini ayarlar. Kodunuzda, builder’dakiyle aynı Timer ID’yi kullanın; harf büyüklüğü ve boşluklar dahil olmak üzere karakter karakter aynı olmalıdır. ID’ler farklıysa zamanlayıcı, uygulamanızdan bitiş tarihi alamaz.
Son tarihleri ayarlamak için, Zamanlayıcı ID’leri ve son tarihlerinden oluşan bir sözlüğü SetCustomTimers metoduna geçirin. DateTimeKind.Utc ile bir DateTime UTC zamanıdır; türü belirtilmemiş bir DateTime ise kullanıcının yerel saati olarak okunur. İşte bir örnek:
var customTimers = new Dictionary<string, DateTime> {
{ "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
{ "CUSTOM_TIMER_NY", new DateTime(DateTime.Now.Year + 1, 1, 1) } // next New Year's Day, local time
};
var parameters = new AdaptyUICreateFlowViewParameters()
.SetCustomTimers(customTimers)
.SetLoadTimeout(TimeSpan.FromSeconds(3));
AdaptyUI.CreateFlowView(flow, parameters, (view, error) => {
if (error != null) {
// handle the error
return;
}
// use view
});Bu örnekte, CUSTOM_TIMER_NY ve CUSTOM_TIMER_6H, builder’daki iki Geliştirici tarafından tanımlanan zamanlayıcının Timer ID’leridir:
CUSTOM_TIMER_NY: Bir sonraki Yılbaşı’na kalan süre.CUSTOM_TIMER_6H: Uygulamanızın görünümü oluşturduğu andan itibaren başlayan 6 saatlik sürede kalan zaman.
SDK, görünümü oluştururken özel zamanlayıcıları yalnızca bir kez okur; dolayısıyla CUSTOM_TIMER_6H gibi hesaplanan bir tarih, o andan itibaren sayılmaya başlar ve kullanıcı ekranı tekrar açtığında da aynı tarih geçerlidir. Tarih geçmişte kalırsa zamanlayıcı anında sıfır gösterir ve On timer end tetikleyicisi çalışır. Sözlükte bir Zamanlayıcı ID’sine ait anahtar yoksa, zamanlayıcı ekranın açıldığı andan itibaren bir saat geri sayar.
Adapty Kontrol Paneli’ndeki eski Paywall Builder ile paywallınızın görsel kısmını tasarladıktan sonra, bunu mobil uygulamanızda gösterebilirsiniz. Bu sürecin ilk adımı, aşağıda açıklandığı gibi placement ile ilişkili paywall’ı ve görünüm yapılandırmasını almaktır.
SDK 3.x Paywall Builder ile oluşturulan paywalllar, Unity SDK sürüm 3.3.0 veya daha yüksek bir sürüm gerektirir.
Paywall Builder ile özelleştirilmiş paywalllar hakkında bir konu olduğunu lütfen unutmayın. Özel paywall uyguluyorsanız, Mobil uygulamanızda özel paywalllar için paywall ve ürün getirme konusuna bakın.
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 paywall göstermeye başlamadan önce (genişletmek için tıklayın)
- Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.
- Adapty Kontrol Paneli’nde bir paywall oluşturun ve ürünleri ekleyin.
- Adapty Kontrol Paneli’nde placement’lar oluşturun ve paywallınızı ekleyin.
- Mobil uygulamanıza Adapty SDK yükleyin.
Paywall Builder ile tasarlanan paywall’u getirme
Paywall Builder kullanarak bir paywall tasarladıysanız, bunu kullanıcıya göstermek için mobil uygulama kodunuzda ayrıca render etmeniz gerekmez. Böyle bir paywall, hem gösterilecek içeriği hem de nasıl gösterileceğini barındırır. Yine de placement aracılığıyla ID’sini, view konfigürasyonunu almanız ve ardından mobil uygulamanızda sunmanız gerekir.
En iyi performansı sağlamak için, paywall’ı ve görünüm yapılandırmasını olabildiğince erken almanız, böylece kullanıcıya sunulmadan önce görsellerin indirilmesi için yeterli süre tanımanız kritik önem taşır.
Bir paywall almak için GetPaywall metodunu kullanın:
Adapty.GetPaywall("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
if(error != null) {
// handle the error
return;
}
// paywall - the resulting object
});Parametreler:
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| placementId | zorunlu | İ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: | Paywall yerelleştirmesinin tanımlayıcısı. Bu parametrenin, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olması beklenir. İlk alt etiket dil içindir, ikincisi ise bölge içindir. Örnek: Yerel ayar kodları ve bunların nasıl kullanılması önerildiği hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları bölümüne bakın. |
| fetchPolicy | varsayılan: AdaptyPlacementFetchPolicy.Default |
Ancak kullanıcılarınızın kararsız internet bağlantısıyla karşılaştığını düşünüyorsanız Üçüncü bir politika olan Önbelleğin uygulama yeniden başlatıldığında korunduğunu ve yalnızca uygulama yeniden yüklendiğinde ya da manuel temizlik yoluyla silindiğini unutmayın. Adapty SDK, paywall’ları yerel olarak iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Paywall’ları daha hızlı getirmek için CDN, CDN’e ulaşılamadığı 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 paywall’larınızın en güncel sürümünü almanızı garanti edecek şekilde tasarlanmıştır. |
| loadTimeout | varsayılan: 5 sn | Bu değer, söz konusu yöntemin zaman aşımını sınırlar. Adapty sunucusu zamanında yanıt vermezse veya hata döndürürse SDK, yedek sunucudaki paywall’ı (yalnızca placement’ın All Users kitlesine hizmet eden bir CDN kopyası), önbelleği veya yedek dosyanızı döndürür. Nadir durumlarda bu yöntemin |
Yanıt parametreleri:
| Parametre | Açıklama |
|---|---|
| Paywall | Ürün kimliklerinin listesini, paywall tanımlayıcısını, remote config’i ve diğer birçok özelliği içeren bir AdaptyPaywall nesnesi. |
Paywall Builder kullanılarak tasarlanan paywallın görünüm yapılandırmasını getirme
Paywall Builder’da Show on device geçişinin etkin olduğundan emin olun. Bu seçenek açık değilse, görünüm yapılandırması alınamaz.
Paywallı aldıktan sonra, bir ViewConfiguration içerip içermediğini kontrol edin; bu, paywallın Paywall Builder kullanılarak oluşturulduğunu gösterir. Bu bilgi, paywallı nasıl görüntüleyeceğinizi belirlemenize yardımcı olur. ViewConfiguration mevcutsa, bunu bir Paywall Builder paywallı olarak değerlendirin; değilse, özel paywall olarak ele alın.
Unity SDK’da, görünüm yapılandırmasını manuel olarak önceden getirmeye gerek kalmadan doğrudan CreatePaywallView metodunu çağırın.
CreatePaywallView metodunun sonucu yalnızca bir kez kullanılabilir. Tekrar kullanmanız gerekiyorsa CreatePaywallView metodunu yeniden çağırın. Yeniden oluşturmadan iki kez çağırmak AdaptyUIError.viewAlreadyPresented hatasına yol açabilir.
var parameters = new AdaptyUICreatePaywallViewParameters()
.SetPreloadProducts(preloadProducts)
.SetLoadTimeout(new TimeSpan(0, 0, 3));
AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
// handle the result
});Parametreler:
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| paywall | zorunlu | İstenen paywall için bir controller edinmek amacıyla kullanılan AdaptyPaywall nesnesi. |
| loadTimeout | varsayılan: 5 sn | Bu yöntem için zaman aşımı sınırını belirler. Zaman aşımına ulaşılırsa önbelleğe alınmış veriler veya yerel yedek döndürülür. Arka planda farklı isteklerden oluşabileceğinden, bu yöntem nadir durumlarda loadTimeout içinde belirtilenden biraz daha geç zaman aşımına uğrayabilir. |
| PreloadProducts | isteğe bağlı | Ekranda ürünlerin görüntülenme süresini optimize etmek için bir AdaptyPaywallProducts dizisi sağlayın. nil geçilirse AdaptyUI gerekli ürünleri otomatik olarak getirir. |
| CustomTags | isteğe bağlı | Özel etiketlerin ve çözümlenmiş değerlerinin bir sözlüğünü tanımlayın. Özel etiketler, paywall içeriğinde yer tutucu olarak işlev görür; paywall içinde kişiselleştirilmiş içerik sunmak için belirli dizelerle dinamik olarak değiştirilirler. Daha fazla ayrıntı için Paywall Builder’da özel etiketler konusuna bakın. |
| CustomTimers | isteğe bağlı | Özel zamanlayıcıların ve bitiş tarihlerinin bir sözlüğünü tanımlayın. Özel zamanlayıcılar, paywallınızda geri sayım sayaçları görüntülemenizi sağlar. |
Birden fazla dili destekliyorsanız, paywallınıza bir yerelleştirme ekleyin. Kullanılacak kodlar için Yerelleştirmeler ve yerel ayar kodları sayfasına bakın.
Görünümü oluşturduktan sonra paywallı gösterin.
Varlıkları özelleştirme
Paywallınızdaki görüntü ve videoları özelleştirmek için özel varlıkları uygulayın.
Hero görüntü ve videoların önceden tanımlanmış ID’leri vardır: hero_image ve hero_video. Özel bir varlık paketinde, bu öğeleri ID’leriyle hedefleyerek davranışlarını özelleştirirsiniz.
Diğer görüntü ve videolar için Adapty kontrol panelinde özel bir ID belirlemeniz gerekir.
Örneğin şunları yapabilirsiniz:
- Bazı kullanıcılara farklı bir görüntü veya video gösterin.
- Uzaktaki ana görüntü yüklenirken yerel bir önizleme görüntüsü gösterin.
- Video başlamadan önce bir önizleme görüntüsü gösterin.
Bu özelliği kullanmak için Adapty Unity SDK’yı 3.8.0 veya üzeri bir sürüme güncelleyin.
Aşağıda, basit bir sözlük aracılığıyla özel varlıkları nasıl sağlayabileceğinize dair bir örnek bulunmaktadır:
var customAssets = new Dictionary<string, AdaptyCustomAsset>
{
{ "custom_image", AdaptyCustomAsset.LocalImageFile("custom_assets/images/custom_image.png") },
{ "hero_video", AdaptyCustomAsset.LocalVideoFile("custom_assets/videos/custom_video.mp4") }
};
var parameters = new AdaptyUICreatePaywallViewParameters()
.SetCustomAssets(customAssets)
.SetLoadTimeout(new TimeSpan(0, 0, 3));
AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
// handle the result
});Bir asset bulunamazsa, paywall varsayılan görünümüne geri döner.
Unity uygulamanızda geliştirici tanımlı zamanlayıcılar kurma
Unity uygulamanızda özel zamanlayıcılar kullanmak için, zamanlayıcı ID’leri ve bitiş tarihlerinden oluşan bir sözlüğü doğrudan SetCustomTimers metoduna geçirebilirsiniz. İşte bir örnek:
var customTimers = new Dictionary<string, DateTime> {
{ "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) },
{ "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) }
};
var parameters = new AdaptyUICreatePaywallViewParameters()
.SetCustomTimers(customTimers)
.SetLoadTimeout(new TimeSpan(0, 0, 3));
AdaptyUI.CreatePaywallView(paywall, parameters, (view, error) => {
// handle the result
});Bu örnekte, CUSTOM_TIMER_NY ve CUSTOM_TIMER_6H, Adapty Kontrol Paneli’nde ayarladığınız geliştirici tanımlı zamanlayıcıların Timer ID’leridir. Zamanlayıcı çözümleyici, uygulamanızın her zamanlayıcıyı doğru değerle dinamik olarak güncellemesini sağlar. Örneğin:
CUSTOM_TIMER_NY: Yılbaşı gibi zamanlayıcının bitiş anına kalan süre.CUSTOM_TIMER_6H: Kullanıcının paywall’ı açtığı andan itibaren başlayan 6 saatlik sürede kalan zaman.
Varsayılan kitle paywallı ile paywall getirme işlemini hızlandırın
Genellikle paywalllar neredeyse anında getirilir, bu yüzden bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitle ve paywallınız varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, bir paywallın getirilmesi istediğinizden daha uzun sürebilir. Böyle durumlarda, hiç paywall göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak amacıyla varsayılan bir paywall görüntülemek isteyebilirsiniz.
Bu sorunu çözmek için, belirtilen placement’ın paywallını All Users kitlesi için getiren GetPaywallForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın, yukarıdaki Paywall Getirme bölümünde açıklandığı gibi, paywallı getPaywall metoduyla getirmek olduğunu unutmayın.
GetPaywallForDefaultAudience yerine GetPaywall kullanmayı tercih edin; zira ikincisinin önemli kısıtlamaları vardır:
- Uyumluluk sorunları: Birden fazla uygulama sürümünü desteklerken sorun çıkarabilir; geriye dönük uyumlu tasarımlar gerektirir ya da eski sürümlerin hatalı görüntüleneceğini kabul etmek gerekir.
- Kişiselleştirme yok: Yalnızca “All Users” kitlesi için içerik gösterir; ülke, attribution veya özel özelliklere dayalı hedefleme yapılamaz.
Daha hızlı yükleme bu dezavantajları göze almaya değiyorsa, aşağıda gösterildiği gibi GetPaywallForDefaultAudience kullanın. Aksi takdirde, yukarıda açıklandığı şekilde GetPaywall kullanın.
Adapty.GetPaywallForDefaultAudience("YOUR_PLACEMENT_ID", "en", (paywall, error) => {
if(error != null) {
// handle the error
return;
}
// paywall - the resulting object
});Parametreler:
| Parametre | Zorunluluk | Açıklama |
|---|---|---|
| placementId | zorunlu | İstenen Placement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir. |
| locale | isteğe bağlı varsayılan: | 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: |
| fetchPolicy | varsayılan: AdaptyPlacementFetchPolicy.Default |
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 Üçüncü bir politika olan Önbelleğin uygulama yeniden başlatıldığında bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizleme yoluyla silindiğini unutmayın. Adapty SDK, paywallları yerel olarak 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’ye ulaşılamadığında 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 paywalllarınızın her zaman en son sürümünü almanızı garantileyecek şekilde tasarlanmıştır. |