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

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

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

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

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val flow = result.value
            val config = flow.remoteConfigs.firstOrNull { it.locale == "en" }
                ?: flow.remoteConfigs.firstOrNull()
            val headerText = config?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();

        AdaptyRemoteConfig config = null;
        for (AdaptyRemoteConfig remoteConfig : flow.getRemoteConfigs()) {
            if ("en".equals(remoteConfig.getLocale())) {
                config = remoteConfig;
                break;
            }
        }
        if (config == null && !flow.getRemoteConfigs().isEmpty()) {
            config = flow.getRemoteConfigs().get(0);
        }

        if (config != null && config.getDataMap().get("header_text") instanceof String) {
            String headerText = (String) config.getDataMap().get("header_text");
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // handle the error
    }
});

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

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

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

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

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

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

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

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

Adapty.logShowFlow(flow)

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

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

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

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

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

Adapty.getPaywall("YOUR_PLACEMENT_ID") { result ->
    when (result) {
        is AdaptyResult.Success -> {
            val paywall = result.value
            val headerText = paywall.remoteConfig?.dataMap?.get("header_text") as? String
        }
        is AdaptyResult.Error -> {
            val error = result.error
            // handle the error
        }
    }
}

Adapty.getPaywall("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyPaywall paywall = ((AdaptyResult.Success<AdaptyPaywall>) result).getValue();
        
        AdaptyPaywall.RemoteConfig remoteConfig = paywall.getRemoteConfig();
        
        if (remoteConfig != null) {
            if (remoteConfig.getDataMap().get("header_text") instanceof String) {
                String headerText = (String) remoteConfig.getDataMap().get("header_text");
            }
        }
    } else if (result instanceof AdaptyResult.Error) {
        AdaptyError error = ((AdaptyResult.Error) result).getError();
        // обработайте ошибку
    }
});

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

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

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

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

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

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

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

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

Adapty.logShowPaywall(paywall)

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

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