Отображение пейвола на основе Remote Config в Flutter SDK

Если вы настроили пейвол с помощью Remote Config, вам нужно реализовать его отображение в коде мобильного приложения. Поскольку Remote Config гибко адаптируется под ваши задачи, вы сами решаете, что включить и как будет выглядеть пейвол. Мы предоставляем метод для получения Remote Config, а дальше вы сами управляете отображением пейвола.

Получение Remote Config пейвола и его отображение

В v4 флоу содержит список remoteConfigs — по одному Remote Config на каждую настроенную локализацию. Выберите запись, соответствующую локали пользователя, и извлеките нужные значения. Подробнее о выборе подходящей локализации — в разделе Локализации и коды локалей.


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
}

На этом этапе, получив все необходимые значения, можно приступить к рендерингу и сборке визуально привлекательного экрана. Убедитесь, что дизайн адаптирован для различных размеров экранов и ориентаций мобильных телефонов, обеспечивая удобный и бесперебойный пользовательский опыт на разных устройствах.

Обязательно фиксируйте событие просмотра пейвола, как описано ниже, чтобы аналитика Adapty могла собирать данные для воронок и A/B-тестов.

После отображения пейвола переходите к настройке процесса покупки. Когда пользователь совершает покупку, просто вызовите .makePurchase() с продуктом из вашего пейвола. Подробнее о методе .makePurchase() читайте в разделе Совершение покупок.

Рекомендуем создать резервный пейвол. Он будет отображаться пользователю при отсутствии интернет-соединения или кэша, обеспечивая бесперебойную работу даже в таких ситуациях.

Отслеживание событий просмотра пейвола

Adapty помогает измерять эффективность ваших пейволов. Данные о покупках собираются автоматически, но события просмотра пейвола нужно логировать вручную — только вы знаете, когда пользователь видит пейвол.

Чтобы залогировать событие просмотра пейвола, вызовите .logShowFlow(flow: flow) — это отразится в метриках пейвола в воронках и A/B-тестах.

Вызывать .logShowFlow(flow: flow) не нужно, если вы отображаете флоу или пейволы, созданные в конструкторе.

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

Параметры запроса:

Параметр	Наличие	Описание
flow	обязательный	Объект `AdaptyFlow`.

Если вы настроили пейвол с помощью Remote Config, вам нужно реализовать его отображение в коде мобильного приложения. Поскольку Remote Config предоставляет гибкость под ваши нужды, вы полностью контролируете содержимое и внешний вид пейвола. Мы предоставляем метод для получения Remote Config, чтобы вы могли самостоятельно отобразить пейвол, настроенный через него.

Получение Remote Config пейвола и его отображение

Чтобы получить Remote Config пейвола, обратитесь к свойству remoteConfig и извлеките нужные значения.

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) {
}

На этом этапе, получив все необходимые значения, можно переходить к рендерингу и сборке визуально привлекательного экрана. Убедитесь, что дизайн адаптирован под различные экраны и ориентации мобильных телефонов, обеспечивая удобный пользовательский опыт на всех устройствах.

Обязательно зафиксируйте событие просмотра пейвола, как описано ниже, — это позволит аналитике Adapty собирать данные для воронок и A/B-тестов.

После того как пейвол отображён, переходите к настройке процесса покупки. Когда пользователь совершает покупку, просто вызовите .makePurchase() с продуктом из вашего пейвола. Подробнее о методе .makePurchase() читайте в разделе Совершение покупок.

Рекомендуем создать резервный пейвол. Он будет показываться пользователю при отсутствии интернета или кэша, обеспечивая бесперебойную работу в таких ситуациях.

Отслеживание событий просмотра пейвола

Adapty помогает измерять эффективность ваших пейволов. Данные о покупках собираются автоматически, но логирование просмотров пейвола требует вашего участия — только вы знаете, когда пользователь видит пейвол.

Чтобы залогировать событие просмотра пейвола, вызовите .logShowPaywall(paywall) — это отразится в метриках пейвола в воронках и A/B-тестах.

Вызывать .logShowPaywall(paywall) не нужно, если вы отображаете пейволы, созданные в Paywall Builder.

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

Параметры запроса:

Параметр	Наличие	Описание
paywall	обязательный	Объект `AdaptyPaywall`.