Paywall zamanlayıcısı

Paywall zamanlayıcısı, süreli özel ve sezonluk teklifleri tanıtmak için harika bir araçtır. Ancak şunu belirtmek gerekir: bu zamanlayıcı, teklifin geçerlilik süresiyle veya kampanyanın süreciyle bağlantılı değildir. Yalnızca belirlediğiniz değerden başlayıp sıfıra kadar inen bağımsız bir geri sayımdır. Zamanlayıcı sıfıra ulaştığında hiçbir şey olmaz—sadece sıfırda kalır.

Paywall zamanlayıcıları yalnızca iOS, Android ve React Native SDK’larının 3.0 veya üzeri sürümleriyle, Flutter ve Unity SDK’larının ise 3.3.0 veya üzeri sürümleriyle çalışan yeni Paywall Builder’da kullanılabilir. Adapty SDK v2.x veya önceki sürümlere sahip eski Paywall Builder, paywall zamanlayıcı işlevselliğini desteklemez.

Zamanlayıcının önüne ve arkasına istediğiniz mesajı oluşturmak için metin ekleyebilirsiniz; örneğin: “Teklif sona eriyor: 10:00 sn.”

Zamanlayıcıyı bir paywall’a veya kart gibi başka bir paywall öğesine ayrı bir öğe olarak ekleyin.
Zamanlayıcının ayarlarını yapılandırın: format ve ayraç, başlangıç değeri, öncesindeki ve sonrasındaki metin (gerekirse), renk, yazı tipi, boşluk vb.

Zamanlayıcı modu

Timer mode parametresini kullanarak kullanıcılar zamanlayıcıyı gördüğünde nasıl davrandığını kontrol edebilirsiniz. Kutudan çıktığı gibi çalışan 3 standart mod mevcuttur; açılır listeden istediğiniz seçeneği seçmeniz yeterlidir:

Mod	Açıklama
Reset timer on every paywall view	Kullanıcı paywalli her görüntülediğinde zamanlayıcı sıfırlanır ve her seferinde başlangıç değerinden başlar.
Reset timer on every app launch	Zamanlayıcı, kullanıcının paywalli ilk gördüğünde başlar ve uygulama yeniden başlatılana kadar ön planda veya arka planda saymaya devam eder. Kullanıcı aynı oturumda paywalli birden fazla kez görürse, geri sayan aynı zamanlayıcıyı görür. Uygulama kapatıldığında zamanlayıcı sıfırlanır ve uygulama bir sonraki açılışında baştan başlar.
Keep timer across app launches	Zamanlayıcı, kullanıcının paywalli ilk gördüğünde başlar ve uygulama kapatılsa bile ön planda veya arka planda saymaya devam eder. Kullanıcı, uygulama veya paywall yeniden başlatılmalarından bağımsız olarak paywalle her döndüğünde aynı zamanlayıcıyı görür.
Developer defined	Herhangi bir zamanlayıcıyı doğrudan mobil uygulama kodunuzda kurabilirsiniz. Önce bir Timer ID girin, ardından zamanlayıcıyı istediğiniz şekilde yapılandırmak için Mobil uygulamanızda geliştirici tanımlı zamanlayıcılar nasıl kurulur bölümünde açıklandığı gibi kodunuzda kullanın.

Zamanlayıcı sona erdiğinde ne olur?

Zamanlayıcı sona erdiğinde ne olacağını özelleştirebilirsiniz. Yeni bir fırsat sunmak için başka bir ekran mı gösterilsin? Yoksa farklı bir paywall mi açılsın? Biraz kod yazmanız gerekiyor, ancak dokümanlarımızla bunu kolayca halledebilirsiniz.

Trigger custom action when the timer runs out geçiş düğmesini açın.

Tetiklemek istediğiniz aksiyonun ID’sini Timer action ID alanına girin.
Zamanlayıcı sona erdiğinde ne olması gerektiğini tanımlamak için bu action ID’yi uygulamanızda kullanın. Bunu, iOS ve Android için Olayları İşleme: Eylemler kılavuzumuzda açıklandığı gibi, diğer özel eylemler gibi değerlendirin.

Mobil uygulamanızda geliştirici tanımlı zamanlayıcılar nasıl kurulur?

Mobil uygulamanızda özel zamanlayıcılar kullanmak için AdaptyTimerResolver protokolünü izleyen bir nesne oluşturun. Bu nesne, her özel zamanlayıcının nasıl render edileceğini tanımlar. İsterseniz, bu protokole zaten uygun olduğundan [String: Date] sözlüğünü doğrudan kullanabilirsiniz. İşte bir örnek:

@MainActor
struct AdaptyTimerResolverImpl: AdaptyTimerResolver {
    func timerEndAtDate(for timerId: String) -> Date {
        switch timerId {
        case "CUSTOM_TIMER_6H":
            Date(timeIntervalSinceNow: 3600.0 * 6.0) // 6 saat
        case "CUSTOM_TIMER_NY":
            Calendar.current.date(from: DateComponents(year: 2025, month: 1, day: 1)) ?? Date(timeIntervalSinceNow: 3600.0)
        default:
            Date(timeIntervalSinceNow: 3600.0) // 1 saat
        }
    }
}

Bu örnekte, CUSTOM_TIMER_NY ve CUSTOM_TIMER_6H, Adapty Kontrol Paneli’nde ayarladığınız geliştirici tanımlı zamanlayıcıların Timer ID’leridir. timerResolver, uygulamanızın her zamanlayıcıyı doğru değerle dinamik olarak güncellemesini sağlar. Örneğin:

CUSTOM_TIMER_NY: Yılbaşı gibi zamanlayıcının bitiş anına kadar kalan süre.
CUSTOM_TIMER_6H: Kullanıcının paywall’ı açtığı andan itibaren başlayan 6 saatlik sürede kalan zaman.


...

val customTimers = mapOf(
    "CUSTOM_TIMER_NY" to Calendar.getInstance(TimeZone.getDefault()).apply { set(2025, 0, 1) }.time, // Yeni Yıl 2025
)
val timerResolver = AdaptyUiTimerResolver { timerId ->
    customTimers.getOrElse(timerId, { Date(System.currentTimeMillis() + 3600 * 1000L) /* 1 saat içinde */ } )
}

Bu örnekte, CUSTOM_TIMER_NY Adapty kontrol panelinde ayarladığınız geliştirici tanımlı zamanlayıcının Timer ID’sidir. timerResolver, uygulamanızın zamanlayıcıyı doğru değerle—örneğin 13d 09h 03m 34s (zamanlayıcının bitiş zamanı olan Yılbaşı’ndan mevcut zamanın çıkarılmasıyla hesaplanan)—dinamik olarak güncellemesini sağlar.


...

Map<String, Date> customTimers = new HashMap<>();
customTimers.put(
        "CUSTOM_TIMER_NY",
        new Calendar.Builder().setTimeZone(TimeZone.getDefault()).setDate(2025, 0, 1).build().getTime()
);
AdaptyUiTimerResolver timerResolver = new AdaptyUiTimerResolver() {
    @NonNull
    @Override
    public Date timerEndAtDate(@NonNull String timerId) {
        Date date = customTimers.get(timerId);
        return date != null ? date : new Date(System.currentTimeMillis() + 3600 * 1000L); /* 1 saat sonra */
    }
};

Bu örnekte, CUSTOM_TIMER_NY, Adapty kontrol panelinde ayarladığınız geliştirici tanımlı zamanlayıcının Timer ID’sidir. timerResolver, uygulamanızın zamanlayıcıyı doğru değerle (örneğin Yılbaşı gibi zamanlayıcının bitiş zamanından mevcut zamanın çıkarılmasıyla hesaplanan 13d 09h 03m 34s) dinamik olarak güncellemesini sağlar.

try {
      final view = await AdaptyUI().createPaywallView(
        paywall: paywall,
        customTags: ...,
        customTimers: {
          'CUSTOM_TIMER_6H': DateTime.now().add(const Duration(seconds: 3600 * 6)),
          'CUSTOM_TIMER_NY': DateTime(2025, 1, 1), // New Year 2025
        },
        preloadProducts: ...,
      );
    } on AdaptyError catch (e) {
      // handle the error
    } catch (e) {
      // handle the error
    }

CUSTOM_TIMER_NY: Zamanlayıcının bitiş anına, örneğin Yılbaşı’na kadar kalan süre.
CUSTOM_TIMER_6H: Kullanıcının paywall’ı açtığı andan itibaren başlayan 6 saatlik sürede kalan zaman.

var parameters = new AdaptyUICreateViewParameters()
  .SetCustomTimers(
    new Dictionary<string, DateTime> {
      { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) }, // 6 saat
      { "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) } // Yeni Yıl 2025
    }
  )

AdaptyUI.CreateView(paywall, parameters, (view, error) => {
  // sonucu işle
});

Bu örnekte, CUSTOM_TIMER_NY ve CUSTOM_TIMER_6H, Adapty Kontrol Paneli’nde ayarladığınız geliştirici tanımlı zamanlayıcıların Timer ID’leridir. timerResolver, uygulamanızın her zamanlayıcıyı doğru değerle dinamik olarak güncellemesini sağlar. Örneğin:
- CUSTOM_TIMER_NY: Yeni Yıl gibi zamanlayıcının bitiş anına kalan süre.
- CUSTOM_TIMER_6H: Kullanıcının paywall’ı açtığı andan itibaren başlayan 6 saatlik sürede kalan zaman.

let customTimers = { 'CUSTOM_TIMER_NY': new Date(2025, 0, 1) }
//and then you can pass it to createPaywallView as follows:
view = await createPaywallView(paywall, { customTimers })

Bu örnekte, CUSTOM_TIMER_NY, Adapty kontrol panelinde ayarladığınız geliştirici tanımlı zamanlayıcının Timer ID’sidir. timerResolver, uygulamanızın zamanlayıcıyı doğru değerle dinamik olarak güncellemesini sağlar; örneğin 13d 09h 03m 34s gibi (zamanlayıcının bitiş zamanından, Yeni Yıl günü gibi, mevcut zamanın çıkarılmasıyla hesaplanır).