# Клієнти

## Клієнти

Розділ «Клієнти» представлено у вигляді стандартних віджетів, а також конструктора віджетів, де можна відобразити будь-які необхідні дані. Цей розділ складається з таких підрозділів:

У розділі «Клієнти» ви можете побачити зведення за розсилками, надісланими та отриманими повідомленнями, а також співвідношення клієнтів у круговій діаграмі за підключеними каналами.

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

За замовчуванням у розділі «Аналітика» — «Клієнти» є три віджети, які буде детальніше описано нижче.

Віджети можна міняти місцями: для цього перетягніть віджет за цю кнопку.

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

Потім розмістіть віджет у потрібному місці.

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

### Стандартні віджети

#### Віджет зведення

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

Стандартний віджет «Зведення» — це підсумок аналітики клієнтів, поділений на кілька частин:

* Огляд кількості нових клієнтів за каналами за певний період.

У прикладі вище показано, скільки та з яких месенджерів (каналів) прийшли клієнти за вибраний період часу.

* Також є дані про розсилки та повідомлення, де можна побачити кількість надісланих і отриманих повідомлень за месенджерами та кількість виконаних розсилок:
* Дані за вибраний період.

Якщо ви хочете переглянути зведення за інший період часу (поточний або попередній день; місяць, рік чи інший період), натисніть на іконку календаря, а потім виберіть потрібний період.

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

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

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

#### Віджет клієнтів

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

Цей віджет також умовно можна розділити на дві складові:

а) Загальна кількість клієнтів за рік і за місяць, відображена у верхній частині графіка.

б) Стовпчаста діаграма, що показує період із січня до грудня.

Поточний обліковий місяць на графіку, для якого обчислюється та відображається у верхній частині віджета кількість нових клієнтів, виділено синім, інші субоблікові місяці — світло-синім.

У цьому віджеті ви також можете змінювати кольори стовпчиків для кращої наочності.

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

Тут, у налаштуваннях віджета, ви також можете застосувати інші фільтри для відображення статистики:

* За списками та тегами.

Щоб вибрати потрібні списки та мітки, натисніть на галочку поруч із кожним потрібним елементом.

* За каналом.
* За блоком воронки.
* За клієнтами.
* За тегом.

Тег — це системна змінна. Ви можете знайти її в діалозі з клієнтом.

### Віджет клієнтів за каналами

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

Цей віджет представлено у вигляді кругової діаграми, яка показує співвідношення кількості клієнтів у різних каналах (месенджерах) між собою.

Із віджета, наведеного як приклад, ви можете побачити:

а) загальну кількість нових клієнтів за звітний період;

б) діаграму, що показує співвідношення кількості клієнтів за різними месенджерами;

в) месенджери, за якими вибирається статистика, та кількість клієнтів навпроти назви каналу (месенджера);

г) звітний період (натиснувши на іконку календаря, ви можете вибрати поточний або попередній день, місяць, рік чи інший проміжок часу).

### Створення віджета

Щоб створити свій віджет, потрібно натиснути кнопку «Додати віджет», де ви можете застосувати потрібну функціональність і відобразити все у бажаний спосіб.

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

У цьому випадку відкриється додаткове вікно конструктора віджетів, де.

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

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

* Вибір типу іконки для віджета: наприклад, для обліку кількості повідомлень можна вибрати іконку діалогу, якщо для навчання — іконку з конфедератом тощо.
* Тип діаграми для відображення статистики: кругова, стовпчаста, лінійна та спрощена.

У конструкторі віджетів ви можете налаштувати відображення за змінними, а також окремо використовувати конверсію.

#### Змінні

У вкладці «Змінні» потрібно вказати значення змінної для обліку статистики.

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

У прикладі вище ми вказали змінну віку, яка використовується для запису віку клієнта в боті. Оскільки ми вказали «За змінними клієнта», система буде читати значення клієнтів за цією змінною й враховуватиме лише тих, кому 18 і більше.

У вашому проєкті можна використовувати різноманітні змінні, що існують у вашому проєкті: це може бути сума платежів, наприклад, якщо ви хочете обчислити статистику для певного тарифу; місто проживання тощо.

{% hint style="warning" %}
Кожен рядок у відображуваному віджеті відповідає значенню змінної, яке ви вказали під час налаштування.

**Максимальна кількість рядків (значень змінної) — 6**
{% endhint %}

#### Оператори AND і OR

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

Якщо ви передаєте одне значення для аналітики, можете обрати будь-який із операторів. Однак якщо ви передаєте кілька значень для аналітики, варто зрозуміти різницю між цими фільтрами:

1. Фільтрація за оператором «AND» означає включення значень усіх змінних.

Тобто якщо ви оберете «And», система шукатиме та включатиме у статистику лише тих, у кого одночасно є кілька вибраних значень змінних.

Наприклад, якщо ви оберете змінну віку (значення 18) і змінну статі (значення чоловіча), а також фільтр «AND», система вибере лише клієнтів-чоловіків старше 18 років.

Умовно система розуміє, що вам потрібен клієнт, який і старше 18, і чоловічої статі. Інших клієнтів система не включатиме до статистики.

#### **Як працює AND**

Ви також можете здійснювати пошук лише за однією змінною.

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

Якщо ви пишете var1 = 1, var2 = 2, система поверне 0. Це зроблено для того, щоб ви могли задавати певні умови на кшталт var1 != 1 AND var1 > 0 — у цьому випадку система поверне тих клієнтів, чиї змінні не дорівнюють одному або більші за нуль (зі значеннями 2, 3, 4 тощо).

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

Ім’я змінної для оператора AND має бути однаковим для всіх рядків.

Наприклад:

* per1 = 1 AND pre2 = 2 — це НЕПРАВИЛЬНО!
* per1 < 400 AND per1 > 4 — правильний запис для змінних.
  {% endhint %}

{% hint style="warning" %}
Якщо вам потрібно використовувати змінні так:

per1 = 1 AND pre2 = 2, тоді використовуйте оператор OR.
{% endhint %}

2. Фільтрація за оператором OR передбачає одне з кількох значень (або більше).

Такий фільтр використовується, якщо вам потрібна вибірка клієнтів із різними значеннями змінних: наприклад, вам потрібні клієнти або старші за 18 років, або ті, що проживають у Нью-Йорку

Тоді оператор OR включить у вибірку всіх тих, хто має одне з двох значень змінної: вік або місто.

Отже, система умовно розуміє, що нам потрібні ті, хто або старший за 18, АБО проживає в Нью-Йорку.

**Як працює OR**

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

Змінні: var1 = 1, var2 = 2, де система шукає будь-якого клієнта, у якого принаймні одна з них відповідає вибраному значенню (можна передати й без значення — тоді система просто шукає її наявність).

{% hint style="info" %}
Читайте, що таке змінні та як із ними працювати, в [Змінні](/doc/uk/chatbot/functions/zminni.md) статті.&#x20;
{% endhint %}

Потім ви можете вибрати канали, статистику яких буде враховано в цьому віджеті.

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

Ви можете відстежувати статистику за певними списками та тегами, призначеними клієнтам.

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

Звісно, ви також можете використовувати конструктор схеми для обліку клієнтів, які перебувають у певному стані воронки.

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

Наприклад, на основі зображення вище ми можемо враховувати клієнтів, які видалили запис, і потім переглядати відсоток успішних транзакцій, що допоможе вам зрозуміти, як саме покращити якість вашого бізнесу та вжити відповідних заходів.

Далі ви можете застосувати фільтр для відображення відписаних клієнтів або, навпаки, виключити їх із перегляду.

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

Наступний критерій, за яким можна реалізувати відображення статистики, — це тег.

Тег — це системна змінна, яку можна знайти в діалозі з клієнтом (її не можна змінити).

Тег потрібно ввести у відповідне поле.

#### UTM-мітки

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

{% hint style="info" %}
Щоб дізнатися, що таке UTM-мітки та як їх використовувати, рекомендуємо прочитати статтю «[Як передавати параметри та UTM-мітки](/doc/uk/faq/questions/...peredati-utm-mitki.md)».
{% endhint %}

У першому полі «Назва значення» ви пишете назву, яка потрібна для відображення результатів у діаграмі.

Далі в полі вибору UTM-міток вам буде показано вже наявні в проєкті.

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

Потім введіть потрібне значення мітки — це може бути будь-яке призначене значення для цих міток.

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

Аналогічно до створення віджета на основі змінних, тут є вибір фільтрації «всі значення» та «одне зі значень»

{% hint style="success" %}
Якщо ви створюєте віджет на основі кількох UTM-міток і вам потрібно, щоб фінальний результат включав УСІ значення, використовуйте оператор «Усі значення».

Якщо вам потрібно відобразити результати за одним із значень, використовуйте оператор «Одне зі значень».
{% endhint %}

Коли ви вводите значення для мітки, можна задати відповідність:

1. дорівнює;
2. не дорівнює;
3. більше;
4. більше або дорівнює;
5. менше;
6. менше або дорівнює.

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

{% hint style="warning" %}
Усього в один віджет можна передати 6 значень і не більше.
{% endhint %}

Далі виберіть, які канали використовувати для UTM-міток у статистиці.

Ви можете обрати кілька каналів одразу або лише один на власний розсуд.

Ви також можете використовувати лише тих клієнтів, які включені до списку або мають призначену їм мітку (НЕ UTM), для відображення у віджеті.

#### Конверсія

Щоб обчислити конверсію, використовуйте однойменну вкладку в конструкторі віджетів.

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

Поле «Що рахувати» допоможе відобразити рівень конверсії за 4 критеріями:

1. Кількість — підрахунок кількості клієнтів за певний період часу та для певної події/категорії або сайту.

<div data-with-frame="true"><figure><img src="/files/7e48c7280d09d2340051978acb409abcc69ef5c3" alt="" width="350"><figcaption></figcaption></figure></div>

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

а) Усі проходження клієнта

б) унікальне проходження — підрахунок унікальних користувачів, які пройшли воронку вперше (цей блок, де налаштовано Аналітику).

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

1. **Сума значень** — система підсумовує кількості значень, які враховуються в статистиці;
2. **Середнє значення** — сума всіх значень чисел, поділена на їхню кількість. Наприклад, було три платежі: перший платіж — 1999, другий платіж — 2455, а третій платіж — 3455. Середнє значення становитиме 2636 (підсумуйте всі три платежі та поділіть на їхню кількість — три).&#x20;
3. **Медіанне значення** — це число, яке є середнім значенням для набору чисел. Візьмемо приклад виплат із попередніми значеннями, де перша виплата — 1999, друга виплата — 2455, а третя виплата — 3455. Медіанне значення в такому випадку буде числом 2455, що стоїть строго посередині набору чисел.

У полі «Як рахувати» ви обираєте підрахунок відсотків або від першого кроку, або від попереднього кроку.

Незалежно від того, який метод обчислення ви оберете, далі з’являться налаштування кроку.

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

Тут ви можете обрати підрахунок даних за воронкою або за сайтом.

Щоб конверсія працювала за воронкою, потрібно встановити блоки з «Аналітикою» з налаштуваннями категорій подій і подій у схемі конструктора.

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

{% hint style="success" %}
Докладніше про це читайте в статті «Що означає кожне поле в редакторі» у розділі '[Вкладка Аналітика](/doc/uk/chatbot/builder/setting/analitika.md)'.
{% endhint %}

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

Прапорець «Показати кроки для всіх значень» потрібен, щоб повністю відобразити значення під час обчислення статистики на графіку, якщо у віджеті вам потрібна детальніша інформація.

Якщо ви хочете відобразити конверсію за сайтом, можете вказати потрібну назву в полі «Назва кроку» (або залишити за замовчуванням — тоді назву буде згенеровано автоматично) і вибрати потрібний сайт.

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

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

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

У цьому випадку статистика враховуватиме кількість відвідувань сайту (НЕ унікальних клієнтів).

#### Фільтри

Віджет-фільтр допоможе вам відобразити дані, відфільтровані певним чином за заданими значеннями.

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

Наприклад, у вас є кілька списків, що включають клієнтів. Цей тип віджета допоможе вам відобразити точну кількість клієнтів, які є в кожному зі списків, і показати їх на віджеті.

#### Як налаштувати віджет?

Спочатку потрібно додати необхідну кількість значень, щоб відобразити дані у віджеті.

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

{% hint style="success" %}
Віджет може приймати загалом максимум 6 значень.
{% endhint %}

Після цього виберіть необхідний фільтр для відображення кількості клієнтів.

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

Якщо ви не вкажете назву кроку, за замовчуванням буде «Крок 1», «Крок 2» тощо.

Потім виберіть необхідні фільтри для відображення:

1. Канали — буде відображатися кількість клієнтів із певного каналу.

Наприклад, якщо у вашому проєкті підключено кілька каналів, ви можете відобразити кілька або всі з них у фільтрі, позначивши потрібні на власний розсуд.

2. Списки та мітки — значення відображає кількість клієнтів відповідно у списках і мітках, які ви визначили.

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

Це схоже на канали. Ви також можете обрати кілька списків/міток одразу, щоб відобразити клієнта за фільтрами.

3. Блок воронки — крок відображатиме кількість клієнтів за відповідним блоком(ами) воронки.

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

3. За клієнтами: відписані, виключаючи їх або відображаючи всіх.

Ви можете застосувати це як додатковий фільтр у значенні для клієнтів: наприклад, для перегляду даних про відписаних клієнтів у певних каналах.

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

Під час використання фільтра «Показувати лише відписаних» клієнти, додані протягом зазначеного періоду часу, відображатимуться зі статусом «Відписався», незалежно від того, коли саме вони відписалися.
{% endhint %}

5. Клієнти, додані зі статусом «Відписався», відображатимуться незалежно від того, коли користувач відписався.
6. За тегом, системною змінною, призначеною клієнту.

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

### Як видалити віджет

Щоб видалити або дублювати віджет, потрібно знайти відповідну іконку безпосередньо на самому віджеті.

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

Натиснувши на кнопку, ви побачите меню з видаленням або дублюванням віджета:

{% hint style="success" %}
Тепер ви знаєте, як створювати віджети та застосовувати до них необхідні метрики.
{% 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/analytics/customers.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.