Flow ve paywall'ları getir - React Native

Flow’unuzu tasarladıktan sonra onu mobil uygulamanızda görüntüleyebilirsiniz. İlk adım, aşağıda açıklandığı gibi placement ile ilişkili flow veya paywall’ı ve görünüm yapılandırmasını almaktır.

Bu konunun, Adapty’nin builder’larında tasarlanmış flow’lar ve paywall’lar için geçerli olduğunu unutmayın. Paywall’larınızı manuel olarak uyguluyorsanız lütfen Mobil uygulamanızda remote config paywall’ları için paywall ve ürünleri getirme konusuna bakın.

Başlamadan önce

İhtiyacınız olanlar:

• Adapty Kontrol Paneli’nde ürünler: Ürünlerinizi oluşturun.
• Ürünlere sahip bir flow: Flow & Paywall Builder üzerinde oluşturun ve ürünleri ona atayın.
• Bir placement: Placement oluşturun ve flow’unuzu ona atayın.
• Adapty SDK kurulu: React Native SDK kurulum kılavuzuna bakın.

Flow/Paywall’ı getir

Eğer builder’da bir flow veya paywall tasarladıysanız, bunu kullanıcıya göstermek için mobil uygulama kodunuzda render etme konusunda endişelenmenize gerek yok. Böyle bir flow veya paywall, hem ne gösterileceğini hem de nasıl gösterileceğini içerir. Bununla birlikte, placement aracılığıyla ID’sini, görünüm yapılandırmasını almanız ve ardından mobil uygulamanızda sunmanız gerekir.

Flow veya paywall’ı getirin ve view’ini mümkün olduğunca erken oluşturun — ideal olarak onu sunmadan çok önce. createFlowView metodu, view yapılandırmasını yükler ve görsellerini arka planda indirip önbelleğe almaya başlar. Onu ne kadar erken çağırırsanız, bu indirmelerin tamamlanması için o kadar çok zaman olur. Flow veya paywall’ı sunduğunuzda, yapılandırması ve görselleri zaten önbelleğe alınmış ve görüntülenmeye hazır olabilir.

Bir flow veya paywall almak için getFlow metodunu kullanın:

try {
    const placementId = 'YOUR_PLACEMENT_ID';

    const flow = await adapty.getFlow(placementId);
  // the requested flow/paywall
} catch (error) {
    // handle the error
}

Parametreler:

Parametre	Zorunlu	Açıklama
placementId	gerekli	İstenen Placement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
fetchPolicy	varsayılan: .reloadRevalidatingCacheData	Varsayılan olarak SDK, verileri sunucudan yüklemeye çalışır ve başarısızlık durumunda önbelleğe alınmış verileri döndürür. Bu varyantı öneririz çünkü kullanıcılarınızın her zaman en güncel verileri almasını sağlar. Ancak kullanıcılarınızın istikrarsız internetle uğraştığını düşünüyorsanız, önbelleğe alınmış veriler varsa onları döndürmek için .returnCacheDataElseLoad kullanmayı düşünün. Bu senaryoda kullanıcılar mutlak en son verileri alamayabilir, ancak internet bağlantıları ne kadar kötü olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu yüzden ağ isteklerinden kaçınmak için oturum sırasında kullanmak güvenlidir. Uygulamayı yeniden başlattığınızda önbelleğin bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yoluyla temizlendiğini unutmayın. Adapty SDK, paywall’ları yerel olarak iki katmanda saklar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Ayrıca paywall’ları daha hızlı getirmek için CDN’i ve CDN erişilemez olduğunda bağımsız bir yedek sunucuyu kullanırız. Bu sistem, internet bağlantısının zayıf olduğu durumlarda bile güvenilirliği sağlarken her zaman paywall’larınızın en son sürümünü almanızı garanti etmek için tasarlanmıştır.
loadTimeoutMs	varsayılan: 5 sn	Bu değer, bu metodun zaman aşımını 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 metodun, işlem alt katmanda farklı isteklerden oluşabileceği için loadTimeout’ta belirtilenden biraz daha geç zaman aşımına uğrayabileceğini unutmayın. Android için: TimeInterval’ı uzantı fonksiyonlarıyla (5.seconds gibi, burada .seconds, import com.adapty.utils.seconds’ten gelir) veya TimeInterval.seconds(5) ile oluşturabilirsiniz. Sınırlama olmaması için TimeInterval.INFINITE kullanın.

Yanıt parametreleri:

Parametre	Açıklama
Flow	Flow’un tanımlayıcılarını (id, variationId), adını, placement’ını, paywall varyasyonlarını (paywalls), tüm remote config’leri (remoteConfigs) ve — SDK 4.1 ve sonrasında — bir hasViewConfiguration bayrağını içeren AdaptyFlow nesnesi.

Görünüm yapılandırmasını getirin

Eğer placement Flow & Paywall Builder ya da eski Paywall Builder ile tasarlandıysa, Adapty kullanıcı arayüzünü sizin için oluşturur. createFlowView ile view’ı oluşturun, ardından flow veya paywall’ı gösterin. Placement, Builder arayüzü olmayan özel bir paywall ise remote config paywall olarak ele alın.

SDK 4.1 ve sonrasında, flow üzerindeki hasViewConfiguration bayrağı, view’ı oluşturmadan önce ikisini birbirinden ayırt etmenizi sağlar:

if (flow.hasViewConfiguration) {
  const view = await createFlowView(flow);
  await view.present();
} else {
  // Render your own screen from flow.remoteConfigs and flow.paywalls
}

4.0’da bu bayrak mevcut değildir ve createFlowView, görünüm yapılandırması olmayan bir flow için AdaptyError fırlatır.

React Native SDK’da doğrudan createFlowView çağırın — önce görünüm yapılandırmasını almanıza gerek yoktur.

try {
  const view = await createFlowView(flow);
} catch (error) {
  // handle the error
}

Parametreler:

Parametre	Zorunluluk	Açıklama
flow	zorunlu	İstenen flow/paywall için bir kontrolör elde etmek amacıyla kullanılan AdaptyFlow nesnesi.
locale	opsiyonel	Görünümün hangi flow yerelleştirmesiyle render edileceğini belirleyen tanımlayıcı — örneğin en veya pt-br. Belirtilmezse görünüm en dilinde, flow’da en yoksa flow’un varsayılan yerelleştirmesiyle render edilir. SDK 4.0.2 veya üstü gerektirir. Bkz. Yerelleştirmeler ve locale kodları.
customLayoutId	opsiyonel varsayılan: undefined SDK 4.1+	Henüz yayınlanmamış bir Flow & Paywall Builder özelliği için ayrılmıştır. Builder layout ID’lerini tanımlayabilene kadar, geçirdiğiniz herhangi bir değer hiçbir layout ile eşleşmez ve createFlowView bir AdaptyError fırlatır. Ayarlamadan bırakın.
customTags	opsiyonel	İçerikte yer tutucu olarak kullanılan özel etiketler ve çözümlenmiş değerlerinden oluşan sözlük. Özel etiketler yalnızca eski builder paywallları için geçerlidir — flow’lar bunun yerine değişkenler kullanır.
prefetchProducts	opsiyonel	Ekrandaki ürünlerin görüntülenme zamanlamasını optimize etmek için etkinleştirin. true olduğunda AdaptyUI gerekli ürünleri otomatik olarak getirir. Varsayılan: false.
android.enableSafeArea	opsiyonel	Yalnızca Android (iOS’ta göz ardı edilir). İç içe nesne olarak geçirin: android: { enableSafeArea: true }. true olduğunda, flow görünümü güvenli alan (safe-area) dolguları uygular. Modal sunum için varsayılan true (createFlowView + present()), gömülü AdaptyFlowView bileşeni için ise false’tur. Varsayılan değer çoğu durum için uygundur.

View’e sahip olduğunuzda, flow/paywall’ı sunun.

Daha hızlı getirmek için varsayılan bir kitle için flow veya paywall alma

Genellikle flow’lar ve paywall’lar neredeyse anında getirilir, bu yüzden bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitleniz ve placement’ınız olduğu ve kullanıcılarınızın zayıf internet bağlantısı olduğu durumlarda, bir flow veya paywall’ı getirmek istediğinizden daha uzun sürebilir. Bu tür durumlarda, hiçbir şey göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir flow veya paywall görüntülemek isteyebilirsiniz.

Bunu çözmek için, belirtilen placement’ın flow veya paywall’ını All Users kitlesi için getiren getFlowForDefaultAudience metodunu kullanabilirsiniz. Ancak, önerilen yaklaşımın yukarıdaki Flow/paywall getirme bölümünde ayrıntılı olarak açıklandığı gibi flow veya paywall’ı getFlow metoduyla getirmek olduğunu anlamak çok önemlidir.

try {
    const id = 'YOUR_PLACEMENT_ID';

    const flow = await adapty.getFlowForDefaultAudience(id);
  // the requested flow/paywall
} catch (error) {
    // handle the error
}

Parametre	Zorunlu	Açıklama
placementId	gerekli	Placement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nizde bir placement oluştururken belirttiğiniz değerdir.
fetchPolicy	varsayılan: .reloadRevalidatingCacheData	Varsayılan olarak SDK, verileri sunucudan yüklemeye çalışır ve başarısızlık durumunda önbelleğe alınmış verileri döndürür. Bu varyantı öneririz çünkü kullanıcılarınızın her zaman en güncel verileri almasını sağlar. Ancak kullanıcılarınızın istikrarsız internetle uğraştığını düşünüyorsanız, önbelleğe alınmış veriler varsa onları döndürmek için .returnCacheDataElseLoad kullanmayı düşünün. Bu senaryoda kullanıcılar mutlak en son verileri alamayabilir, ancak internet bağlantıları ne kadar kötü olursa olsun daha hızlı yükleme süreleri yaşarlar. Önbellek düzenli olarak güncellenir, bu yüzden ağ isteklerinden kaçınmak için oturum sırasında kullanmak güvenlidir. Uygulamayı yeniden başlattığınızda önbelleğin bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yoluyla temizlendiğini unutmayın.

Asset’leri özelleştirme

Flow/paywall’ınızdaki görselleri ve videoları özelleştirmek için özel asset’leri uygulayın.

Hero görsellerinin ve videolarının önceden tanımlanmış ID’leri vardır: hero_image ve hero_video. Özel bir asset paketinde, bu öğeleri ID’leriyle hedefler ve davranışlarını özelleştirirsiniz.

Diğer görseller ve videolar için, Adapty kontrol panelinde özel bir ID ayarlamanız gerekir.

Örneğin şunları yapabilirsiniz:

• Bazı kullanıcılara farklı bir görsel veya video gösterme.
• Uzak bir ana görsel yüklenirken yerel bir önizleme görseli gösterme.
• Bir videoyu çalıştırmadan önce bir önizleme görseli gösterme.

Basit bir sözlük aracılığıyla özel varlıkları nasıl sağlayabileceğinize dair bir örnek:

const customAssets: Record<string, AdaptyCustomAsset> = {
  'custom_image': { type: 'image', relativeAssetPath: 'custom_image.png' },
  'hero_video': {
    type: 'video',
    fileLocation: {
      ios: { fileName: 'custom_video.mp4' },
      android: { relativeAssetPath: 'videos/custom_video.mp4' }
    }
  }
};

view = await createFlowView(flow, { customAssets })

Adapty Kontrol Paneli’ndeki eski Paywall Builder ile paywallınızın görsel kısmını tasarladıktan sonra, bunu mobil uygulamanızda gösterebilirsiniz. Bu sürecin ilk adımı, placement ile ilişkili paywallı ve görünüm yapılandırmasını aşağıda açıklandığı gibi almaktır.

Lütfen bu konunun Paywall Builder ile özelleştirilen paywall’lara atıfta bulunduğunu unutmayın. Paywall’larınızı manuel olarak uyguluyorsanız, lütfen Mobil uygulamanızda remote config paywall’ları için paywall’ları ve ürünleri getirme konusuna bakın.

Mobil uygulamanızda paywall’ları görüntülemeye başlamadan önce (genişletmek için tıklayın)

1. Adapty Kontrol Paneli’nde ürünlerinizi oluşturun.
2. Adapty Kontrol Paneli’nde bir paywall oluşturun ve ürünleri ona dahil edin.
3. Adapty Kontrol Paneli’nde placement’lar oluşturun ve paywall’ınızı ona dahil edin.
4. Mobil uygulamanızda Adapty SDK’yı yükleyin.

Paywall Builder ile tasarlanan paywallı çekme

Paywall Builder kullanarak bir paywall tasarladıysanız, bunu kullanıcıya göstermek için mobil uygulama kodunuzda render etme konusunda endişelenmenize gerek yoktur. Bu tür bir paywall, paywall içinde neyin gösterileceğini ve nasıl gösterileceğini içerir. Yine de placement aracılığıyla ID’sini, görünüm yapılandırmasını alıp ardından mobil uygulamanızda sunmanız gerekir.

En iyi performansı sağlamak için, kullanıcılara sunmadan önce görsellerin indirilmesine yeterli zaman tanımak amacıyla paywall ve görünüm yapılandırmasını mümkün olduğunca erken almanız önemlidir.

Bir paywall almak için getPaywall metodunu kullanın:

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

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

Parametreler:

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	İstenen Placement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
locale	opsiyonel varsayılan: en	Paywall yerelleştirmesinin tanımlayıcısı. Bu parametrenin, eksi (-) karakteriyle ayrılmış bir veya iki alt etiket içeren bir dil kodu olması beklenir. İlk alt etiket dil içindir, ikincisi ise bölge içindir. Örnek: en İngilizce anlamına gelir, pt-br Brezilya Portekizcesini temsil eder. Locale kodları ve bunların nasıl kullanılmasını önerdiğimiz hakkında daha fazla bilgi için Yerelleştirmeler ve locale kodları bölümüne bakın.
fetchPolicy	varsayılan: .reloadRevalidatingCacheData	SDK varsayılan olarak verileri sunucudan yüklemeye çalışır ve hata durumunda önbelleğe alınmış verileri döndürür. Kullanıcılarınızın her zaman en güncel verileri almasını sağladığından bu seçeneği öneriyoruz. Ancak kullanıcılarınızın kararsız bir internet bağlantısıyla karşılaştığını düşünüyorsanız, mevcut olması durumunda önbelleğe alınmış verileri döndürmek için .returnCacheDataElseLoad kullanmayı değerlendirin. Bu senaryoda kullanıcılar en güncel verilere ulaşamayabilir; ancak internet bağlantıları 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 amacıyla oturum sırasında güvenle kullanılabilir. Önbelleğin uygulamayı yeniden başlatmadan sonra da bozulmadan kaldığını ve yalnızca uygulama yeniden yüklendiğinde veya manuel temizlik yapıldığında silindiğini unutmayın. Adapty SDK, paywall’ları yerel olarak iki katmanda depolar: yukarıda açıklanan düzenli olarak güncellenen önbellek ve yedek paywall’lar. Paywall’ları daha hızlı getirmek için CDN ve CDN’e ulaşılamadığı durumlarda bağımsız bir yedek sunucu da kullanıyoruz. Bu sistem, internet bağlantısının yetersiz olduğu durumlarda bile güvenilirliği sağlarken paywall’larınızın her zaman en son sürümünü almanızı sağlamak için tasarlanmıştır.
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ış veriler veya yerel yedek döndürülür. Nadir durumlarda bu metodun loadTimeout içinde belirtilenden biraz daha geç zaman aşımına uğrayabileceğini unutmayın; zira işlem arka planda farklı isteklerden oluşabilir. Android için: TimeInterval’ı uzantı işlevleriyle oluşturabilirsiniz (örneğin 5.seconds; burada .seconds, import com.adapty.utils.seconds kaynağından gelir) ya da TimeInterval.seconds(5) kullanabilirsiniz. Sınırlama koymamak için TimeInterval.INFINITE kullanın.

Yanıt parametreleri:

Parametre	Açıklama
Paywall	Ürün ID’lerinin listesini, paywall tanımlayıcısını, remote config’i ve diğer birkaç özelliği içeren bir AdaptyPaywall nesnesi.

Paywall Builder kullanılarak tasarlanan paywallın görünüm yapılandırmasını çekme

Paywall’u çektikten sonra, Paywall Builder kullanılarak oluşturulduğunu gösteren bir ViewConfiguration içerip içermediğini kontrol edin. Bu, paywallı nasıl görüntüleyeceğiniz konusunda size rehberlik edecektir. ViewConfiguration mevcutsa, bunu bir Paywall Builder paywall’u olarak ele alın; değilse, bunu bir remote config paywall’u olarak işleyin.

React Native SDK’da, görünüm yapılandırmasını manuel olarak önceden çekmeden doğrudan createPaywallView metodunu çağırın.

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

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

Parametreler:

Parametre	Zorunluluk	Açıklama
paywall	zorunlu	İstenen paywall için bir controller almak üzere kullanılan AdaptyPaywall nesnesi.
customTags	isteğe bağlı	Özel etiketlerin ve çözümlenmiş değerlerinin bir sözlüğünü tanımlar. Özel etiketler, paywall içeriğinde yer tutucu olarak kullanılır ve paywall içinde kişiselleştirilmiş içerik sağlamak amacıyla belirli dizelerle dinamik olarak değiştirilir. Daha fazla ayrıntı için Paywall Builder’da Özel Etiketler konusuna bakın.
prefetchProducts	isteğe bağlı	Ekrandaki ürünlerin görüntülenme zamanlamasını optimize etmek için etkinleştirin. true olarak ayarlandığında AdaptyUI, gerekli ürünleri otomatik olarak getirir. Varsayılan: false.

Görünümü elde ettikten sonra paywall’ı gösterin.

Daha hızlı çekmek için varsayılan kitle için paywall alma

Genellikle paywalllar neredeyse anında çekilir, dolayısıyla bu süreci hızlandırma konusunda endişelenmenize gerek yoktur. Ancak çok sayıda kitle ve paywallınız olduğu ve kullanıcılarınızın zayıf bir internet bağlantısına sahip olduğu durumlarda, bir paywall çekmek istediğinizden daha uzun sürebilir. Bu gibi durumlarda, hiç paywall göstermemek yerine sorunsuz bir kullanıcı deneyimi sağlamak için varsayılan bir paywall görüntülemek isteyebilirsiniz.

Bunu çözmek için, belirtilen placement’ın paywallını Tüm Kullanıcılar kitlesi için çeken getPaywallForDefaultAudience metodunu kullanabilirsiniz. Ancak önerilen yaklaşımın, yukarıdaki Paywall Bilgilerini Çekme bölümünde ayrıntılandırıldığı gibi getPaywall metoduyla paywall çekmek olduğunu anlamak önemlidir.

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

    const paywall = await adapty.getPaywallForDefaultAudience(id, locale);
  // the requested paywall
} catch (error) {
    // handle the error
}

Parametre	Zorunluluk	Açıklama
placementId	zorunlu	Placement’ın tanımlayıcısı. Bu, Adapty Kontrol Paneli’nde bir placement oluştururken belirttiğiniz değerdir.
locale	isteğe bağlı varsayılan: en	Paywall yerelleştirmesinin tanımlayıcısı. Bu parametrenin, eksi (-) karakteriyle ayrılmış bir veya daha fazla alt etiketten oluşan bir dil kodu olması beklenir. İ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ı konusuna bakın.
fetchPolicy	varsayılan: .reloadRevalidatingCacheData	Varsayılan olarak SDK, sunucudan veri yüklemeye çalışır ve başarısızlık durumunda önbelleğe alınmış verileri döndürür. Kullanıcılarınızın her zaman en güncel verilere sahip olmasını sağladığı için bu seçeneği öneriyoruz. Ancak kullanıcılarınızın kararsız bir internetle karşılaştığını düşünüyorsanız, önbellekte veri varsa önbelleğe alınmış verileri döndürmek için .returnCacheDataElseLoad kullanmayı düşünün. Bu senaryoda kullanıcılar en güncel verileri alamayabilir, ancak internet bağlantıları 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 için 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 yoluyla silindiğini unutmayın.

Varlıkları özelleştirme

Paywallınızdaki görselleri ve videoları özelleştirmek için özel varlıkları uygulayın.

Hero görselleri ve videolarının önceden tanımlanmış ID’leri vardır: hero_image ve hero_video. Özel bir varlık paketinde, bu öğeleri ID’leri aracılığıyla hedefler ve davranışlarını özelleştirirsiniz.

Diğer görseller ve videolar için Adapty kontrol panelinde özel bir ID ayarlamanız gerekir.

Örneğin şunları yapabilirsiniz:

• Bazı kullanıcılara farklı bir görsel veya video gösterme.
• Uzak ana görsel yüklenirken yerel bir önizleme görseli gösterme.
• Bir video çalıştırmadan önce önizleme görseli gösterme.

Özel asset’leri basit bir sözlük aracılığıyla nasıl sağlayabileceğinize dair bir örnek:

const customAssets: Record<string, AdaptyCustomAsset> = {
  'custom_image': { type: 'image', relativeAssetPath: 'custom_image.png' },
  'hero_video': {
    type: 'video',
    fileLocation: {
      ios: { fileName: 'custom_video.mp4' },
      android: { relativeAssetPath: 'videos/custom_video.mp4' }
    }
  }
};

view = await createPaywallView(paywall, { customAssets })