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

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

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

В v4 флоу содержит по одному объекту AdaptyRemoteConfig на каждую настроенную локаль в списке remoteConfigs. Выберите локаль, соответствующую предпочтениям пользователя, и считайте нужные значения.


Adapty.getFlow("YOUR_PLACEMENT_ID")
    .onSuccess { flow ->
        val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
            ?: flow.remoteConfigs.firstOrNull()
        val headerText = config?.dataMap?.get("header_text") as? String
        // use the remote config values
    }
    .onError { error ->
        // handle the error
    }

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

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

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

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

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

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

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

Вызывать .logShowFlow(flow) не нужно, если вы отображаете флоу или пейволы, созданные с помощью Flow Builder или Paywall Builder. В этих случаях Adapty отслеживает просмотры автоматически.

Adapty.logShowFlow(flow)
    .onSuccess {
        // flow view logged successfully
    }
    .onError { error ->
        // handle the error
    }

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

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

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

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

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


Adapty.getPaywall(
    placementId = "YOUR_PLACEMENT_ID",
    locale = "en",
    fetchPolicy = AdaptyPaywallFetchPolicy.Default,
    loadTimeout = 5.seconds
).onSuccess { paywall ->
    val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
    // use the remote config values
}.onError { error ->
    // handle the error
}

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

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

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

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

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

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

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

Adapty.logShowPaywall(paywall = paywall)
    .onSuccess {
        // paywall view logged successfully
    }
    .onError { error ->
        // handle the error
    }

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

Параметр	Наличие	Описание
paywall	required	Объект `AdaptyPaywall`.