---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-reports/events-report.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/events-report.md
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/ru/llms.txt

# События

Отчет отображает статистику по собственным событиям. Отправку таких событий можно настроить в приложении. Подробнее в разделе [Отправка собственных событий](https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md).

## Задачи, которые поможет решить отчет {#resolve-tasks}

- определить охват и популярность функций приложения;
- сравнить поведение разных групп пользователей;
- оценить частоту использования функций в рамках сессий;
- [проанализировать вложенные параметры](#analytics) событий.

## Общие настройки {#how-to}

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

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

   {% note info "" %}

   <!-- source: ru/analytics/content/mobile-reports/_includes/period.md -->
   Чтобы задать период отчета вручную, используйте кнопку ![с датами](../../_images/button-date.png). Выбранный интервал можно группировать по часам, дням, неделям и месяцам.
   <!-- endsource: ru/analytics/content/mobile-reports/_includes/period.md -->

   {% endnote %}

2. В отчете можно выбрать определенных пользователей с помощью [сегментирования](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/segmentation.md).
3. В отчете можно настроить [группировки](#group) и [метрики](#metrics).

## Настройка графика с выбором метрик {#metrics-in-graph}

<!-- source: ru/analytics/content/mobile-reports/_includes/metrics-in-graph.md -->
На графике можно выбрать несколько метрик одновременно, если они имеют одинаковые единицы измерения. Если метрика в списке недоступна (название метрики написано серым цветом), значит она имеет другую единицу измерения.
<!-- endsource: ru/analytics/content/mobile-reports/_includes/metrics-in-graph.md -->

## Группировки и метрики {#groups-and-metrics}

<!-- source: ru/analytics/content/mobile-reports/_includes/groups-metrics-old.md -->
Отчет содержит показатели (метрики), которые объединены в группы (группировки).

Чтобы настроить группировки и метрики:

1. Нажмите кнопку **Группировки и метрики**.
2. В появившемся окне добавьте группировки и метрики, по которым хотите построить отчет.
3. Настройте порядок метрик и группировок.
    
   Порядок метрик определяет порядок столбцов, порядок группировок — вложенность строк в таблице.
<!-- endsource: ru/analytics/content/mobile-reports/_includes/groups-metrics-old.md -->

### Группировки {#group}

{% note alert "" %}

Группировки по параметрам доступны только для первого уровня вложенности. Подробнее об уровнях вложенности на [примере событий](https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md).

{% endnote %}

<!-- source: ru/analytics/content/mobile-reports/_includes/audience-group.md -->
{% cut "Аудитория" %}

- **Операционная система**.
- **Полная версия операционной системы**.
- **Пол**. Определяется эвристически с помощью технологии Крипта. При недостаточной точности предсказания принимает значение `Не определено`.
- **Возраст**. Определяется эвристически с помощью технологии Крипта. Возможные значения: `<18 | 18-24 | 25-34 | 35-44 | 45-54 | ≥55`. При недостаточной точности предсказания принимает значение Не определено.

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/audience-group.md -->

<!-- source: ru/analytics/content/mobile-reports/_includes/geo-group.md -->
{% cut "География" %}

- **Континент**.
- **Страна**.
- **Округ**.
- **Область**.
- **Город**.
- **Размер города**.

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/geo-group.md -->

<!-- source: ru/analytics/content/mobile-reports/_includes/events-group.md -->
{% cut "События" %}

- **Событие**. Название события;
- **Все параметры, уровня вложенности 1-5**. Выводит все переданные параметры события, которые соответствуют [уровням вложенности](https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md#level);
- **Параметр**. Позволяет выбрать конкретный параметр. Можно выбрать группировку несколько раз с разными параметрами.
     
     {% note alert "" %}
     
     Доступны параметры только первого уровня вложенности.

     {% endnote %}

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/events-group.md -->

<!-- source: ru/analytics/content/mobile-reports/_includes/date-event-group.md -->
{% cut "Дата события" %}

- **День**.
- **Неделя**.
- **Месяц**.

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/date-event-group.md -->

<!-- source: ru/analytics/content/mobile-reports/_includes/app-group.md -->
{% cut "Приложение" %}

- **Версия**.
- **Номер сборки**.

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/app-group.md -->

<!-- source: ru/analytics/content/mobile-reports/_includes/profile-attributes.md -->
{% cut "Атрибуты профиля" %}

  <!-- source: ru/analytics/content/mobile-reports/_includes/profile-attributes-system.md -->
  {% cut "Системные" %}

  - **Страна**.
  - **Область**.
  - **Город**.
  - **Версия**.
  - **Номер сборки**.
  - **Идентификатор**.
  - **Версия SDK**.
  - **Операционная система**.
  - **Версия операционной системы**.
  - **Производитель**.
  - **Устройство**.
  - **Тип устройства**.
  - **Экран**.
  - **Язык интерфейса**.
  - **"Root" статус**.  

  {% endcut %}
  <!-- endsource: ru/analytics/content/mobile-reports/_includes/profile-attributes-system.md -->
  
  <!-- source: ru/analytics/content/mobile-reports/_includes/profile-attributes-install.md -->
  {% cut "Установка" %}

  - **День**.
  - **Неделя**.
  - **Месяц**.
  - **Трекеры**.
  - **Партнеры**.
  - **Источник атрибуции**.
  - **Все параметры**.

  {% endcut %}
  <!-- endsource: ru/analytics/content/mobile-reports/_includes/profile-attributes-install.md -->

  <!-- source: ru/analytics/content/mobile-reports/_includes/profile-custom-group.md -->
  {% cut "Собственные" %}

  В приложении можно настроить [собственные атрибуты профиля](https://boost.yandex.com/doc/ru/analytics/content/data-collection/profile-attributes.md#custom).

  {% endcut %}
  <!-- endsource: ru/analytics/content/mobile-reports/_includes/profile-custom-group.md --> 

{% endcut %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/profile-attributes.md -->

### Метрики {#measure}

{% note alert "" %}

Метрики по параметрам доступны только для первого уровня вложенности. Подробнее об уровнях вложенности на [примере событий](https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md).

{% endnote %}

{% cut "Метрики по событиям" %}

- **Количество событий**. Общее число событий, которые произошли в приложении.
- **Уникальные значения параметра**. Количество уникальных значений выбранного параметра события.
- **Сумма значений параметра**. Сумма значений выбранного параметра события. Отсутствие значения или параметра в событии при расчете трактуется как 0.
- **Среднее значение параметра**. Сумма значений выбранного параметра события, поделенная на количество событий. Отсутствие значения или параметра трактуется как 0.
- **Медианное значение параметра**. Медианное значение выбранного параметра события. Отсутствие значения или параметра в событии при расчете трактуется как 0.

{% endcut %}

{% cut "Метрики по пользователям" %}

- **Пользователи**. Количество пользователей с событием.
- **Событий на пользователя**. Отношение количества событий к сумме всех пользователей приложения.
- **% от всех пользователей**. Доля пользователей с событием от всех пользователей приложения.
- **Уникальных значений параметра на пользователя**. Отношение количества уникальных значений выбранного параметра события к количеству пользователей с событием. Отсутствие значения или параметра в событии при расчёте трактуется как 0.
- **Сумма значений параметра на пользователя**. Отношение суммы значений выбранного параметра события к количеству пользователей с событием. Отсутствие значения или параметра в событии при расчёте трактуется как 0.

{% endcut %}

{% cut "Метрики по сессиям" %}

- **Сессий с событием**. Количество сессий, в которых встречалось событие.
- **Событий на сессию**. Отношение количества событий к количеству сессий.
- **Уникальных значений параметра на сессию**. Отношение количества уникальных значений выбранного параметра события к количеству сессий с событием. Отсутствие значения или параметра в событии при расчёте трактуется как 0.
- **Сумма значений параметра на сессию**. Отношение суммы значений выбранного параметра события к количеству сессий с событиями. Отсутствие значения или параметра в событии при расчёте трактуется как 0.

{% endcut %}

<!-- ![](../../_images/events-report-ru.png){style="border: solid 1px #cccccc; max-width: 800px;"} -->

## Анализ параметров событий {#analytics}

**Анализ вложенных параметров событий**
:   С помощью отчета можно проанализировать вложенные параметры событий. Вместе с аудиторными показателями доступны агрегации значений параметров: сумма, среднее, медиана, количество уникальных значений. Такие метрики полезны в сценариях:
    - сравнение нескольких событий по выбранному параметру;
    - подсчет количества ресурсов, которое потратили игроки.
     Сумма и количество уникальных значений параметров также доступны в пересчете на пользователей и на сессии.

**Группировка по конкретному параметру события**
:   В отчете можно настроить группировку по конкретному параметру события. Это полезно:
    - для фильтрации данных в отчете;
    - для сценариев: сравнение нескольких событий, подсчет статистики по всем событиям с нужным параметром.

## Добавление комментария {#comments}

Чтобы удобнее ориентироваться в отчетах, можно добавить комментарии к событиям. Для этого выполните следующее:

1. Найдите нужное событие в разделе **Настройки** → **События**.

   {% note info "" %}

   В настройки события можно перейти из интерфейса отчета. Для этого нажмите значок ![настройки](https://yastatic.net/s3/doc-binary/src/dev/appmetrica/ru/images/mobile-reports/cog.png) у названия события.

   {% endnote %}

2. Введите комментарий.
3. Вернитесь в отчет **События** и обновите страницу.

## Отключение события {#turn-off}

Чтобы отключить сбор события и убрать его из отчетов, выполните следующее:

1. Найдите нужное событие в разделе **Настройки** → **События**.

   {% note info %}

   В настройки события можно перейти из интерфейса отчета. Для этого нажмите значок ![настройки](https://yastatic.net/s3/doc-binary/src/dev/appmetrica/ru/images/mobile-reports/cog.png) у названия события.

   {% endnote %}

2. В блоке **Сбор событий** установите режим **Не собирается**.

## Экспорт данных {#export}

<!-- source: ru/analytics/content/mobile-reports/_includes/export-api.md -->
Данные из отчета можно экспортировать. 

{% note info "" %}

Данные экспортируются с учетом выбранных настроек отчета: сегментации, группировки, временного периода.

{% endnote %}

![настройки отчета](../../_images/export-data-ru.png){style="border: solid 1px #cccccc; max-width: 300px;"}

В правом верхнем углу нажмите ![значок экспорта](../../_images/icon-export.svg){inline=false} и выберите действие:

- **Экспортировать весь отчёт CSV** — экспортирует данные из таблицы в формате `CSV`.
- **График → CSV** — экспортирует данные из графика в формате `CSV`.
- **График → PNG** — экспортирует изображения графика в формате `PNG`.
- **Скопировать API-запрос графика** — выводит текст запроса для выгрузки данных графика с помощью [API отчетов](https://boost.yandex.com/doc/ru/analytics/content/mobile-api/logs/about.md). 
- **Скопировать API-запрос таблицы** — выводит текст запроса для выгрузки данных из таблицы с помощью [API отчетов](https://boost.yandex.com/doc/ru/analytics/content/mobile-api/logs/about.md). 

Полученные API-запросы можно использовать для построения собственного дашборда или создания автоматических скриптов выгрузки данных.

{% note info "" %}

Если вы получаете текст API-запроса впервые, убедитесь, что браузер не заблокировал всплывающее окно авторизации. В окне авторизации разрешите Boost Analytics доступ к данным.

{% endnote %}
<!-- endsource: ru/analytics/content/mobile-reports/_includes/export-api.md -->

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

{% cut "Для устройств на iOS события попадают в фоновые сессии" %}

{#session-background}

События, которые отправляются сразу после инициализации библиотеки, учитываются в фоновых сессиях. Чтобы события попали в пользовательские сессии, инициализируйте библиотеку с включенной опцией `handleActivationAsSessionStart`.

{% endcut %}

## Частые вопросы {#faq}

<!-- source: ru/analytics/content/_includes/faq.md -->
{% cut "Почему различается число событий в отчетах по событиям и User Acquisition?" %} 

В отчете [User Acquisition](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/user-acquisition-report.md) отображаются только те события, которые произошли после установки приложения и установка произошла в выбранном периоде отчета. В отчете [События](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/events-report.md) отображаются события без привязки к дате установки. Пользователь мог установить приложение раньше, вне периода отчета, а событие совершить позднее.

{% endcut %}
<!-- endsource: ru/analytics/content/_includes/faq.md --> 

<!-- source: ru/analytics/content/_includes/faq.md -->
{% cut "События с устройства долго не приходят в отчет" %}

AppMetrica SDK не отправляет событие сразу после того, как оно произошло. События накапливаются в буфере и отправляются пачками. 

Boost Analytics принимает события из SDK в течение 7 дней. В отчетах они отображаются по времени совершения события. 

Для принудительной отправки сохраненных событий после прохождения важных сценариев пользователя можно использовать метод `sendEventsBuffer()` — он отправляет данные из буфера и очищает его.

{% note info "" %}

Частое использование метода `sendEventsBuffer()` может привести к повышению энергопотребления и расходу исходящего интернет-трафика.

{% endnote %}

{% endcut %}
<!-- endsource: ru/analytics/content/_includes/faq.md -->

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

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

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