# Аналитика

Чтобы отображать действия клиентов из бота в разделе «Аналитика», можно использовать настройки событий и значений для аналитики в настройках блока внутри Builder.

При нажатии на кнопку «Аналитика» открывается форма ввода данных:

<div data-with-frame="true"><figure><img src="/files/f018a8b4c3f23db0814930d7791d4cb6004fc5da" alt=""><figcaption></figcaption></figure></div>

с полями:

**Категория события** — общее название для определённых событий в боте:

<div data-with-frame="true"><figure><img src="/files/78cd1708f60dee13dc6f8df293e1e73858667cd2" alt="" width="563"><figcaption></figcaption></figure></div>

Например, категории в боте могут включать:

a) Общие действия: пришёл, купил, оплатил;\
b) Общие категории товаров: женская одежда, мужская одежда, обувь, товары для дома и т. д.;\
c) Категории услуг: стрижки, маникюр и т. д.

Это поле является необязательным для настройки.

Название события, по которому будет собираться статистика (обязательное поле!).

<div data-with-frame="true"><figure><img src="/files/649344d9aaa72f0d7573303b9133276a96e1aa08" alt="" width="563"><figcaption></figcaption></figure></div>

Конкретный элемент из общей категории.

Например, в категории общих действий:\
a) пришёл: из Telegram-бота, из VK-бота, из WhatsApp-бота;\
b) купил: product1, product2, product3 и т. д.

Это поле обязательно для заполнения.

Затем вы можете указать значение события в боте: например, клиент оплатил определённую сумму, купил определённое количество товаров и т. д.:

<div data-with-frame="true"><figure><img src="/files/c8aaeacd2c0a506d6a724c2baa654b038d975c4b" alt="" width="563"><figcaption></figcaption></figure></div>

Значение события — число или переменная клиента/сделки, указанная в формате #{cost}:

1. Указание числового значения:

<div data-with-frame="true"><figure><img src="/files/73c35f943cfc030215709ffab54c6faf9051448b" alt="" width="563"><figcaption></figcaption></figure></div>

2. Указание значения через переменную:

<div data-with-frame="true"><figure><img src="/files/71d2303642a1567bc194af9001bcb16cbcdbddf0" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Данные группируются (суммируются) по названию события и категории.
{% endhint %}

{% hint style="danger" %}
Обратите внимание!

События аналитики не отслеживаются в серых блоках (блок Триггер, блок Fallback), так как эти блоки предназначены для отправки уведомлений, проверки ввода клиента в боте, запуска рассылок и подобных функций.
\
Серые блоки используются, чтобы не нарушать путь клиента по основной воронке.
{% endhint %}

Когда клиент проходит через блок, в котором настроены события, вы можете просмотреть данные в разделе «Аналитика»:

<div data-with-frame="true"><figure><img src="/files/e8db470b301239344e8574f32008f73976b05ccd" alt="" width="563"><figcaption></figcaption></figure></div>

Вам нужно создать виджет в разделе «Клиенты»:

<div data-with-frame="true"><figure><img src="/files/2f9db04304c0ccbf92fc2e5f4627ec89232a1aaa" alt="" width="563"><figcaption></figcaption></figure></div>

Далее выберите необходимые настройки:

<div data-with-frame="true"><figure><img src="/files/289771c3fde40a3c71edf6fbd5dca862fa9c28e7" alt="" width="375"><figcaption></figcaption></figure></div>

1. Укажите период аналитики
2. Введите название виджета
3. Выберите тип визуализации данных для аналитики (круговая диаграмма, столбчатая диаграмма и т. д.)
4. Выберите данные, которые будут отображаться в виджете:

<div data-with-frame="true"><figure><img src="/files/1f8e843f82aa7c626c0f6ac72fae46eac50bd6a7" alt="" width="563"><figcaption></figcaption></figure></div>

Далее выполните эти простые шаги, чтобы настроить отслеживание аналитических событий из чат-бота:

Шаг 1. Выберите вкладку «Конверсии»:

<div data-with-frame="true"><figure><img src="/files/14eef0989c1fa5a42d0a53074c7e8f3000892dfa" alt="" width="375"><figcaption></figcaption></figure></div>

Шаг 2. Укажите способы расчёта данных аналитики:

<div data-with-frame="true"><figure><img src="/files/f9b44f63c7ea268426a2f85178b5a1f32cace416" alt="" width="563"><figcaption></figcaption></figure></div>

**Что считать** — параметры расчёта для каждого шага:

<div data-with-frame="true"><figure><img src="/files/4127471428734925f852c9eb41e81b77119f2dd0" alt="" width="563"><figcaption></figcaption></figure></div>

* **Количество** — число клиентов, которые прошли через выбранное событие.
* **Сумма значений** — общая сумма значений события для всех клиентов, которые прошли через него. Это может показать количество проданных товаров или общий доход от продаж.
* **Среднее значение** — среднее значение события для всех клиентов, которые прошли через него. Это может показать, сколько единиц товара в среднем продаётся на одного клиента.
* **Медианное значение** — медианное значение события для всех клиентов, которые прошли через него. Это даёт более точное среднее, исключая экстремальные значения.

**Как рассчитывать проценты**

<div data-with-frame="true"><figure><img src="/files/32f77f5ca5ef2fe9915ff406e473d5bc9924de1a" alt="" width="563"><figcaption></figcaption></figure></div>

* Считать от % предыдущего шага.
* Считать от первого шага.

Шаг 3. Добавьте шаг для расчёта:

<div data-with-frame="true"><figure><img src="/files/b8a0e69a0294ea12e7f36d7f7c0ff23c607561bb" alt="" width="563"><figcaption></figcaption></figure></div>

Шаг 4. Выберите категорию (если есть) и событие, которые вы ранее указали и сохранили в блоке бота:

<div data-with-frame="true"><figure><img src="/files/2443d9497a1540cdcb53aabb0f87a027966f1d7d" alt="" width="563"><figcaption></figcaption></figure></div>

Если нужно отобразить только конкретное значение события, введите требуемое значение в поле «Значение события»:

<div data-with-frame="true"><figure><img src="/files/6b46d124ec63272abd2750299be78ef4634bd6e4" alt="" width="563"><figcaption></figcaption></figure></div>

Если хотите отобразить все значения, оставьте поле пустым.

{% hint style="info" %}
Другие возможности аналитики в MaviBot описаны в статье «[Аналитика MaviBot](/doc/ru/analitika-mavibot.md)."
{% endhint %}

{% hint style="success" %}
Готово!&#x20;

Теперь вы научились работать с редактором сценариев чат-бота MaviBot!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ru/chatbot/builder/setting/analitika.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.