Таймер пейвола

Таймер пейвола — отличный инструмент для продвижения специальных и сезонных предложений с ограниченным сроком действия. Важно учитывать, что этот таймер никак не связан с реальным сроком действия предложения или длительностью кампании. Это просто обратный отсчёт, который стартует с заданного вами значения и уменьшается до нуля. Когда таймер достигает нуля, ничего не происходит — он просто остаётся на нуле.

Таймеры пейвола доступны только в новом Paywall Builder, который работает с iOS, Android и React Native SDK версии 3.0 и выше, а также Flutter и Unity SDK версии 3.3.0 и выше. Устаревший Paywall Builder с Adapty SDK v2.x и ниже не поддерживает функциональность таймеров пейвола.

Вы можете настроить текст до и после таймера, чтобы сформировать нужное сообщение, например: «Предложение заканчивается через: 10:00 сек.»

Добавьте таймер как отдельный элемент на пейвол или внутрь другого элемента, например карточки.
Настройте параметры таймера: формат и разделитель, начальное значение, текст до и после (если нужно), цвет, шрифт, отступы и т. д.

Режим таймера

Управляйте поведением таймера для пользователей с помощью параметра Timer mode. Три стандартных режима работают сразу без дополнительной настройки — просто выберите нужный вариант из выпадающего списка:

Режим	Описание
Reset timer on every paywall view	Таймер сбрасывается каждый раз, когда пользователь видит пейвол, и каждый раз начинает отсчёт с начального значения.
Reset timer on every app launch	Таймер запускается, когда пользователь впервые видит пейвол, и продолжает отсчёт на переднем плане и в фоне до перезапуска приложения. Если пользователь видит пейвол несколько раз в одной сессии, он увидит один и тот же таймер в процессе обратного отсчёта. После закрытия приложения таймер сбрасывается, и при следующем открытии приложения отсчёт начинается заново.
Keep timer across app launches	Таймер запускается, когда пользователь впервые видит пейвол, и продолжает отсчёт на переднем плане и в фоне, даже если приложение закрыто. При каждом возврате к пейволу пользователь видит тот же таймер — независимо от перезапуска приложения или пейвола.
Developer defined	Вы можете настроить любой таймер прямо в коде мобильного приложения. Введите Timer ID, а затем используйте его в коде согласно инструкции в разделе Как настроить таймеры в коде мобильного приложения.

Что происходит, когда таймер заканчивается?

Вы можете настроить, что произойдёт, когда таймер истечёт. Показать другой экран с новым предложением? Или переключить пользователя на другой пейвол? Это потребует немного кода, но с нашей документацией вы легко с этим справитесь.

Включите переключатель Trigger custom action when the timer runs out.

Введите ID действия, которое нужно вызвать, в поле Timer action ID.
Используйте этот action ID в приложении, чтобы определить, что должно произойти по истечении таймера. Обращайтесь с ним как с любым другим пользовательским действием, как описано в нашем гайде Обработка событий: Действия для iOS и Android.

Как настроить пользовательские таймеры в мобильном приложении?

Чтобы использовать кастомные таймеры в мобильном приложении, создайте объект, реализующий протокол AdaptyTimerResolver. Этот объект определяет, как должен отображаться каждый кастомный таймер. Если хотите, можно использовать словарь [String: Date] напрямую — он уже соответствует этому протоколу. Пример:

@MainActor
struct AdaptyTimerResolverImpl: AdaptyTimerResolver {
    func timerEndAtDate(for timerId: String) -> Date {
        switch timerId {
        case "CUSTOM_TIMER_6H":
            Date(timeIntervalSinceNow: 3600.0 * 6.0) // 6 часов
        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 час
        }
    }
}

В этом примере CUSTOM_TIMER_NY и CUSTOM_TIMER_6H — это Timer ID таймеров, заданных разработчиком в дашборде Adapty. timerResolver обеспечивает динамическое обновление каждого таймера в приложении с нужным значением. Например:

CUSTOM_TIMER_NY: время, оставшееся до окончания таймера, например до Нового года.
CUSTOM_TIMER_6H: время, оставшееся в 6-часовом периоде, который начался, когда пользователь открыл пейвол.


...

val customTimers = mapOf(
    "CUSTOM_TIMER_NY" to Calendar.getInstance(TimeZone.getDefault()).apply { set(2025, 0, 1) }.time, // Новый год 2025
)
val timerResolver = AdaptyUiTimerResolver { timerId ->
    customTimers.getOrElse(timerId, { Date(System.currentTimeMillis() + 3600 * 1000L) /* через 1 час */ } )
}

В этом примере CUSTOM_TIMER_NY — это Timer ID таймера, заданного разработчиком в дашборде Adapty. timerResolver гарантирует, что приложение динамически обновляет таймер с правильным значением — например, 13d 09h 03m 34s (рассчитывается как время окончания таймера, например Новый год, минус текущее время).


...

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 час */
    }
};

В этом примере CUSTOM_TIMER_NY — это Timer ID таймера, заданного разработчиком в дашборде Adapty. timerResolver гарантирует, что приложение динамически обновляет таймер с корректным значением — например, 13d 09h 03m 34s (вычисляется как время окончания таймера, например Новый год, минус текущее время).

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 и CUSTOM_TIMER_6H — это Timer ID таймеров, заданных разработчиком в дашборде Adapty. timerResolver обеспечивает динамическое обновление каждого таймера корректным значением. Например:

CUSTOM_TIMER_NY: время, оставшееся до окончания таймера, например до Нового года.
CUSTOM_TIMER_6H: время, оставшееся в 6-часовом периоде, который начался, когда пользователь открыл пейвол.

var parameters = new AdaptyUICreateViewParameters()
  .SetCustomTimers(
    new Dictionary<string, DateTime> {
      { "CUSTOM_TIMER_6H", DateTime.Now.AddHours(6) }, // 6 часов
      { "CUSTOM_TIMER_NY", new DateTime(2025, 1, 1) } // Новый год 2025
    }
  )

AdaptyUI.CreateView(paywall, parameters, (view, error) => {
  // обработайте результат
});

В этом примере CUSTOM_TIMER_NY и CUSTOM_TIMER_6H — это Timer ID пользовательских таймеров, заданных в дашборде Adapty. timerResolver гарантирует, что приложение динамически обновляет каждый таймер корректным значением. Например:
- CUSTOM_TIMER_NY: время, оставшееся до окончания таймера, например до Нового года.
- CUSTOM_TIMER_6H: время, оставшееся в 6-часовом периоде, который начался, когда пользователь открыл пейвол.

В этом примере CUSTOM_TIMER_NY — это Timer ID таймера, заданного разработчиком в дашборде Adapty. timerResolver гарантирует динамическое обновление таймера с правильным значением — например, 13d 09h 03m 34s (вычисляется как разница между временем окончания таймера, например Новым годом, и текущим временем).