Подключение AppMetrica SDK

Перед использованием плагина его необходимо установить в Android Studio по инструкции.

Шаг 1. Откройте диалоговое окно по подключению AppMetrica SDK

В главном меню выберите Tools → AppMetrica → Integrate.

Примечание.
  1. Если в вашем проекте нет Android приложений, то меню AppMetrica будет неактивно.
  2. Ваш проект должен быть синхронизирован, чтобы меню AppMetrica было активно.

Шаг 2. (Опционально) Выберите приложение, в которое хотите подключить AppMetrica SDK

Примечание. Если в вашем проекте только одно Android приложение, то у вас не будет возможности выбрать приложение. Просто пропустите этот шаг.

Если в вашем проекте есть несколько 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, то опция будет недоступна. Просто пропустите этот шаг.

Если в вашем проекте настроено отслеживание событий для сервиса AppsFlyer, вы можете создать аналогичные события для AppMetrica. Для этого включите опцию Copy events from AppsFlyer.

Примечание. При добавлении новых событий для AppsFlyer воспользуйтесь разделом Копирование событий из AppsFlyer, чтобы отправлять новые события в AppMetrica.

Шаг 6. Подключите AppMetrica SDK

Нажмите кнопку Ok.

В результате работы плагина в код приложения будет добавлена gradle-зависимость от AppMetrica SDK и ее активация. Также, если вы включили опцию Copy events from AppsFlyer, рядом с каждым методом отправления событий в AppsFlyer будет добавлен метод отправления событий в AppMetrica.

Шаг 7. (Опционально) Добавьте код для определения новых пользователей

Если вы включали опцию First activation as update (т.е. в вашем приложении уже есть пользователи), то в вашем классе, унаследованном от Application, будет добавлен метод isFirstActivationAsUpdate.

Подробнее в разделе Учет новых пользователей.

Шаг 8. Протестируйте работу AppMetrica

Чтобы проверить работу библиотеки:

  1. Запустите приложение с AppMetrica SDK и используйте его некоторое время.

  2. Убедитесь, что устройство подключено к интернету.

В интерфейсе AppMetrica убедитесь, что:

  1. В отчете Аудитория появился новый пользователь.

  2. В отчете Вовлечённость → Сессии увеличилось число сессий.

  3. В отчете События и Профили появились отправленные события и атрибуты профиля.

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