Отслеживание просмотров экранов флоу в Android SDK

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

Tip

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

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

Вам понадобится:

  • Adapty Android SDK v4 или выше: колбэк аналитики флоу отсутствует в более ранних версиях.
  • Версия флоу, опубликованная после выхода этой функции: Adapty генерирует события экранов при публикации флоу, поэтому флоу, опубликованный до этого момента, не передаёт никаких событий. Если события не поступают в ваше приложение, опубликуйте новую версию флоу и попробуйте снова.

Что вы получаете

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

ПараметрОписание
instanceIdID экрана, который открыл пользователь.
screen_orderПорядковый номер экрана во флоу.
is_last_screentrue, если экран не ведёт никуда дальше. Во флоу с ветвлением может быть несколько конечных экранов — каждый из них передаёт true. Экран пейвола передаёт false, если хотя бы одно из его действий на исходе ведёт на другой экран, независимо от результата покупки или восстановления. Действие Navigate back не учитывается. Переход на экран тоже не учитывается, если все пользователи проходят этот экран до пейвола.

Оба параметра isBackendEvent и isCustomerEvent равны true для этого события: Adapty продолжает считать его, а ваше приложение также получает его.

Note

По умолчанию эти ID генерируются автоматически, поэтому ваше приложение получает scr_oAPBHPa7 вместо welcome. Если ваша аналитика зависит от их чтения, задайте собственные: назовите поля ввода и выбираемые группы в Flow Builder, а экраны переименуйте с помощью скилла flow-generator. См. Назначьте ID, которые видит ваша аналитика.

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

Пересылайте каждый просмотр экрана в вашу аналитику

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

override fun onAnalyticEvent(
    name: String,
    params: Map<String, Any?>,
    context: Context,
) {
    if (name != "flow_screen_showed") return

    val screenId = params["instanceId"]
    val screenOrder = params["screen_order"]

    // Send screenId and screenOrder to your analytics provider here.
}

Запускайте код, когда пользователь доходит до конца

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

override fun onAnalyticEvent(
    name: String,
    params: Map<String, Any?>,
    context: Context,
) {
    if (name != "flow_screen_showed") return
    if (params["is_last_screen"] != true) return

    // The user reached the end of the flow.
}

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