# Аналітика

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

Коли ви натискаєте кнопку «Аналітика», відкривається форма введення даних:

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

з полями:

**Категорія події** – загальна назва для певних подій у боті:

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

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

a) Загальні дії: прибув, купив, оплатив;\
b) Загальні категорії товарів: жіночий одяг, чоловічий одяг, взуття, товари для дому тощо;\
c) Категорії послуг: стрижки, манікюр тощо.

Це поле є необов’язковим для налаштування.

Назва події, для якої буде збиратися статистика (обов’язкове поле!).

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

Певний елемент із загальної категорії.

Наприклад, у межах категорії загальних дій:\
a) прибув: з Telegram-бота, з VK-бота, з WhatsApp-бота;\
b) купив: товар1, товар2, товар3 тощо.

Це поле є обов’язковим.

Потім ви можете вказати значення для події в боті: наприклад, клієнт сплатив певну суму, придбав певну кількість товарів тощо:

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

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

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

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

2. Вказання значення через змінну:

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

{% hint style="info" %}
Дані групуються (підсумовуються) за назвою події та категорією.
{% endhint %}

{% hint style="danger" %}
Зверніть увагу!

Аналітичні події не відстежуються в сірих блоках (блок Trigger, блок Fallback), оскільки ці блоки призначені для надсилання сповіщень, перевірки введення клієнта в боті, запуску розсилок і подібних функцій.\
Сірі блоки використовуються, щоб не порушувати шлях клієнта в основній воронці.
{% endhint %}

Коли клієнт проходить блок, у якому налаштовано події, ви можете переглядати дані в розділі «Аналітика»:

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

Потрібно створити віджет у розділі «Клієнти»:

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

Далі виберіть необхідні налаштування:

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

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

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

Далі виконайте ці прості кроки, щоб налаштувати відстеження аналітичних подій із чат-бота:

Крок 1. Виберіть вкладку «Конверсії»:

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

Крок 2. Вкажіть методи обчислення даних аналітики:

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

**Що рахувати** – параметри розрахунку для кожного кроку:

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

* **Кількість** – кількість клієнтів, які пройшли вибрану подію.
* **Сума значень** – загальна сума значень події для всіх клієнтів, які пройшли її. Це може показати кількість проданих товарів або загальний дохід від продажів.
* **Середнє значення** – середнє значення події для всіх клієнтів, які пройшли її. Це може показати, скільки одиниць товару в середньому продається на одного клієнта.
* **Медіанне значення** – медіанне значення події для всіх клієнтів, які пройшли її. Це дає точніше середнє значення, виключаючи крайні значення.

**Як розраховувати відсотки**

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

* Рахувати від % попереднього кроку.
* Рахувати від першого кроку.

Крок 3. Додайте крок для розрахунку:

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

Крок 4. Виберіть категорію (якщо є) і подію, які ви раніше вказали та зберегли в блоці бота:

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

Якщо вам потрібно відображати лише певне значення події, введіть потрібне значення в поле «Значення події»:

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

Якщо ви хочете відображати всі значення, залиште поле порожнім.

{% hint style="info" %}
Інші функції аналітики в MaviBot описані у статті «[Аналітика MaviBot](/doc/uk/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/uk/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.
