Unity SDK'da onboarding alma

Adapty Kontrol Paneli’ndeki builder ile onboarding’inizin görsel kısmını tasarladıktan sonra Unity 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ı kontrol edin:

Adapty Unity SDK 3.14.0 veya üzeri sürümünü yüklediğinizden emin olun.
Bir onboarding oluşturduğunuzdan emin olun.
Onboarding’i bir placement’a eklediğinizden emin 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.

Bunu çözmek için, Tüm Kullanıcılar kitlesi için belirtilen placement’ın onboarding’ini alan GetOnboardingForDefaultAudience metodunu kullanabilirsiniz. Ancak önerilen yaklaşımın, yukarıdaki Onboarding Alma bölümünde ayrıntılı olarak açıklandığı şekilde getOnboarding metoduyla onboarding almak olduğunu anlamak çok önemlidir.

GetOnboardingForDefaultAudience yerine GetOnboarding kullanmayı düşünün; ikincisinin önemli sınırlamaları vardır:

Uyumluluk sorunları: Birden fazla uygulama sürümünü desteklerken sorun yaratabilir; geriye dönük uyumlu tasarımlar yapmanızı veya eski sürümlerin yanlış görüntülenebileceğini kabul etmenizi gerektirir.
Kişiselleştirme yok: Yalnızca “Tüm Kullanıcılar” kitlesi için içerik gösterir; ülke, attribution veya özel özniteliklere dayalı hedeflemeyi ortadan kaldırır.

Kullanım durumunuzda daha hızlı alma bu dezavantajlardan daha önemli ise, aşağıda gösterildiği gibi GetOnboardingForDefaultAudience kullanın. Aksi takdirde yukarıda açıklandığı gibi 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.