Kotlin Multiplatform SDK'da onboarding'leri alma

Onboardings, SDK v4’te kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır. Artık hata düzeltmesi veya iyileştirme almamaktadır. Bunun yerine flow’ları kullanın: onboarding’ler WebView içinde çalışırken, flow’lar cihazda doğrudan native olarak render edilir — bu sayede daha akıcı animasyonlar, tutarlı bir native görünüm, daha hızlı yükleme süreleri ve WebView bağımlılığı olmadan çalışma imkânı sunar. Başlamak için Flow ve paywall’ları edinme ve Flow ve paywall’ları görüntüleme konularına bakın.

Adapty Kontrol Paneli’nde builder ile onboarding’in görsel kısmını tasarladıktan sonra, onu Kotlin Multiplatform uygulamanızda gösterebilirsiniz. Bu sürecin ilk adımı, aşağıda açıklandığı gibi placement ile ilişkili onboarding’i ve görünüm yapılandırmasını almaktır.

Başlamadan önce şunları sağlayın:

Adapty Kotlin Multiplatform SDK sürüm 3.15.0 veya daha yüksek bir sürümü yüklemiş olun.
Bir onboarding oluşturmuş olun.
Onboarding’i bir placement’a eklemiş olun.

Onboarding’i getir

Kodsuz oluşturucumuzla bir onboarding oluşturduğunuzda, bu onboarding uygulamanızın getirip göstermesi gereken bir konfigürasyon içeren container olarak saklanır. Container tüm deneyimi yönetir; hangi içeriğin görüneceğini, nasıl sunulacağını ve kullanıcı etkileşimlerinin (sınav yanıtları veya form girişleri gibi) nasıl işleneceğini belirler. Container aynı zamanda analitik olaylarını otomatik olarak izler, bu yüzden ayrıca görüntüleme takibi uygulamanıza gerek yoktur.

En iyi performans için, görsellerin kullanıcılara gösterilmeden önce indirilmesine yetecek kadar zaman tanımak amacıyla onboarding konfigürasyonunu erken getirin.

Bir onboarding almak için getOnboarding metodunu kullanın:


Adapty.getOnboarding(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    // the requested paywall
}.onError { error ->
    // handle the error
}

Parametreler:

Parametre	Varlık	Açıklama
placementId	zorunlu	İstenen Placement tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde placement oluştururken belirttiğiniz değerdir.
locale	isteğe bağlı varsayılan: `en`	Onboarding 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 dili, ikincisi ise bölgeyi belirtir. Örnek: `en` İngilizce anlamına gelir, `pt-br` Brezilya Portekizcesini temsil eder.
fetchPolicy	varsayılan: `.reloadRevalidatingCacheData`	SDK varsayılan olarak sunucudan veri yüklemeye çalışır; başarısız olursa önbelleğe alınan veriyi döner. Kullanıcılarınızın her zaman en güncel veriye 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 uğraştığını düşünüyorsanız, önbellekte veri varsa onu döndürmek için `.returnCacheDataElseLoad` seçeneğini kullanmayı düşünebilirsiniz. Bu senaryoda kullanıcılar her zaman en güncel veriye ulaşamayabilir; ancak internet bağlantısı ne kadar kötü olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, dolayısıyla oturum sırasında ağ isteklerini azaltmak için 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, onboarding’leri yerel olarak iki katmanda saklar: yukarıda açıklanan düzenli güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek için CDN, CDN’e erişilemediğinde 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 onboarding’lerinizin her zaman en güncel sürümünü almanızı garanti edecek şekilde tasarlanmıştır.
loadTimeout	varsayılan: 5 sn	Bu değer, metodun zaman aşımını sınırlar. Zaman aşımına ulaşılırsa önbelleğe alınan veri veya yerel yedek döndürülür. Nadir durumlarda bu metodun `loadTimeout` içinde belirtilenden biraz daha geç zaman aşımına uğrayabileceğini unutmayın; çünkü işlem arka planda farklı isteklerden oluşabilir.

Yanıt parametreleri

Parametre	Açıklama
Onboarding	Onboarding tanımlayıcısı ve yapılandırması, remote config ve diğer çeşitli özelliklerle birlikte bir `AdaptyOnboarding` nesnesi.

Varsayılan kitle onboarding’i ile onboarding getirme işlemini hızlandırın

Genellikle onboarding’ler neredeyse anında getirilir, bu nedenle bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitle ve onboarding’iniz varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, bir onboarding’in getirilmesi istediğinizden daha uzun sürebilir. Bu gibi durumlarda, hiç onboarding göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak amacıyla varsayılan bir onboarding görüntülemek isteyebilirsiniz.

Bunu ele almak için, belirtilen placement’ın All Users kitlesi için onboarding’ini getiren getOnboardingForDefaultAudience metodunu kullanabilirsiniz. Ancak önerilen yaklaşımın, yukarıdaki Onboarding’i Getir bölümünde açıklandığı gibi getOnboarding metoduyla onboarding’i getirmek olduğunu anlamak kritik önem taşımaktadır.

getOnboardingForDefaultAudience yerine getOnboarding kullanmayı tercih edin; zira ikincisinin önemli kısıtlamaları bulunmaktadır:

Uyumluluk sorunları: Birden fazla uygulama sürümünü desteklerken sorunlara yol açabilir; ya geriye dönük uyumlu tasarımlar gerektirir ya da eski sürümlerin hatalı görüntülenebileceğini kabul etmeniz gerekir.
Kişiselleştirme yok: Yalnızca “Tüm Kullanıcılar” kitlesine yönelik içerik gösterir; ülke, attribution veya özel özelliklere dayalı hedefleme devre dışı kalır.

Daha hızlı veri çekme bu dezavantajlara değiyorsa, aşağıda gösterildiği gibi getOnboardingForDefaultAudience kullanın. Aksi takdirde yukarıda açıklandığı gibi getOnboarding kullanın.


Adapty.getOnboardingForDefaultAudience(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
).onSuccess { paywall ->
    // istenen paywall
}.onError { error ->
    // hatayı işle
}

Parametreler:

Parametre Varlık Açıklama

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

Parametre	Varlık	Açıklama
placementId	zorunlu	İstenen 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`	Onboarding yerelleştirmesinin tanımlayıcısı. Bu parametre, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olmalıdır. İlk alt etiket dil, ikincisi bölge içindir. Örnek: `en` İngilizce anlamına gelir, `pt-br` Brezilya Portekizcesini temsil eder.
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 karşılaştığını düşünüyorsanız, mevcut olması durumunda önbelleğe alınmış veriyi döndürmek için `.returnCacheDataElseLoad` seçeneğini kullanabilirsiniz. Bu senaryoda kullanıcılar en güncel verilere her zaman ulaşamayabilir, ancak internet bağlantıları ne kadar zayıf olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerinden kaçınmak için oturum sırasında güvenle kullanılabilir. Önbelleğin uygulama yeniden başlatıldığında olduğu gibi kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yapıldığında silindiğini unutmayın. Adapty SDK, onboarding’leri yerel olarak iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı çekmek 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 kısıtlı olduğu durumlarda bile güvenilirliği sağlarken onboarding’lerinizin her zaman en güncel sürümünü almanızı garanti etmek için tasarlanmıştır.

locale

isteğe bağlı

varsayılan: en

Onboarding yerelleştirmesinin tanımlayıcısı. Bu parametre, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olmalıdır. İlk alt etiket dil, ikincisi bölge içindir.
Örnek: en İngilizce anlamına gelir, pt-br Brezilya Portekizcesini temsil eder.

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 karşılaştığını düşünüyorsanız, mevcut olması durumunda önbelleğe alınmış veriyi döndürmek için .returnCacheDataElseLoad seçeneğini kullanabilirsiniz. Bu senaryoda kullanıcılar en güncel verilere her zaman ulaşamayabilir, ancak internet bağlantıları ne kadar zayıf olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerinden kaçınmak için oturum sırasında güvenle kullanılabilir.

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

Adapty SDK, onboarding’leri yerel olarak iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı çekmek 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 kısıtlı olduğu durumlarda bile güvenilirliği sağlarken onboarding’lerinizin her zaman en güncel sürümünü almanızı garanti etmek için tasarlanmıştır.