---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://appmetrica.yandex.by/docs/en/data-collection/about-events.md
- https://appmetrica.yandex.by/docs/ru/data-collection/about-events.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/ru/llms.txt
# События
События позволяют собирать информацию о любых действиях пользователей внутри приложения.
#### Почему необходимо настраивать отправку событий? {#important}
AppMetrica не отслеживает пользовательские действия, специфичные для вашего приложения, но может собирать информацию о них через отправку событий, например:
- Пользователь открывает определенный экран.
- Пользователь нажимает какую-либо кнопку.
Информация об этих событиях отправляется в AppMetrica и отображается в отчете [События](https://appmetrica.yandex.by/docs/ru/mobile-reports/events-report.md). [Примеры отправки событий](#report-events).
## Уровни вложенности событий {#level}
Чтобы отправить событие, которое имееет вложенные параметры, передайте пару `key:value`. В интерфейсе `key` и `value` считаются уровнями вложенности.
{style="border: solid 1px #cccccc; max-width: 800px;"}
{% note info "" %}
AppMetrica позволяет передавать в событии вложенные параметры, которые могут иметь несколько уровней.
{% endnote %}
При передаче параметров в виде JSON каждый новый объект в значении — новый уровень вложенности, например:
```
"{
"param1":"1", // первый уровень вложенности
"param2":"abc",
"param3": {
"paramLevel2": "2", // второй уровень вложенности
"param2Level2": {
"paramLevel3": "3", // третий уровень вложенности
"param2Level3":{
"level": "4" // четвертый уровень вложенности
}
}
}
}"
```
Веб-интерфейс AppMetrica отображает до пяти уровней вложенности события. Если событие содержит шесть уровней и более, в отчете отобразятся пять верхних.
{% note info "" %}
С помощью [API отчетов](https://appmetrica.yandex.by/docs/ru/mobile-api/stat/intro.md) можно выгрузить до десяти уровней вложенности события.
{% endnote %}
## Трактовка числовых и строковых значений {#value}
В интерфейсе AppMetrica значения `{"count" : 3}` и `{"count" : "3"}` трактуются одинаково. Но при выгрузке с помощью API отчетов или [Logs API](https://appmetrica.yandex.by/docs/ru/mobile-api/logs/about.md) параметр будет выгружен в том виде, в котором он был отправлен на сервер.
Если одно и то же событие передается несколько раз с разным числовым значением параметра, в веб-интерфейсе значения параметра не суммируются. Каждое из значений записывается и считается отдельно.
{% note info "" %}
С помощью API отчетов можно выгрузить дополнительные поля: сумму и среднее всех числовых значений.
{% endnote %}
## Частично совпадающие вложенные события {#similar}
В одном событии можно передавать все время разные значения параметров.
Если сервер получает события с повторяющимися параметрами, их значения аккумулируются, а в отчете отображается количество по каждому из переданных вариантов.
Если сервер получает события с повторяющимися параметрами, но с разной глубиной вложенности, их значения аккумулируются по повторяющимся параметрам.
Например, первое событие имеет два уровня вложенности:
```java translate=no
{
"param1": "param2"
}
```
Второе — три уровня вложенности:
```java translate=no
{
"param1": {
"param2": "value"
}
}
```
В веб-интерфейсе эти события отобразятся в древовидном списке:
{style="border: solid 1px #cccccc; max-width: 800px;"}
Подсчет производится по следующему алгоритму:
1. Записывается событие и два его подуровня. Добавляется 1 к каждому параметру.
1. Добавляется 1 к названию события и трем его подуровням.
## Воронки {#funnels}
Чтобы анализировать цепочки событий и сравнивать конверсии, используйте отчет [Воронки](https://appmetrica.yandex.by/docs/ru/mobile-reports/funnels-report.md). Настройте от 1 до 10 шагов, включив в каждый шаг одно или несколько событий из приложения. Для многоуровневых событий примените фильтрацию по ключам и значениям.
«Воронки» помогут сравнить конверсию в целевое действие на разных версиях приложения, оценить динамику конверсии поведенческого сценария или узнать, какой части аудитории функция приложения понадобилась — количество и долю.
Так вы найдете точки роста и реализуете лучшие идеи для вашего пользователя. Подробнее см. в разделе [Воронки](https://appmetrica.yandex.by/docs/ru/mobile-reports/funnels-report.md).
## Отправка события {#report-events}
Примеры отправки события на платформах:
- [Android](https://appmetrica.yandex.by/docs/ru/sdk/android/analytics/android-operations.md#report-event)
- [iOS](https://appmetrica.yandex.by/docs/ru/sdk/ios/analytics/ios-operations.md#report-event)
- [Flutter](https://appmetrica.yandex.by/docs/ru/sdk/flutter/analytics/flutter-operations.md#report-event)
- [React Native](https://appmetrica.yandex.by/docs/ru/sdk/react-native/analytics/react-native-operations.md#report-event)
- [Unity](https://appmetrica.yandex.by/docs/ru/sdk/unity/analytics/unity-operations.md#report-event)
## Узнайте больше {#learn-more}
- [Отчет События](https://appmetrica.yandex.by/docs/ru/mobile-reports/events-report.md)
- [Отчет Воронки](https://appmetrica.yandex.by/docs/ru/mobile-reports/funnels-report.md)
- [API отчетов](https://appmetrica.yandex.by/docs/ru/mobile-api/stat/intro.md)
- [Logs API](https://appmetrica.yandex.by/docs/ru/mobile-api/logs/about.md)
- [Лимитирование кастомных событий](https://appmetrica.yandex.by/docs/ru/common/limits.md)
Если вы не нашли ответ на свой вопрос, то вы можете задать его через форму обратной связи. Пожалуйста, опишите возникшую проблему как можно подробнее. Если возможно, приложите скриншот.
Написать в службу поддержки
Предложить улучшение для документации