Интеграция SDK

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

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

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

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

build.gradle.kts

build.gradle

dependencies {
    // AppMetrica SDK.
    implementation("io.appmetrica.analytics:analytics:7.9.0")
}

dependencies {
    // AppMetrica SDK.
    implementation 'io.appmetrica.analytics:analytics:7.9.0'
}

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

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

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

Kotlin

Java

class YourApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // Creating an extended library configuration.
        val config = AppMetricaConfig.newConfigBuilder(API_KEY).build()
        // Initializing the AppMetrica SDK.
        AppMetrica.activate(this, config)
    }
}

public class YourApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // Creating an extended library configuration.
        AppMetricaConfig config = AppMetricaConfig.newConfigBuilder(API_KEY).build();
        // Initializing the AppMetrica SDK.
        AppMetrica.activate(this, config);
    }
}

Что такое API key?

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

При инициализации библиотеки с расширенной стартовой конфигурацией включается логирование.

Шаг 3. (Опционально) Настройте определение местоположения

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

Шаг 4. (Опционально) Настройте отправку событий, атрибутов профиля и Revenue (#send)

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

Чтобы собирать информацию о пользователях, настройте отправку атрибутов профиля. Подробнее в разделе Профили.

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

Чтобы отслеживать покупки в приложении, настройте отправку Revenue. Подробнее в разделе In-App покупки.

Шаг 5. Протестируйте работу библиотеки

Перед проверкой работы библиотеки убедитесь, что SDK инициализирована с соблюдением рекомендаций.

Перед началом тестирования желательно настроить передачу данных на дополнительный API key или добавить приложение с новым API key. Это поможет отделить тестовые данные от основной статистики.

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

Запустите приложение с AppMetrica SDK и используйте его некоторое время.
Убедитесь, что устройство подключено к интернету.
В интерфейсе AppMetrica убедитесь, что:
- В отчете Аудитория появился новый пользователь.
- В отчете Вовлечённость → Сессии увеличилось число сессий.
- В отчете События и Профили появились отправленные события и атрибуты профиля.

Узнайте больше

Возможные проблемы и их решение

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

Написать в службу поддержки

Была ли статья полезна?

AppMetrica Push SDK. Миграция на версию 3.0.0

Особенности библиотеки