Отслеживание событий
Введение
Благодаря событиям в приложении вы можете отслеживать действия пользователей внутри вашего приложения. Такие события, как регистрация, прохождение уровней, покупки и т. д. вы можете зарегистрировать как внутренние события приложения. Внедрение внутренних событий приложения обязательно для целей анализа приложения после установки.
Типы Событий
События в приложении можно разделить на две категории:
- Базовые события это стандартные внутренние события приложения, которые помогают вам понять действия пользователей внутри вашего приложения.
Examples:
level1_finished
level2_start
app_login
- Насыщенные события аналогичные базовые события в приложении, но позволяющие вам получить более подробную информацию о событии с помощью ряда параметров. Вы узнаете о них больше на шаге 1. Через параметры можно отправить дополнительную информацию о событии. Например, вы можете не только узнать, что приложение было открыто, но и точную дату и время.
Examples:
level1_finished (result)
level2_start (time)
app_login (date)
Рекомендуемые События
Вам нужно выбрать события, которые лучше всего подходят для вашего приложения.
- Для лучшей навигации по отчетам мы рекомендуем использовать одинаковые имена событий в вашем приложении на всех платформах.
- Создавайте всевозможные события с максимальным количеством деталей, описывающих действия пользователя в вашем приложении.
- Мы рекомендуем использовать только строчные буквенно-цифровые символы (a-z и 0-9) для названий событий в приложении.
Примеры (для других приложений):
appodeal_initialized
complete_registration
user_login
tutorial_completion
on_search
content_view
in_app_purchase
Примеры (для игр):
game_start
game_win
game_end
main_menu_open
game_lose
round_start
round_end
pause_menu_open
design_dialog_open
settings_dialog_open
design_application_changed
level1_complete
appodeal_consent_dialog_open
appodeal_consent_dialog_result
Шаг 1. Как Отслеживать События В Приложении
Appodeal SDK позволяет отправлять события в следующие аналитические сервисы, используя единый метод:
- Kotlin
- Java
// При необходимости создать Map параметров события
val params = mapOf(
"example_param_1" to "value",
"example_param_2" to 123
)
Appodeal.logEvent(eventName = "appodeal_sdk_test_event", params = params)
// При необходимости создать Map параметров события
Map<String, Object> params = new HashMap<>();
params.put("example_param_1", "value");
params.put("example_param_2", 123);
Appodeal.logEvent("appodeal_sdk_test_event", params);
Параметры события могут быть только строками и числами, они позволяют вам отправлять дополнительную информацию о событии в вашем приложении.
Шаг 2. Настройка Внутренних Событий Приложения На Стороне MMP
Могут потребоваться дополнительные действия на стороне MMP для завершения настройки событий.
Appodeal Free Adjust Аккаунт
- Если вы хотите отправлять события в Adjust, свяжитесь с нашей службой поддержки по электронной почте support@appodeal.com или в онлайн-чате и отправьте нам список с названиями событий.
По умолчанию, Appodeal SDK отправляет s2s события в Adjust.
Список s2s событий:
dc_cpa_event_d0
- данное событие отправляется вместе с значением ARPU Дня 0 после установки приложения;dc_cpa_event_d2
- данное событие отправляется вместе с значением ARPU Дня 2 после установки приложения;dc_cpa_event_d7
- данное событие отправляется вместе с значением ARPU Дня 7 после установки приложения;dc_cpa_event_d30
- данное событие отправляется вместе с значением ARPU Дня 30 после установки приложения.
Если вы хотите закупаться на s2s события в ваших UA кампаниях, пожалуйста, свяжитесь с нашей службой поддержки по электронной почте support@appodeal.com или в онлайн-чате, чтобы мы могли соединить события с вашим источником трафика.
Собственный Adjust Аккаунт
Если вы хотите отправлять события в Adjust, вам нужно создать свои события на стороне Adjust в соответствии с этим руководством и отправить нам их токены по электронной почте support@appodeal.com или в онлайн-чате:
Найдите ваше приложение на панели управления и нажмите на значок параметров (^);
Нажмите Все настройки > События;
Найдите надпись Создать новое событие в нижней части модуля и введите название события;
Нажмите Создать;
Отправьте нам токен каждого события, указав название события (вы можете найти токен рядом с событием в разделе Все настройки > События).
Вам также необходимо создать некоторые необходимые события SDK, представленные ниже:
Необходимые события SDK:
hs_sdk_purchase
- покупка в приложении успешно подтверждена;hs_sdk_unknown
- неизвестное событие;hs_sdk_purchase_error
- покупка в приложении не была подтверждена, произошла ошибка.
Собственный AppsFlyer Аккаунт
- Дополнительных действий не требуется