Onboarding'leri ve yapılandırmalarını getir

Adapty Kontrol Paneli’ndeki oluşturucu ile onboarding’inizin görsel kısmını tasarladıktan sonra, onu mobil uygulamanızda gösterebilirsiniz. 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ı kontrol edin:

Adapty iOS, Android, React Native veya Flutter SDK sürüm 3.8.0 veya üzerini yüklediğinizden emin olun.
Bir onboarding oluşturduğunuzdan emin olun.
Onboarding’i bir placement’a eklediğinizden emin olun.

Onboarding’i getir

No-code oluşturucumuzla bir onboarding oluşturduğunuzda, bu onboarding uygulamanızın getirip görüntülemesi gereken bir yapılandırma içeren konteyner olarak saklanır. Bu konteyner tüm deneyimi yönetir; hangi içeriğin görüneceğini, nasıl sunulacağını ve kullanıcı etkileşimlerinin (sınav cevapları veya form girişleri gibi) nasıl işleneceğini belirler. Konteyner aynı zamanda analitik olaylarını otomatik olarak takip eder, bu nedenle ayrıca görüntüleme takibi yapmanıza gerek yoktur.

En iyi performans için, kullanıcılara göstermeden önce görsellerin indirilmesine yetecek süreyi tanımak amacıyla onboarding yapılandırmasını erken getirin.

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

do {
    let onboarding = try await Adapty.getOnboarding(placementId: "YOUR_PLACEMENT_ID")
    // the requested onboarding
} catch {
    // handle the error
}

Parametreler:

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	İstenen Placement’ın 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 lokalizasyonunun tanımlayıcısı. Bu parametrenin, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olması beklenmektedir. İlk alt etiket dil için, ikincisi bölge içindir. Örnek: `en` İngilizce anlamına gelir, `pt-br` Brezilya Portekizcesini temsil eder. Dil kodları ve bunların nasıl kullanılması önerildiği hakkında daha fazla bilgi için Lokalizasyonlar ve dil kodları sayfasına bakın.
fetchPolicy	varsayılan: `.reloadRevalidatingCacheData`	SDK varsayılan olarak sunucudan veri yüklemeye çalışır ve hata durumunda önbelleğe alınmış veriyi döndürür. Kullanıcılarınızın her zaman en güncel veriyi alması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 başa çıktığını düşünüyorsanız, önbelleğe alınmış veriyi döndürmek için `.returnCacheDataElseLoad` kullanmayı düşünün. Bu senaryoda kullanıcılar en güncel veriyi alamayabilir, ancak internet bağlantısı ne kadar kesintili olursa olsun daha hızlı yükleme süresi yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerini önlemek amacıyla oturum sırasında kullanmak güvenlidir. Önbelleğin uygulama yeniden başlatıldığında bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizleme yapıldığında silindiğini unutmayın. Adapty SDK, onboarding’leri yerel olarak iki katmanda saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek için CDN ve CDN’e ulaşılamadığında 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 onboarding’lerinizin en güncel sürümünü almanızı garanti etmek için 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ınmış veri veya yerel yedek döndürülür. Nadiren de olsa 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 özellikler içeren bir `AdaptyOnboarding` nesnesi.

Varsayılan kitle onboarding’i ile onboarding getirmeyi hızlandır

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 varken kullanıcılarınızın internet bağlantısı zayıfsa, onboarding getirme işlemi istediğinizden daha uzun sürebilir. Böyle durumlarda, hiç onboarding göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak amacıyla varsayılan bir onboarding görüntülemek isteyebilirsiniz.

Bu sorunu çözmek için, belirtilen placement’ın All Users kitlesi için onboarding’i getiren getOnboardingForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın yukarıdaki Onboarding’i Getir bölümünde açıklandığı gibi getOnboarding metoduyla onboarding getirmek olduğunu anlamak çok önemlidir.

getOnboardingForDefaultAudience yerine getOnboarding kullanmayı düşünün; çünkü birincisinin önemli kısıtlamaları vardır:

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

Kullanım durumunuzda daha hızlı getirme bu dezavantajlardan daha önemliyse, 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") { result in
    switch result {
        case let .success(onboarding):
            // the requested onboarding
        case let .failure(error):
            // handle the error
    }
}

Parametreler:

Parametre Zorunluluk Açıklama

placementId zorunlu İstenen Placement’ın 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 lokalizasyonunun tanımlayıcısı. Bu parametrenin, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olması beklenmektedir. İlk alt etiket dil için, ikincisi bölge içindir.

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

Dil kodları ve bunların nasıl kullanılması önerildiği hakkında daha fazla bilgi için Lokalizasyonlar ve dil kodları sayfasına bakın.

fetchPolicy

varsayılan: .reloadRevalidatingCacheData

SDK varsayılan olarak sunucudan veri yüklemeye çalışır ve hata durumunda önbelleğe alınmış veriyi döndürür. Kullanıcılarınızın her zaman en güncel veriyi alması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 başa çıktığını düşünüyorsanız, önbelleğe alınmış veriyi döndürmek için .returnCacheDataElseLoad kullanmayı düşünün. Bu senaryoda kullanıcılar en güncel veriyi alamayabilir, ancak internet bağlantısı ne kadar kesintili olursa olsun daha hızlı yükleme süresi yaşarlar. Önbellek düzenli olarak güncellenir, bu nedenle ağ isteklerini önlemek amacıyla oturum sırasında kullanmak güvenlidir.

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

Adapty SDK, onboarding’leri yerel olarak iki katmanda saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek için CDN ve CDN’e ulaşılamadığında 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 onboarding’lerinizin en güncel sürümünü almanızı garanti etmek için tasarlanmıştır.