Подключение и инициализация

SDK под Android предоставляется в виде библиотеки в формате AAR. Библиотека доступна в Maven-репозитории.

Ниже описаны этапы подключения и инициализации AppMetrica SDK:

  1. Шаг 1. Добавьте библиотеку в проект
  2. Шаг 2. Инициализируйте библиотеку
  3. Шаг 3. (Опционально) Внесите изменения в AndroidManifest.xml

Шаг 1. Добавьте библиотеку в проект

Если вы используете Gradle для сборки приложения, пропишите следующую зависимость в файле build.gradle в блоке зависимостей:

dependencies {
    // AppMetrica SDK.
    implementation 'com.yandex.android:mobmetricalib:3.6.4'
    // Optionally. Play Install Referrer library.
    implementation 'com.android.installreferrer:installreferrer:1.0'
}

Подключение библиотеки Play Install Referrer повышает качество отслеживания источника установок.

Если вы не используете Gradle

Загрузите и добавьте библиотеку в проект.

Шаг 2. Инициализируйте библиотеку

Внимание. В библиотеке AppMetrica есть особенности, которые необходимо учитывать при инициализации. Подробнее в разделе Особенности библиотеки AppMetrica.

Инициализируйте библиотеку в приложении и настройте отслеживание активности пользователей. Для этого объявите производный класс от базового класса Application и переопределите метод onCreate() следующим образом:

public class MyApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // Creating an extended library configuration.
        YandexMetricaConfig config = YandexMetricaConfig.newConfigBuilder(API_key).build();
        // Initializing the AppMetrica SDK.
        YandexMetrica.activate(getApplicationContext(), config);
        // Automatic tracking of user activity.
        YandexMetrica.enableActivityAutoTracking(this);
    }
}
Что такое API key?

API key — это уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при добавлении приложения.

Убедитесь, что он указан верно.

AppMetrica позволяет отслеживать предустановленные приложения. Для этого инициализируйте библиотеку с расширенной конфигурацией.

Шаг 3. (Опционально) Внесите изменения в AndroidManifest.xml

Для отслеживания местоположения устройства внесите изменение в файл AndroidManifest.xml перед элементом application:

<manifest>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <application>...</application>
</manifest>

ACCESS_COARSE_LOCATION позволяет отслеживать местоположение устройства. Подробнее.