Включение покупок с помощью Flow & Paywall Builder в Android SDK

Чтобы подключить встроенные покупки, нужно разобраться в трёх ключевых понятиях:

Продукты – всё, что пользователи могут купить (подписки, расходуемые покупки, пожизненный доступ)
Флоу и пейволы – экраны, которые предлагают продукты пользователям, созданные в конструкторе флоу и пейволов без кода. SDK получает их через getFlow. Если вы предпочитаете строить UI самостоятельно, смотрите Реализация пользовательских пейволов.
Плейсменты – где и когда в приложении показываются флоу и пейволы (например, main, onboarding, settings). Вы привязываете их к плейсментам в дашборде, а затем запрашиваете по ID плейсмента в коде. Это упрощает запуск A/B-тестов и показ разных вариантов разным пользователям.

Adapty предлагает три способа подключить покупки в вашем приложении. Выберите подходящий в зависимости от требований:

Реализация	Сложность	Когда использовать
Adapty Flow & Paywall Builder	✅ Легко	Вы создаёте готовый к покупке флоу или пейвол в no-code конструкторе. Adapty автоматически отображает его и берёт на себя всю логику покупок, валидацию чеков и управление подписками.
Кастомные пейволы	🟡 Средне	Вы реализуете UI пейвола в коде своего приложения, но всё равно получаете объект флоу от Adapty, сохраняя гибкость в настройке продуктов. См. гайд.
Режим наблюдателя	🔴 Сложно	У вас уже есть собственная инфраструктура для обработки покупок, и вы хотите продолжать её использовать. Учтите, что режим наблюдателя имеет ограничения в Adapty. См. статью.

Important

Шаги ниже показывают, как реализовать флоу или пейвол, созданный в Adapty Flow & Paywall Builder.

Если вы хотите создать UI пейвола самостоятельно, см. Реализация пользовательских пейволов.

Чтобы отобразить флоу или пейвол, созданный в Adapty Flow & Paywall Builder, в коде приложения вам нужно только:

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

Прежде чем начать

Прежде чем начать, выполните следующие шаги:

Подключите приложение к Google Play в дашборде Adapty.
Создайте продукты в Adapty.
Создайте флоу или пейвол и добавьте в него продукты.
Создайте плейсмент и добавьте в него флоу или пейвол.
Установите и активируйте SDK в коде приложения. В этом гайде используются API Adapty Android SDK v4.

Tip

Самый быстрый способ выполнить эти шаги — следовать руководству по быстрому старту или создать флоу и плейсменты с помощью Developer CLI.

1. Получите флоу или пейвол

Ваши флоу и пейволы связаны с плейсментами, настроенными в дашборде. Плейсменты позволяют показывать разные флоу или пейволы разным аудиториям или запускать A/B-тесты.

Чтобы получить флоу или пейвол, созданный в Adapty Flow & Paywall Builder, необходимо:

Получить объект flow по ID плейсмента с помощью метода getFlow и проверить, есть ли в нём конфигурация представления.
Получите конфигурацию представления с помощью метода getFlowConfiguration. Конфигурация представления содержит элементы UI и стили, необходимые для его отображения.

Important

Чтобы получить конфигурацию представления, опубликуйте флоу или пейвол. Флоу или пейвол с неопубликованными изменениями имеет статус Dirty, и его плейсмент продолжает отдавать последнюю опубликованную версию.

Adapty.getFlow("YOUR_PLACEMENT_ID") { result ->
    if (result is AdaptyResult.Success) {
        val flow = result.value
        
        if (!flow.hasViewConfiguration) {
            return@getFlow
        }
        
        AdaptyUI.getFlowConfiguration(flow) { configResult ->
            if (configResult is AdaptyResult.Success) {
                val flowConfiguration = configResult.value
            }
        }
    }
}


Adapty.getFlow("YOUR_PLACEMENT_ID", result -> {
    if (result instanceof AdaptyResult.Success) {
        AdaptyFlow flow = ((AdaptyResult.Success<AdaptyFlow>) result).getValue();
        
        if (!flow.hasViewConfiguration()) {
            return;
        }
        
        AdaptyUI.getFlowConfiguration(flow, configResult -> {
            if (configResult instanceof AdaptyResult.Success) {
                AdaptyUI.FlowConfiguration flowConfiguration =
                    ((AdaptyResult.Success<AdaptyUI.FlowConfiguration>) configResult).getValue();
                // use loaded configuration
            }
        });
    }
});

2. Отобразите флоу или пейвол

Теперь, когда у вас есть конфигурация флоу, достаточно добавить несколько строк, чтобы отобразить флоу или пейвол.

Чтобы отобразить визуальный флоу на экране устройства, его нужно предварительно настроить. Для этого вызовите метод AdaptyUI.getFlowView() или создайте AdaptyFlowView напрямую:

   val flowView = AdaptyUI.getFlowView(
       activity,
       flowConfiguration,
       null, // products = null means auto-fetch
       eventListener,
   )

   val flowView =
        AdaptyFlowView(activity) // or retrieve it from xml
   ...
   with(flowView) {
       showFlow(
           flowConfiguration,
           null, // products = null means auto-fetch
		   eventListener,
       )
   }

AdaptyFlowView flowView = AdaptyUI.getFlowView(
        activity,
        flowConfiguration,
        null, // products = null means auto-fetch
        eventListener
);

AdaptyFlowView flowView =
  new AdaptyFlowView(activity); //add to the view hierarchy if needed, or you receive it from xml
...
flowView.showFlow(flowConfiguration, products, eventListener);

<com.adapty.ui.AdaptyFlowView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

После успешного создания view вы можете добавить его в иерархию представлений и отобразить на экране устройства.

Tip

Подробнее о том, как отображать флоу или пейвол, см. в нашем гайде.

3. Обработка действий кнопок

Когда пользователи нажимают кнопки во флоу или пейволе, Android SDK автоматически обрабатывает покупки, восстановление, закрытие экрана и открытие ссылок.

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

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

Tip

Ознакомьтесь с нашими гайдами по обработке действий и событий кнопок.

override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
    when (action) {
        AdaptyUI.Action.Close -> (context as? Activity)?.onBackPressed() // default behavior
    }
}

@Override
public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
    if (action instanceof AdaptyUI.Action.Close) {
        if (context instanceof Activity) {
            ((Activity) context).onBackPressed();
        }
    }
}

Следующие шаги

Tip

Есть вопросы или возникли проблемы? Загляните на наш форум поддержки, где можно найти ответы на распространённые вопросы или задать свой. Наша команда и сообщество всегда готовы помочь!

Ваш флоу или пейвол готов к отображению в приложении. Протестируйте покупки в Google Play Store, чтобы убедиться, что тестовая покупка проходит через флоу.

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

Полный пример

Вот как все эти шаги можно объединить в вашем приложении.

class MainActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        Adapty.getFlow("YOUR_PLACEMENT_ID") { flowResult ->
            if (flowResult is AdaptyResult.Success) {
                val flow = flowResult.value

                if (!flow.hasViewConfiguration) {
                    // Use custom logic
                    return@getFlow
                }

                AdaptyUI.getFlowConfiguration(flow) { configResult ->
                    if (configResult is AdaptyResult.Success) {
                        val flowConfiguration = configResult.value

                        val flowView = AdaptyUI.getFlowView(
                            this,
                            flowConfiguration,
                            null, // products = null means auto-fetch
                            object : AdaptyFlowDefaultEventListener() {
                                override fun onActionPerformed(action: AdaptyUI.Action, context: Context) {
                                    when (action) {
                                        is AdaptyUI.Action.Close -> {
                                            (context as? Activity)?.onBackPressed()
                                        }
                                    }
                                }
                            }
                        )

                        setContentView(flowView)
                    }
                }
            }
        }
    }
}

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

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

                if (!flow.hasViewConfiguration()) {
                    // Use custom logic
                    return;
                }

                AdaptyUI.getFlowConfiguration(flow, configResult -> {
                    if (configResult instanceof AdaptyResult.Success) {
                        AdaptyUI.FlowConfiguration flowConfiguration =
                            ((AdaptyResult.Success<AdaptyUI.FlowConfiguration>) configResult).getValue();

                        AdaptyFlowView flowView = AdaptyUI.getFlowView(
                            this,
                            flowConfiguration,
                            null, // products = null means auto-fetch
                            new AdaptyFlowDefaultEventListener() {
                               @Override
                                    public void onActionPerformed(@NonNull AdaptyUI.Action action, @NonNull Context context) {
                                        if (action instanceof AdaptyUI.Action.Close) {
                                            if (context instanceof Activity) {
                                                ((Activity) context).onBackPressed();
                                            }
                                        }
                                    }
                            }
                        );

                        setContentView(flowView);
                    }
                });
            }
        });
    }
}