Unity 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 düzeltme veya iyileştirme almamaktadır. Bunun yerine flow’ları kullanın: WebView içinde çalışan onboarding’lerin aksine, flow’lar cihazda yerel olarak render edilir — daha akıcı animasyonlar, tutarlı bir yerel görünüm ve his, daha hızlı yükleme süreleri ve WebView çalışma zamanı bağımlılığı olmaksızın kullanım imkânı sunar. Başlamak için Flow’ları ve paywall’ları edinme ve Flow’ları ve paywall’ları gösterme sayfalarına bakın.

Adapty Kontrol Paneli’nde builder ile onboarding’inizin görsel kısmını tasarladıktan sonra Unity uygulamanızda görüntüleyebilirsiniz. Bu süreçteki 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 Unity SDK sürüm 3.14.0 veya üzerini yüklemiş olun.
Bir onboarding oluşturmuş olun.
Onboarding’i bir placement’a eklemiş olun.

Onboarding’i alın ve görünüm oluşturun

No-code builder’ımızla bir onboarding oluşturduğunuzda, bu onboarding uygulamanızın alıp göstermesi gereken bir yapılandırma içeren konteyner olarak saklanır. Bu konteyner, hangi içeriğin görüneceği, nasıl sunulacağı ve kullanıcı etkileşimlerinin (quiz cevapları veya form girişleri gibi) nasıl işleneceği dahil tüm deneyimi yönetir. Konteyner aynı zamanda analitik olaylarını otomatik olarak takip eder; bu sayede ayrıca görüntüleme takibi yapmanız gerekmez.

En iyi performans için, kullanıcılara göstermeden önce görsellerin indirilmesine yeterli zaman tanımak amacıyla onboarding yapılandırmasını erken alın.

Onboarding almak için GetOnboarding metodunu kullanın:

Adapty.GetOnboarding("YOUR_PLACEMENT_ID", (onboarding, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // the requested onboarding
});

Parametreler:

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	İstenen Placement’ın 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 etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dil için, ikincisi bölge içindir. Örnek: `en` İngilizce, `pt-br` Brezilya Portekizcesi anlamına gelir. Yerel ayar kodları ve bunların kullanımı 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 ve 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 veriye erişmesini sağladığı için bu seçeneği öneririz. Ancak kullanıcılarınızın kararsız internet bağlantısıyla uğraştığını düşünüyorsanız, önbelleğe alınmış veri varsa onu döndürmek için `.returnCacheDataElseLoad` kullanmayı düşünebilirsiniz. Bu senaryoda kullanıcılar en güncel veriyi alamayabilir, 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 ağ isteklerinden kaçınmak için oturum sırasında kullanmak güvenlidir. Önbelleğin uygulama yeniden başlatıldığında korunduğunu ve yalnızca uygulama yeniden yüklendiğinde ya da manuel temizleme yapıldığında silindiğ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ı almak için CDN, CDN’e erişilemediği durumlarda ise bağımsız bir yedek sunucu kullanıyoruz. Bu sistem, internet bağlantısının zayıf olduğu durumlarda bile güvenilirliği sağlarken her zaman onboarding’lerinizin en güncel sürümünü almanızı garantilemek için 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şılırsa önbelleğe alınmış veri veya yerel yedek döndürülür. Nadir durumlarda bu metodun `loadTimeout` ile 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 özellikler içeren bir `AdaptyOnboarding` nesnesi.

Onboarding’i aldıktan sonra CreateOnboardingView metodunu çağırın.

CreateOnboardingView metodunun sonucu yalnızca bir kez kullanılabilir. Tekrar kullanmanız gerekiyorsa CreateOnboardingView metodunu yeniden çağırın. Yeniden oluşturmadan iki kez çağırmak AdaptyUIError.viewAlreadyPresented hatasına yol açabilir.

AdaptyUI.CreateOnboardingView(onboarding, (view, error) => {
    // handle the result
});

Parametreler:

Parametre Zorunluluk Açıklama

onboarding zorunlu İstenen onboarding için görünüm elde etmek amacıyla kullanılan AdaptyOnboarding nesnesi.

Parametre	Zorunluluk	Açıklama
onboarding	zorunlu	İstenen onboarding için görünüm elde etmek amacıyla kullanılan `AdaptyOnboarding` nesnesi.
externalUrlsPresentation	isteğe bağlı varsayılan: `InAppBrowser`	Onboarding’deki bağlantıların nasıl açıldığını kontrol eder. Mevcut seçenekler: - `AdaptyWebPresentation.InAppBrowser` - Bağlantıları uygulama içi tarayıcıda açar (varsayılan) - `AdaptyWebPresentation.ExternalBrowser` - Bağlantıları cihazın harici tarayıcısında açar Kullanım örnekleri için Onboarding’lerde bağlantıların nasıl açıldığını özelleştirme sayfasına bakın.

externalUrlsPresentation

isteğe bağlı

varsayılan: InAppBrowser

Onboarding’deki bağlantıların nasıl açıldığını kontrol eder. Mevcut seçenekler:

- AdaptyWebPresentation.InAppBrowser - Bağlantıları uygulama içi tarayıcıda açar (varsayılan)

- AdaptyWebPresentation.ExternalBrowser - Bağlantıları cihazın harici tarayıcısında açar

Kullanım örnekleri için Onboarding’lerde bağlantıların nasıl açıldığını özelleştirme sayfasına bakın.

Onboarding’i ve görünüm yapılandırmasını başarıyla yükledikten sonra mobil uygulamanızda gösterebilirsiniz.

Varsayılan kitle onboarding’i ile onboarding almayı hızlandırın

Genellikle onboarding’ler neredeyse anında alınır, 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, onboarding almak istediğinizden daha uzun sürebilir. Bu gibi durumlarda, hiç onboarding göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir onboarding göstermek isteyebilirsiniz.

Bu sorunu çözmek için GetOnboardingForDefaultAudience metodunu kullanabilirsiniz; bu metod, belirtilen placement’ın All Users kitlesine ait onboarding’ini getirir. Ancak önerilen yaklaşımın, yukarıdaki Onboarding’i Getir bölümünde açıklandığı gibi, onboarding’i getOnboarding metoduyla getirmek olduğunu unutmayın.

GetOnboardingForDefaultAudience yerine GetOnboarding kullanmayı tercih edin; zira ikinci metodun önemli kısıtlamaları vardı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 “All Users” kitlesine yönelik içerik gösterir; ülke, attribution veya özel özelliklere dayalı hedefleme yapılamaz.

Bu dezavantajlara rağmen daha hızlı veri çekme sizin için öncelikli ise aşağıda gösterildiği gibi GetOnboardingForDefaultAudience kullanın. Aksi takdirde yukarıda açıklandığı şekilde GetOnboarding kullanın.

Adapty.GetOnboardingForDefaultAudience("YOUR_PLACEMENT_ID", (onboarding, error) => {
    if (error != null) {
        // handle the error
        return;
    }
    
    // the requested onboarding
});

Parametreler:

Parametre Zorunluluk Açıklama

placementId zorunlu İstenen Placement’ın 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 etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dil için, ikincisi bölge içindir.

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

fetchPolicy

varsayılan: .reloadRevalidatingCacheData

SDK varsayılan olarak sunucudan veri yüklemeye çalışır ve 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 veriye erişmesini sağladığı için bu seçeneği öneririz.

Ancak kullanıcılarınızın kararsız internet bağlantısıyla uğraştığını düşünüyorsanız, önbelleğe alınmış veri varsa onu döndürmek için .returnCacheDataElseLoad kullanmayı düşünebilirsiniz. Bu senaryoda kullanıcılar en güncel veriyi alamayabilir, 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 ağ isteklerinden kaçınmak için oturum sırasında kullanmak güvenlidir.

Önbelleğin uygulama yeniden başlatıldığında korunduğunu ve yalnızca uygulama yeniden yüklendiğinde ya da manuel temizleme yapıldığında silindiğ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ı almak için CDN, CDN’e erişilemediği durumlarda ise bağımsız bir yedek sunucu kullanıyoruz. Bu sistem, internet bağlantısının zayıf olduğu durumlarda bile güvenilirliği sağlarken her zaman onboarding’lerinizin en güncel sürümünü almanızı garantilemek için tasarlanmıştır.