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.
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ın | Bunu yapmayın | Neden |
|---|---|---|
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
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)kopyamaxAgedeğ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
AdaptyErrordö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
fetchPolicyyoktur. - 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:
| Katman | Kim getirir | Ön yüklemeyle ısıtılır mı |
|---|---|---|
| Flow JSON — seçilen varyant, ürün ID’leri ve remote config | getFlow | Evet |
| UI düzeni — ekranın yapısı, stili ve metni | createFlowView | Hayır |
| Görseller, bir video öğesinin yerine geçen sabit kare dahil | createFlowView, arka planda | Hayır |
| Ürünler | createFlowView veya getPaywallProducts | Hayır |
| Video dosyaları | Sistem oynatıcısı, ekran oluşturulurken | SDK 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.
- Flow & Paywall Builder’da, görsel veya videoya özel medya kimliği ayarlayın. Oraya yüklediğiniz dosya yedek olarak kalır.
- Dosyayı Flutter asset’lerinize ekleyin ve
pubspec.yamldosyasındakiassetsbölümüne listeleyin. - Flow görünümünü oluştururken,
customAssetsiç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.returnCacheDataElseLoadkullanın. - Adapty Kontrol Paneli’nde her placement için bir yedek paywall yapılandırın.
loadTimeoutdeğ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çingetFlowişlevini bağımsız olarak çağırın.