Подключение AppMetrica SDK
Перед использованием плагина его необходимо установить в Android Studio по инструкции.
Шаг 1. Откройте диалоговое окно по подключению AppMetrica SDK
В главном меню выберите
.- Если в вашем проекте нет Android приложений, то меню AppMetrica будет неактивно.
- Ваш проект должен быть синхронизирован, чтобы меню AppMetrica было активно.
Шаг 2. (Опционально) Выберите приложение, в которое хотите подключить AppMetrica SDK
Если в вашем проекте есть несколько Android приложений, необходимо выбрать то, в которое вы хотите подключить AppMetrica SDK.
Если вы хотите подключить AppMetrica SDK в несколько приложений, повторите эти шаги для каждого приложения.
Шаг 3. Укажите API key приложения
Откройте в веб-интерфейсе AppMetrica настройки приложения и скопируйте значение из поля API key (для использования в SDK).
Шаг 4. (Опционально) Включите или выключите дополнительные настройки SDK
Доступные настройки:
- First activation as update
-
Если в вашем приложении уже есть пользователи, то по умолчанию AppMetrica засчитает их за новых пользователей. Чтобы не учитывать текущую аудиторию новой, необходимо включить флаг
firstActivationAsUpdate
и указать условия, по которым пользователь будет учитываться как старый.Подробнее в разделе Учет новых пользователей.
- Location tracking
-
С этой настройкой AppMetrica будет автоматически определять местоположение устройства и передавать эту информацию в отчеты и Logs API.
Подробнее в разделе Определение местоположения на Android.
- Logs
-
Включает логирование работы библиотеки. Не рекомендуется включать этот флаг для продовой версии приложения.
- Statistic sending
-
Включает/отключает отправку статистики на сервер AppMetrica. Например, если для отправки статистических данных требуется согласие пользователя.
Для последующего включения отправки статистики используйте метод YandexMetrica.setStatisticsSending(Context context, boolean enabled).
Подробнее в разделе Отключение и включение отправки статистики.
Шаг 5. (Опционально) Скопируйте настроенные события для AppsFlyer
Если в вашем проекте настроено отслеживание событий для сервиса AppsFlyer, вы можете создать аналогичные события для AppMetrica. Для этого включите опцию Copy events from AppsFlyer.
Шаг 6. Подключите AppMetrica SDK
Нажмите кнопку Ok.
В результате работы плагина в код приложения будет добавлена gradle-зависимость от AppMetrica SDK и ее активация. Также, если вы включили опцию Copy events from AppsFlyer, рядом с каждым методом отправления событий в AppsFlyer будет добавлен метод отправления событий в AppMetrica.
Шаг 7. (Опционально) Добавьте код для определения новых пользователей
Если вы включали опцию First activation as update (т.е. в вашем приложении уже есть пользователи), то в вашем классе, унаследованном от Application
, будет добавлен метод isFirstActivationAsUpdate
.
Подробнее в разделе Учет новых пользователей.
Шаг 8. Протестируйте работу AppMetrica
Чтобы проверить работу библиотеки:
Запустите приложение с AppMetrica SDK и используйте его некоторое время.
Убедитесь, что устройство подключено к интернету.
В интерфейсе AppMetrica убедитесь, что:
В отчете Аудитория появился новый пользователь.
В отчете
увеличилось число сессий.В отчете События и Профили появились отправленные события и атрибуты профиля.