---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://boost.yandex.com/doc/en/analytics/content/mobile-reports/engagement-report.md
- https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/engagement-report.md
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/ru/llms.txt
# Вовлеченность
{% note warning "" %}
Если приложение было запущено только один раз и более не запускалось — длительность сессии [не будет определена](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/engagement-report.md#session-null).
{% endnote %}
Отчет **Вовлеченность** отображает информацию о том, сколько пользователь в среднем проводит времени в приложении, как часто запускает приложение, сколько в среднем длится одна сессия, общее количество сессий и общее время в приложении.
С помощью [сегментирования](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/segmentation.md) вы можете выбрать определенных пользователей и сравнивать данные по разным [периодам и сегментам](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/segment-comparison.md).
## Задачи, которые помогает решить отчет {#resolve-tasks}
**Оценить время, проведенное пользователями в приложении**
: Используйте метрику **Timespent на пользователя** для определения среднего времени, которое пользователь провел в приложении, и **Общий timespent** для суммарного времени (например, пользователи провели в вашем приложении в сумме 100 тысяч часов).
**Определить среднюю продолжительность сессии**
: Используйте метрику **Средняя длина сессии** в сочетании с различными группировками по дате, версии приложения или географии. Также вы можете воспользоваться группировкой **Длительность сессии** для наглядного распределения по интервалам.
**Оценить частоту использования приложения**
: Используйте метрику **Сессий на пользователя** в сочетании с группировками по периодам (день, неделя, месяц).
**Сравнить показатели вовлеченности разных групп пользователей**
: Используйте группировки по платформе, версии приложения, географии или их комбинацию (например, по неделям и по версии приложения).
**Получить количество сессий продолжительностью от 2-х секунд**
: Используйте группировку по длительности сессий, в сегментации исключите сессии длительностью **0–1 секунда**, получите итоговое значение в графе **Итого и средние**.
## Как определяется время {#session-duration}
AppMetrica SDK определяет время события в секундах с точностью до 4-х знаков после запятой. При передаче времени в отчет дробная часть не округляется, а отбрасывается.
**Пример**
Сессия началась в 2024-07-10 20:00:00.00000. Последнее событие в сессии было в 2024-07-10 20:00:01.99999. В отчет передано время этого события 2024-07-10 20:00:01. Таким образом, длительность сессии попадет в интервал **0–1 секунда**.
## Общие настройки {#how-to}
1. Выберите период времени и сегмент аудитории. По умолчанию отчет показывает данные за неделю с группировкой по дням.
Время в отчете — начало сессии на устройстве пользователя, приведенное к часовому поясу, который указан в настройках приложения.
{% note info "" %}
Чтобы задать период отчета вручную, используйте кнопку . Выбранный интервал можно группировать по часам, дням, неделям и месяцам.
{% endnote %}
2. В отчете можно выбрать определенных пользователей с помощью [сегментирования](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/segmentation.md).
3. В отчете можно настроить [группировки](#group) и [метрики](#measure).
## Настройка графика с выбором метрик {#metrics-in-graph}
На графике можно выбрать несколько метрик одновременно, если они имеют одинаковые единицы измерения. Если метрика в списке недоступна (название метрики написано серым цветом), значит она имеет другую единицу измерения.
## Группировки и метрики {#groups-and-metrics}
Отчет содержит показатели (метрики), которые объединены в группы (группировки).
Чтобы настроить группировки и метрики:
1. Нажмите поочередно кнопки **Группировка**, **Метрики** и **Данные**. Кнопка **Данные** доступна только для некоторых отчетов.
2. В каждом окне добавьте группировки и метрики, по которым хотите построить отчет.
3. Настройте порядок метрик и группировок.
Порядок метрик определяет порядок столбцов, порядок группировок — вложенность строк в таблице.
Чтобы вернуть метрики, группировки и настройки по умолчанию, нажмите **Сбросить**.
### Группировки {#group}
{% cut "Вовлеченность" %}
- **Длительность сессии**. Сгруппирована по интервалам:
```
Не определено | 0-9 секунд | 10-29 секунд | 30-59 секунд | 1 минута | 2 минуты | 3 минуты | 4 минуты | 5-9 минут | 10-19 минут | 20-29 минут| 30-59 минут | 1 час | 2-4 часа | 5-9 часов | более 10 часов
```
{% note info %}
**Длительность сессии** может принимать значение **Не определено**, если эта сессия была единственной. Подробнее в разделе [У некоторого количества сессий не определена длительность](https://boost.yandex.com/doc/ru/analytics/content/mobile-reports/engagement-report.md#session-null).
{% endnote %}
{% endcut %}
{% cut "Аудитория" %}
- **Операционная система**.
- **Полная версия операционной системы**.
- **Пол**. Определяется эвристически с помощью технологии Крипта. При недостаточной точности предсказания принимает значение `Не определено`.
- **Возраст**. Определяется эвристически с помощью технологии Крипта. Возможные значения: `<18 | 18-24 | 25-34 | 35-44 | 45-54 | ≥55`. При недостаточной точности предсказания принимает значение Не определено.
{% endcut %}
{% cut "География" %}
- **Континент**.
- **Страна**.
- **Округ**.
- **Область**.
- **Город**.
- **Размер города**.
{% endcut %}
{% cut "События" %}
- **Событие**. Название события;
- **Все параметры, уровня вложенности 1-5**. Выводит все переданные параметры события, которые соответствуют [уровням вложенности](https://boost.yandex.com/doc/ru/analytics/content/data-collection/about-events.md#level);
- **Параметр**. Позволяет выбрать конкретный параметр. Можно выбрать группировку несколько раз с разными параметрами.
{% note alert "" %}
Доступны параметры только первого уровня вложенности.
{% endnote %}
{% endcut %}
{% cut "Дата события" %}
- **День**.
- **Неделя**.
- **Месяц**.
{% endcut %}
{% cut "Приложение" %}
- **Версия**.
- **Номер сборки**.
{% endcut %}
{% cut "Атрибуты профиля" %}
{% cut "Системные" %}
- **Страна**.
- **Область**.
- **Город**.
- **Версия**.
- **Номер сборки**.
- **Идентификатор**.
- **Версия SDK**.
- **Операционная система**.
- **Версия операционной системы**.
- **Производитель**.
- **Устройство**.
- **Тип устройства**.
- **Экран**.
- **Язык интерфейса**.
- **"Root" статус**.
{% endcut %}
{% cut "Установка" %}
- **День**.
- **Неделя**.
- **Месяц**.
- **Трекеры**.
- **Партнеры**.
- **Источник атрибуции**.
- **Все параметры**.
{% endcut %}
{% cut "Собственные" %}
В приложении можно настроить [собственные атрибуты профиля](https://boost.yandex.com/doc/ru/analytics/content/data-collection/profile-attributes.md#custom).
{% endcut %}
{% endcut %}
### Метрики {#measure}
{% note info "" %}
Данные считаются по пользовательским сессиям, фоновые сессии (сессии, в которых приложение работает в фоне и пользователь не взаимодействует с ним напрямую) не учитываются.
{% endnote %}
{% cut "Вовлеченность" %}
- **Сессии**. Количество сессий.
- **Timespent на пользователя**. Общая продолжительность сессий, поделенная на количество пользователей с 1+ сессией за период (сессии с неопределенной продолжительностью не учитываются, подробнее в разделе [У некоторого количества сессий не определена длительность](#session-null)).
- **Средняя длина сессии**. Общая продолжительность сессий, поделенная на их количество (сессии с неопределенной продолжительностью не учитываются).
- **Сессий на пользователя**. Количество сессий, поделенное на количество пользователей с 1+ сессией за период.
- **Суммарный timespent**. Сумма продолжительности всех сессий (сессии с неопределенной продолжительностью не учитываются, подробнее в разделе [У некоторого количества сессий не определена длительность](#session-null)).
{% endcut %}
{style="border: solid 1px #cccccc; max-width: 800px;"}
## Экспорт данных {#export}
Данные из отчета можно экспортировать.
{% note info "" %}
Данные экспортируются с учетом выбранных настроек отчета: сегментации, группировки, временного периода.
{% endnote %}
{style="border: solid 1px #cccccc; max-width: 300px;"}
В правом верхнем углу нажмите {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 %}
## Возможные проблемы и их решение {#problems}
### У некоторого количества сессий не определена длительность {#session-null}
{% note info "" %}
Длительность в Boost Analytics считается по [пользовательским сессиям](https://boost.yandex.com/doc/ru/analytics/content/common/glossary.md#session).
{% endnote %}
При использовании автоматического отслеживания сессий ([Android](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-listen.md) | [iOS](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-listen.md)) Boost Analytics получает информацию об окончании сессии при наступлении следующей активности приложения, в том числе в фоновом режиме. Соответственно, точную длительность сессии нельзя посчитать, если приложение было запущено один раз и более не запускалось.
{% note warning "" %}
Длительность не будет посчитана, если приложение было принудительно закрыто.
{% endnote %}
### Слишком большое количество сессий с длительностью 0—9 секунд {#session-min}
Активность пользователей отслеживается с помощью SDK ([Android](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-listen.md) | [iOS](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-listen.md)). При использовании автоматического отслеживания тайм-аут сессии по умолчанию равен 10 секундам. Вы можете изменить это значение с помощью настроек конфигурации библиотеки ([Android](https://boost.yandex.com/doc/ru/analytics/content/sdk/android/analytics/android-listen.md) | [iOS](https://boost.yandex.com/doc/ru/analytics/content/sdk/ios/analytics/ios-listen.md)).
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации