Flutter SDK'da remote config ile tasarlanan paywallı render etme

Remote config kullanarak bir paywall özelleştirdiyseniz, bunu kullanıcılara göstermek için mobil uygulamanızın koduna render işlemi eklemeniz gerekir. Remote config, ihtiyaçlarınıza göre esneklik sunduğundan, paywall görünümünüzde nelerin yer alacağını ve nasıl görüneceğini siz belirlersiniz. Remote config aracılığıyla yapılandırılmış özel paywall’ınızı göstermek için remote config’i çekme yöntemi sunuyoruz; nasıl kullanacağınız tamamen size kalmış.

Paywall remote config’ini alın ve gösterin

v4’te flow, remoteConfigs listesi taşır — yapılandırılmış her yerelleştirme için bir remote config. Kullanıcının yerel ayarıyla eşleşen girişi seçin ve gerekli değerleri çıkarın. Doğru yerelleştirmeyi seçmek için Yerelleştirmeler ve yerel ayar kodları bölümüne bakın.


try {
  final flow = await Adapty().getFlow(placementId: 'YOUR_PLACEMENT_ID');

  // one entry per configured localization; fall back to the first one
  final config = flow.remoteConfigs.firstWhereOrNull((c) => c.locale == 'en') ??
      flow.remoteConfig;

  final String? headerText = config?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

Bu noktada, gerekli tüm değerleri aldıktan sonra bunları görsel açıdan çekici bir sayfada render etme ve bir araya getirme zamanı gelmiştir. Tasarımın farklı mobil telefon ekranlarına ve yönlendirmelerine uyum sağladığından emin olun; böylece farklı cihazlarda sorunsuz ve kullanıcı dostu bir deneyim sunulur.

Adapty analytics’in huniler ve A/B testleri için bilgi toplayabilmesi amacıyla, aşağıda açıklandığı şekilde paywall görüntüleme olayını kaydettiğinizden emin olun.

Paywallı görüntülemeyi tamamladıktan sonra satın alma akışını kurmaya devam edin. Kullanıcı bir satın alma yaptığında, paywallınızdaki ürünle birlikte .makePurchase() metodunu çağırmanız yeterlidir. .makePurchase() metodu hakkında ayrıntılı bilgi için Satın alma yapma sayfasını okuyun.

Yedek paywall adı verilen bir yedek paywall oluşturmanızı öneririz. Bu yedek, internet bağlantısı olmadığında veya önbellek mevcut olmadığında kullanıcıya gösterilecek ve bu durumlarda bile sorunsuz bir deneyim sağlayacaktır.

Paywall görüntüleme olaylarını takip edin

Adapty, paywall’larınızın performansını ölçmenize yardımcı olur. Satın alma verilerini otomatik olarak toplasak da, paywall görüntüleme olaylarını kaydetmek sizin müdahalenizi gerektiriyor; çünkü bir kullanıcının paywall’ı ne zaman gördüğünü yalnızca siz bilebilirsiniz.

Bir paywall görüntüleme olayı kaydetmek için .logShowFlow(flow: flow) metodunu çağırmanız yeterli; bu işlem, funnel’larınızdaki ve A/B testlerinizdeki paywall metriklerinize yansıyacaktır.

Builder ile oluşturulan flow’ları veya paywall’ları görüntülüyorsanız .logShowFlow(flow: flow) çağrısı yapmanıza gerek yoktur.

try {
  await Adapty().logShowFlow(flow: flow);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
  // handle the error
}

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
flow	zorunlu	Bir `AdaptyFlow` nesnesi.

Remote config kullanarak bir paywall özelleştirdiyseniz, kullanıcılara göstermek için mobil uygulamanızın kodunda görüntüleme işlemini kendiniz uygulamanız gerekir. Remote config ihtiyaçlarınıza göre esneklik sunduğundan, paywalla nelerin dahil edileceğini ve görünümünün nasıl olacağını tamamen siz belirlersiniz. Remote config aracılığıyla yapılandırılmış özel paywallınızı göstermek için uzak yapılandırmayı çekmenizi sağlayan bir metot sunuyoruz.

Paywall remote config’ini alın ve gösterin

Bir paywallın remote config’ini almak için remoteConfig özelliğine erişin ve gerekli değerleri çıkarın.

try {
  final paywall = await Adapty().getPaywall(placementId: "YOUR_PLACEMENT_ID");
  final String? headerText = paywall.remoteConfig?.dictionary?['header_text'] as String?;
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

Bu noktada, gerekli tüm değerleri aldıktan sonra bunları görsel açıdan çekici bir sayfada render etme ve bir araya getirme zamanı gelmiştir. Tasarımın farklı mobil telefon ekranlarına ve yönlendirmelerine uyum sağladığından emin olarak farklı cihazlarda sorunsuz ve kullanıcı dostu bir deneyim sunun.

Adapty analitiğinin huni ve A/B testi için bilgileri yakalayabilmesi amacıyla aşağıda açıklandığı şekilde paywall görüntüleme olayını kaydettiğinizden emin olun.

Paywalli görüntüledikten sonra, satın alma akışını ayarlamaya devam edin. Kullanıcı bir satın alma işlemi yaptığında, paywallınızdaki ürünle birlikte .makePurchase() metodunu çağırmanız yeterlidir. .makePurchase() metodu hakkında ayrıntılı bilgi için Satın alma yapma bölümünü okuyun.

Yedek paywall adı verilen bir yedek paywall oluşturmanızı öneririz. Bu yedek, internet bağlantısı olmadığında veya önbellek mevcut olmadığında kullanıcıya gösterilerek bu durumlarda bile sorunsuz bir deneyim sağlar.

Paywall görüntüleme etkinliklerini takip edin

Adapty, paywalllarınızın performansını ölçmenize yardımcı olur. Satın almalara ilişkin verileri otomatik olarak toplasak da, paywall görüntülemelerini kaydetmek sizin müdahalenizi gerektirir; çünkü bir müşterinin paywallı ne zaman gördüğünü yalnızca siz bilirsiniz.

Bir paywall görüntüleme etkinliğini kaydetmek için .logShowPaywall(paywall) metodunu çağırmanız yeterlidir; bu işlem huni ve A/B testlerindeki paywall metriklerinize yansıyacaktır.

Paywall builder ile oluşturulan paywallları görüntülüyorsanız .logShowPaywall(paywall) çağrısı yapmanıza gerek yoktur.

try {
  final result = await Adapty().logShowPaywall(paywall: paywall);
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

İstek parametreleri:

Parametre	Zorunluluk	Açıklama
paywall	zorunlu	Bir `AdaptyPaywall` nesnesi.