Flutter SDK'da flow ve paywall çekme işlemini optimize etme

Flutter’da güvenilir bir flow veya paywall çekme işlemi üç şeyi başarır: hızlı render eder, kitleye özel varyantı döndürür ve ağ yavaş olduğunda sorunsuz bir şekilde yedekleme yapar. Aşağıdaki kurallar, bunu sağlamak için zamanlama, önbellekleme ve yedek desenleri kapsar.

Tip

Bu kurallar, Adapty().activate() ve Adapty().identify() fonksiyonlarının zaten tamamlandığını varsayar. Bkz. Flutter SDK’da çağrı sırası.

Kurallar ve dikkat edilmesi gereken noktalar

Bunu yapınBunu yapmayınNeden
Göstermek üzere olduğunuz placement’ı getirin veya önbelleği preloadFlows ile ısıtın (SDK 4.3.0+).Başlangıçta kendi paralel getFlow çağrılarınızı yayın.El yapımı bir prefetch patlaması ana thread’i bloke eder ve siyah ekrana yol açar. preloadFlows bunun için tasarlanmıştır ve toplu isteği tek bir çağrıyla native SDK’ya gönderir.
getFlow’u attribution’ın çözüme kavuşmasına fırsat tanıdıktan sonra getirin — örneğin activate’ten 1–2 saniye sonra veya didUpdateProfileStream tetiklendikten sonra.getFlow’u runApp’ten önce main() içinde çağırın.Attribution henüz gelmemiştir. Flow varsayılan kitle üzerinden çözümlenir ve segmentleri ile ASA kişiselleştirmesini sessizce atlar.
Her placement için bir loadTimeout ayarlayın ve bir yedek paywall yapılandırın.getFlow’u süresiz olarak bekleyin.Zaman aşımı olmadan, bağlantısı zayıf kullanıcılar ağ çözümlenene kadar boş bir ekran görür — ya da uygulamayı kapatır.

Özel paywalllar ve ürünleri getirme hakkında daha fazla bilgi için fetchPolicy ve loadTimeout parametre referansına Özel paywallları ve ürünleri getirme sayfasından, doğru placement seçimi için Placement’lar sayfasından ulaşabilirsiniz.

Placement’ları önceden yükle

Info

preloadFlows ve preloadFlowsForDefaultAudience, SDK 4.3.0 sürümünden itibaren kullanılabilir.

preloadFlows, flow JSON’ını önceden önbelleğe alır. Ardından her zamanki gibi kullanırsınız: flow için getFlow, görünümü için createFlowView.

fetchPolicy, sonraki bir getFlow çağrısının hangi katmanı önce okuyacağını belirler; önbelleğe erişip erişemeyeceğini değil:

  • AdaptyFlowFetchPolicy.returnCacheDataElseLoad önce önceden yüklenmiş kopyayı okur ve yalnızca önbellekte hiçbir şey yoksa ağa gider. AdaptyFlowFetchPolicy.returnCacheDataIfNotExpiredElseLoad(maxAge) kopya maxAge değerinden daha yeni olduğu sürece aynı şekilde davranır.
  • Varsayılan olan AdaptyFlowFetchPolicy.reloadRevalidatingCacheData önce ağa gider; istek başarısız olursa veya zaman aşımına uğrarsa önceden yüklenmiş kopyaya döner.

Bir ön yükleme her durumda işe yarar, ama farklı biçimlerde: cache-first politikası isteği tamamen ortadan kaldırırken, varsayılan politika isteği koruyup üzerine sıcak bir kopya ekler. Bir test cihazında getFlow, her politikada önbelleği atlar ve yalnızca ağ isteği başarısız olursa ön yüklenmiş kopyayı kullanır.

Oturumun hangi placement’lara ihtiyaç duyacağını bildiğinizde ama henüz göstermek istemediğinizde kullanın — örneğin activate ve identify tamamlandıktan hemen sonra, kullanıcının henüz dokunmadığı bir düğmenin arkasındaki flow için.

try {
  await Adapty().preloadFlows(
    placementIds: ['onboarding', 'main_paywall'],
    loadTimeout: const Duration(seconds: 5),
  );
} on AdaptyError catch (adaptyError) {
  // en az bir placement yüklenemedi
}

// Daha sonra, kullanıcı paywalla ulaştığında:
final flow = await Adapty().getFlow(
  placementId: 'main_paywall',
  fetchPolicy: AdaptyFlowFetchPolicy.returnCacheDataElseLoad,
);

Parametreler:

  • placementIds (zorunlu): önceden yüklenecek placement’lar.
  • loadTimeout (isteğe bağlı): kitleye göre hedeflenmiş flow’ların önceden yüklenmesi için bekleme süresi. Varsayılan değer 5 saniyedir; 1 saniyenin altındaki değerler 1 saniyeye yükseltilir. Zaman aşımına ulaşıldığında SDK, varsayılan kitle flow’larını yükleyebilir.

Bilinmesi gereken davranışlar:

  • Çağrı yalnızca tüm placement’lar denendikten sonra başarısız olur; başarısız olan tüm placement’ları kapsayan tek bir AdaptyError döner. Bir placement’ın başarısız olması diğerlerini durdurmaz, yüklenen placement’lar önbellekte kalır.
  • Preloading her zaman ağa gider: kendine ait bir fetchPolicy yoktur.
  • Preloading yalnızca önbelleği ısıtır. İçerik döndürmez — görüntülemek için yine getFlow çağırmanız gerekir.

Ön yüklemenin kapsadığı alan

Bir flow ekrana katman katman ulaşır. Ön yükleme, tıpkı getFlow’un yaptığı gibi yalnızca ilk katmanı kapsar:

KatmanKim getirirÖn yüklemeyle ısıtılır mı
Flow JSON — seçilen varyant, ürün ID’leri ve remote configgetFlowEvet
UI düzeni — ekranın yapısı, stili ve metnicreateFlowViewHayır
Görseller, bir video öğesinin yerine geçen sabit kare dahilcreateFlowView, arka plandaHayır
ÜrünlercreateFlowView veya getPaywallProductsHayır
Video dosyalarıSistem oynatıcısı, ekran oluşturulurkenSDK tarafından önbelleğe alınmaz

Yani belirli bir layout için ilk createFlowView çağrısı, bir ön yükleme sonrasında bile yine de bir round trip gerektirir. Native SDK daha sonra bu layout’u disk önbelleğinde tutar; bu önbellek uygulama yeniden başlatmalarından sonra da geçerliliğini korur. Dolayısıyla bu maliyet her istekte değil, yalnızca ilk istekte oluşur.

Kitle segmentasyonunu atla

Önbelleği, kitle segmentasyonunu hiç beklemeden ısıtmak için varsayılan kitle varyantını kullanın. Bu seçenek timeout almaz:

await Adapty().preloadFlowsForDefaultAudience(placementIds: ['main_paywall']);

Daha sonra çağrılan getFlowForDefaultAudience, kopyayı getFlow’un bir preloadFlows kopyasını okuduğu şekilde okur.

İlk ekran medyasını uygulama paketinden göster

Bir flow, resimlerini ve videolarını Adapty’den indirir. İlk ekranın medyasını anında göstermek için bunu uygulama paketinden sunun. Bu, zaten gönderdiğiniz medyayı yeniden kullanmanın iyi bir yoludur; örneğin mevcut bir native onboarding’in görsellerini bu şekilde değerlendirebilirsiniz.

  1. Flow & Paywall Builder’da, görsel veya videoya özel medya kimliği ayarlayın. Oraya yüklediğiniz dosya yedek olarak kalır.
  2. Dosyayı Flutter asset’lerinize ekleyin ve pubspec.yaml dosyasındaki assets bölümüne listeleyin.
  3. Flow görünümünü oluştururken, customAssets içinde o kimliğe ait paketlenmiş dosyayı geçirin:
// "welcome_video", Flow & Paywall Builder'da ayarlanan özel medya ID'sidir
final bundledAssets = {
  'welcome_video': AdaptyCustomAsset.localVideoAsset(
    assetId: 'assets/videos/welcome.mp4',
  ),
};

try {
  final view = await AdaptyUI().createFlowView(
    flow: flow,
    customAssets: bundledAssets,
  );
} on AdaptyError catch (e) {
  // hatayı işle
}

Paketlenmiş dosyalar uygulamanızın indirme boyutunu artırır; bu nedenle yalnızca kullanıcıların ilk gördüğü medyayı paketleyin.

Paketlemediğiniz medya yine de hemen görünür: flow’un düzeni, her görselin küçük düşük çözünürlüklü bir kopyasını (video için de bir sabit kare dahil) içerir ve tam dosya yüklenene kadar bunu gösterir.

customAssets referansının tamamı için bkz. Varlıkları özelleştirme.

Zayıf bağlantı için ayarlama

Sürekli zayıf bağlantının yaşandığı pazarlar için (kırsal alanlar, transit bölgeler, yönlendirme sorunları yaşanan bölgeler):

  • İlk fetch hariç her fetch işleminde fetchPolicy: AdaptyFlowFetchPolicy.returnCacheDataElseLoad kullanın.
  • Adapty Kontrol Paneli’nde her placement için bir yedek paywall yapılandırın.
  • loadTimeout değerini 3–5 saniye olarak ayarlayın ve zaman aşımı gerçekleştiğinde yedek paywalla geçin.
  • Flow gösterimini getProfile() sonucuna bağlamayın. Yavaş bir profilin arayüzü bloke etmemesi için getFlow işlevini bağımsız olarak çağırın.