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 için tanımlayıcı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir. |
| locale | isteğe bağlı varsayılan: | Onboarding 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: 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ı sayfasına bakın. |
| fetchPolicy | varsayılan: .reloadRevalidatingCacheData | SDK, varsayılan olarak verileri sunucudan yüklemeye çalışır; başarısız olması durumunda önbelleğe alınmış verileri döndürür. Kullanıcılarınızın her zaman en güncel verilere erişmesini 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şı karşıya olduğunu düşünüyorsanız, önbelleğe alınmış veri mevcutsa onu döndürmek için Ö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 depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek için CDN, CDN’ye erişilemediği 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 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, yöntem için 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. Nadir durumlarda bu yöntemin, arka planda farklı isteklerden oluşabileceğinden |
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. |
| externalUrlsPresentation | isteğe bağlı varsayılan: | Onboarding’deki bağlantıların nasıl açıldığını kontrol eder. Mevcut seçenekler: - - 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: | 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: |
| 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 Ö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. |