---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/support/appmetrica-io/en/sdk/android/analytics/quick-start.md
  - https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/quick-start.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/appmetrica-io/ru/llms.txt

# Интеграция SDK

SDK под Android предоставляется в виде библиотеки в формате AAR. Библиотека доступна в [Maven-репозитории](https://mvnrepository.com/artifact/io.appmetrica.analytics/analytics).

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

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

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

{% list tabs %}

- build.gradle.kts

  ```kotlin translate=no
  dependencies {
      // AppMetrica SDK.
      implementation("io.appmetrica.analytics:analytics:8.5.0")
  }
  ```

- build.gradle

  ```groovy translate=no
  dependencies {
      // AppMetrica SDK.
      implementation 'io.appmetrica.analytics:analytics:8.5.0'
  }
  ```

{% endlist %}

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

{% note alert "" %}

В библиотеке AppMetrica есть особенности, которые необходимо учитывать при инициализации. Подробнее в разделе [Особенности библиотеки AppMetrica](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-features.md).

{% endnote %}

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

{% list tabs group=instructions %}

- Kotlin

  ```kotlin translate=no
  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)
      }
  }
  ```

- Java

  ```java translate=no
  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);
      }
  }
  ```

{% endlist %}

{% cut "Что такое API key?" %}

<!-- source: ru/sdk/_includes/api-key.md -->
API key — уникальный идентификатор приложения, который выдается в веб-интерфейсе AppMetrica при [добавлении приложения](https://appmetrica.yandex.com/application/new). Посмотреть его можно в разделе **Настройки** → **Основное**.
<!-- endsource: ru/sdk/_includes/api-key.md -->

{% endcut %}

При инициализации библиотеки с расширенной стартовой конфигурацией включается [логирование](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-logs.md).

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

Определение местоположения позволяет оценить географическое распределение пользователей. По умолчанию отправка местоположения устройства отключена, но ее можно включить при инициализации конфигурации. Подробнее см. раздел [Отправка местоположения устройства библиотекой](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#track-location).

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

Чтобы собирать информацию о действиях в приложении, настройте отправку собственных событий. Подробнее в разделе [Отправка собственных событий](https://yandex.com/support/appmetrica-io/ru/data-collection/about-events.md).

Чтобы собирать информацию о пользователях, настройте отправку атрибутов профиля. Подробнее в разделе [Профили](https://yandex.com/support/appmetrica-io/ru/data-collection/about-profiles.md).

{% note info "" %}

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

{% endnote %}

Чтобы отслеживать покупки в приложении, настройте отправку Revenue. Подробнее в разделе [In-App покупки](https://yandex.com/support/appmetrica-io/ru/data-collection/about-revenue.md).

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

{% note alert "" %}

Перед проверкой работы библиотеки убедитесь, что SDK инициализирована с соблюдением [рекомендаций](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-features.md#recommendations).

{% endnote %}

Перед началом тестирования желательно настроить [передачу данных на дополнительный API key](android-operations#reporter-different-apikey) или [добавить приложение с новым API key](https://appmetrica.yandex.ru/about). Это поможет отделить тестовые данные от основной статистики.

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

1. Запустите приложение с AppMetrica SDK и используйте его некоторое время.
2. Убедитесь, что устройство подключено к интернету.
3. В интерфейсе AppMetrica убедитесь, что:
   - В отчете [Аудитория](https://yandex.com/support/appmetrica-io/ru/mobile-reports/audience-report.md) появился новый пользователь.
   - В отчете **Вовлечённость** → **Сессии** увеличилось число сессий.
   - В отчете [События](https://yandex.com/support/appmetrica-io/ru/mobile-reports/events-report.md) и [Профили](https://yandex.com/support/appmetrica-io/ru/mobile-reports/profile-report.md) появились отправленные события и атрибуты профиля.

## Узнайте больше {#learn-more}

- [Настройка отправки собственных событий](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#report-event)
- [Настройка отправки атрибутов профиля](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#send-attribute-profile)
- [Настройка отправки событий Ecommerce](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#send-ecommerce)
- [Настройка отправки событий Revenue](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#send-revenue)
- [Настройка отправки событий Ad Revenue](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-operations.md#send-adrevenue)
- [Как включить отправку данных о местоположении пользователей?](https://yandex.com/support/appmetrica-io/ru/troubleshooting/troubleshooting.md#region)
- [Как проверить, что у меня установлены последние версии Android-библиотек?](https://yandex.com/support/appmetrica-io/ru/troubleshooting/troubleshooting.md#newest-android-version)

<!-- - [Пример интеграции библиотеки ССЫЛКА НУЖНА НОВАЯ](https://github.com/yandexmobile/metrica-sample-android)-->

## Возможные проблемы и их решение {#faq}

- [Не увеличивается число сессий](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#session)
- [Нет событий](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#events)
- [Ошибка при добавлении библиотеки в проект](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#add-in-project)
- [Некорректная длительность пользовательской сессии при ручном отслеживании](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#listen-root)
- [Высокое энергопотребление библиотекой AppMetrica](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#power)
- [Конфликт при использовании автосбора Ad Revenue для Fyber](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#fyber-unsupport-adrevenue)
- [В списке нет моей проблемы](https://yandex.com/support/appmetrica-io/ru/sdk/android/analytics/android-errors.md#not-found)

<!-- source: ru/_includes/feedback-button-3.md -->
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.

<a href="../../../troubleshooting/feedback-new">
  <span class="button">Написать в службу поддержки</span>
</a>

<a href="../../../troubleshooting/feedback-docs">
  <span class="button">Предложить улучшение для документации</span>
</a>
<!-- endsource: ru/_includes/feedback-button-3.md -->