React Native SDK'da onboarding'leri al

Adapty Kontrol Paneli’ndeki builder ile onboarding’in görsel kısmını tasarladıktan sonra bunu React Native uygulamanızda gösterebilirsiniz. Bu sürecin ilk adımı, aşağıda açıklandığı şekilde 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 React Native SDK sürüm 3.8.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

No-code builder’ımızla bir onboarding oluşturduğunuzda, bu onboarding uygulamanızın getirmesi ve göstermesi 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ği, nasıl sunulacağı ve kullanıcı etkileşimlerinin (sınav yanıtları veya form girişleri gibi) nasıl işleneceği. Konteyner aynı zamanda analitik olaylarını otomatik olarak takip ettiğinden ayrıca görünüm takibi uygulamanıza gerek yoktur.

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 getirin.

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

try {
    const placementId = 'YOUR_PLACEMENT_ID';
    const locale = 'en';

    const onboarding = await adapty.getOnboarding(placementId, locale);
    // the requested onboarding
} catch (error) {
    // handle the error
}

Ardından bir görünüm örneği oluşturmak için 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.

// for the Adapty SDK < 3.14 – import {createOnboardingView} from 'react-native-adapty/dist/ui';

if (onboarding.hasViewConfiguration) {
    try {
        const view = await createOnboardingView(onboarding);
    } catch (error) {
        // handle the error
    }
} else {
    //use your custom logic
}

Parametreler:

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	İstenen Placement’ın tanımlayıcısı. 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 parametre, eksi (-) karakteriyle ayrılmış bir veya iki alt etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dil içindir, ikincisi bölge içindir. Örnek: `en` İngilizce anlamına gelir, `pt-br` Brezilya Portekizcesini temsil eder. Yerel ayar kodları ve bunların nasıl kullanılmasını önerdiğimiz hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları sayfasına bakın.
fetchPolicy	varsayılan: `.reloadRevalidatingCacheData`	Varsayılan olarak SDK, 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 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 karşılaştığını düşünüyorsanız, varsa önbelleğe alınmış veriyi döndürmek için `.returnCacheDataElseLoad` kullanmayı değerlendirin. Bu senaryoda kullanıcılar en güncel verilere ulaşamayabilir; ancak internet bağlantısı ne kadar kesintili 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üresince güvenle kullanılabilir. Önbelleğin uygulama yeniden başlatıldığında bozulmadan 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 saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek 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 yetersiz olduğu durumlarda bile güvenilirliği sağlarken onboarding’lerinizin her zaman en son sürümünü almanızı garanti eder.
loadTimeoutMs	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. Nadir durumlarda bu metodun `loadTimeout` içinde belirtilenin biraz daha gerisinde zaman aşımına uğrayabileceğini unutmayın; çünkü işlem arka planda farklı isteklerden oluşuyor olabilir.

Yanıt parametreleri:

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

Varsayılan kitle onboarding’i ile onboarding getirmeyi 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 kitleniz ve onboarding’iniz varsa ve kullanıcılarınızın internet bağlantısı zayıfsa, onboarding getirme istediğinizden daha uzun sürebilir. Bu durumlarda, hiç onboarding göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir onboarding göstermek isteyebilirsiniz.

Bunu ele almak 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 ayrıntılı olarak açıklandığı gibi getOnboarding metoduyla onboarding getirmek olduğunu anlamak önemlidir.

getOnboardingForDefaultAudience yerine getOnboarding kullanmayı tercih edin; çünkü ikincisinin önemli sınırlamaları vardır:

Uyumluluk sorunları: Birden fazla uygulama sürümünü desteklerken sorunlara yol açabilir; ya geriye dönük uyumlu tasarımlar gerektirirsiniz ya da eski sürümlerin yanlış görüntülenebileceğini kabul etmek durumunda kalırsınız.
Kişiselleştirme yok: Yalnızca “All Users” kitlesi için içerik gösterir; ülkeye, attribution’a veya özel niteliklere göre hedeflemeyi ortadan kaldırır.

Kullanım durumunuzda daha hızlı getirme bu dezavantajlardan daha önemliyse getOnboardingForDefaultAudience kullanın (aşağıda gösterildiği gibi). Aksi takdirde yukarıda açıklandığı şekilde getOnboarding kullanın.

try {
    const placementId = 'YOUR_PLACEMENT_ID';
    const locale = 'en';

    const onboarding = await adapty.getOnboardingForDefaultAudience(placementId, locale);
    // the requested onboarding
} catch (error) {
    // handle the error
}

Parametreler:

Parametre Zorunluluk Açıklama

placementId zorunlu İstenen Placement’ın tanımlayıcısı. 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 parametre, eksi (-) karakteriyle ayrılmış bir veya iki alt etiketten oluşan bir dil kodu olmalıdır. İlk alt etiket dil içindir, ikincisi bölge içindir.

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

Yerel ayar kodları ve bunların nasıl kullanılmasını önerdiğimiz hakkında daha fazla bilgi için Yerelleştirmeler ve yerel ayar kodları sayfasına bakın.

fetchPolicy

varsayılan: .reloadRevalidatingCacheData

Varsayılan olarak SDK, 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 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 karşılaştığını düşünüyorsanız, varsa önbelleğe alınmış veriyi döndürmek için .returnCacheDataElseLoad kullanmayı değerlendirin. Bu senaryoda kullanıcılar en güncel verilere ulaşamayabilir; ancak internet bağlantısı ne kadar kesintili 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üresince güvenle kullanılabilir.

Önbelleğin uygulama yeniden başlatıldığında bozulmadan 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 saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek onboarding’ler. Onboarding’leri daha hızlı getirmek 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 yetersiz olduğu durumlarda bile güvenilirliği sağlarken onboarding’lerinizin her zaman en son sürümünü almanızı garanti eder.