# Клиенты

## Клиенты

Раздел «Клиенты» представлен в виде стандартных виджетов, а также конструктора виджетов, где можно отображать любые необходимые данные. Этот раздел состоит из следующих подразделов:

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

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

По умолчанию в разделе «Аналитика» — «Клиенты» есть три виджета, которые будут подробнее описаны ниже.

Виджеты можно менять местами: для этого перетащите виджет за эту кнопку.

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

Затем разместите виджет в нужном месте.

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

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

#### Виджет «Сводка»

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

Стандартный виджет «Сводка» — это сводка клиентской аналитики, разделённая на несколько частей:

* Обзор количества новых клиентов по каналу за выбранный период.

На примере выше показано, сколько и из каких мессенджеров (каналов) пришли клиенты за выбранный период времени.

* Есть данные по рассылкам и сообщениям, где можно увидеть количество отправленных и полученных сообщений по мессенджерам и количество выполненных рассылок:
* Данные за выбранный период.

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

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

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

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

#### Виджет «Клиенты»

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

Этот виджет также условно можно разделить на две составляющие:

a) Общее количество клиентов за год и за месяц, отображаемое в верхней части графика.

b) Столбчатая диаграмма, показывающая период с января по декабрь.

Текущий расчётный месяц на графике, для которого количество новых клиентов рассчитывается и отображается в верхней части виджета, выделен синим цветом, остальные расчётные месяцы — светло-синим.

В этом виджете вы также можете изменить цвета столбцов для лучшей наглядности.

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

Здесь, в настройках виджета, вы также можете применить другие фильтры для отображения статистики:

* По спискам и тегам.

Чтобы выбрать нужные списки и метки, нажмите на галочку рядом с каждым нужным пунктом.

* По каналу.
* По блоку воронки.
* По клиентам.
* По тегу.

Тег — это системная переменная. Вы можете найти её в диалоге с клиентом.

### Виджет «Клиенты по каналам»

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

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

На виджете, представленном в качестве примера, вы можете увидеть:

a) общее количество новых клиентов за отчётный период;

b) диаграмму, показывающую соотношение количества клиентов по разным мессенджерам;

c) мессенджеры, по которым собирается статистика, и количество клиентов напротив названия канала (мессенджера);

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

### Создание виджета

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

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

При этом откроется дополнительное окно конструктора виджетов, где.

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

1. Вы выбираете период, который будет отображаться в статистике: это может быть день (текущий или предыдущий); месяц, год или любой другой удобный для вас период.
2. Вы также можете настроить внешний вид виджета по своему усмотрению:

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

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

#### Переменные

Во вкладке «Переменные» необходимо указать значения переменной для учёта статистики.

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

В примере выше мы указали переменную возраста, которая используется для записи возраста клиента в боте. Поскольку мы указали «По переменным клиента», система будет считывать значения клиентов по этой переменной и учитывать только тех, кому 18 и больше.

В вашем проекте вы можете использовать различные переменные, которые существуют в проекте: это может быть сумма платежей, например, если вы хотите посчитать статистику по определённому тарифу; город проживания и т. д.

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

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

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

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

Если вы передаёте одно значение для аналитики, вы можете выбрать любой из операторов. Однако если вы передаёте несколько значений для аналитики, стоит понимать разницу между этими фильтрами:

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

То есть если вы выберете «And», система будет искать и включать в статистику только тех, у кого одновременно несколько выбранных значений переменных.

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

Условно система понимает, что вам нужен клиент, который одновременно старше 18 лет и является мужчиной. Других клиентов система не будет включать в статистику.

#### **Как работает AND**

Вы также можете выполнять поиск только по одной переменной.

<div data-with-frame="true"><figure><img src="/files/22af0a1f78cce8f63a22c6f7523366c4455f8b5c" 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/bd218c27013a1e85d821b13c8aa83c907babb5b6" alt="" width="563"><figcaption></figcaption></figure></div>

Переменные: var1 = 1, var2 = 2, где система ищет любого клиента, у которого хотя бы одно из них соответствует выбранному значению (можно передать и без значения — тогда система просто ищет его наличие).

{% hint style="info" %}
Читайте о том, что такое переменные и как с ними работать, в [Переменные](/doc/ru/chatbot/functions/peremennye.md) статье.&#x20;
{% endhint %}

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

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

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

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

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

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

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

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

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

Следующий критерий, по которому можно реализовать отображение статистики, — это тег.

Тег — это системная переменная, которую можно найти в диалоге с клиентом (её нельзя изменить).

Тег следует ввести в соответствующее поле.

#### UTM-теги

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

{% hint style="info" %}
Чтобы узнать, что такое UTM-теги и как их использовать, рекомендуем прочитать статью «[Как передавать параметры и UTM-теги](/doc/ru/faq/questions/...peredat-utm-metki.md)».
{% endhint %}

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

Далее в поле выбора UTM-тегов вам будут предложены уже существующие в проекте.

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

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

<div data-with-frame="true"><figure><img src="/files/5cfa80bd1ca01f61a5598cbd49d0bd39ec052a0e" 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/03e95faf19a71a3a226250fc4667bb7d6c0c045e" alt=""><figcaption></figcaption></figure></div>

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

Далее выберите, какие каналы использовать для UTM-тегов в статистике.

Вы можете выбрать несколько каналов сразу или только один по своему усмотрению.

Для отображения в виджете вы также можете использовать только тех клиентов, которые входят в список или которым назначена метка (НЕ UTM).

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

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

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

Поле «Что считать» поможет отображать показатель конверсии по 4 критериям:

1. Количество — подсчёт числа клиентов за определённый период времени и для конкретного события/категории или сайта.

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

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

a) Все переходы клиентов

b) уникальные переходы — подсчёт уникальных пользователей, которые впервые прошли через воронку (этот блок, где настроена аналитика).

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

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

В поле «Как считать» вы выбираете подсчёт процентов либо от первого шага, либо от предыдущего шага.

Независимо от того, какой метод расчёта вы выберете, далее появятся настройки шага.

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

Здесь вы можете выбрать подсчёт данных по воронке или по сайту.

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

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

{% hint style="success" %}
Подробнее об этом читайте в статье «Что означает каждое поле в редакторе» в разделе «[Вкладка Analytics](/doc/ru/chatbot/builder/setting/analitika.md)».
{% endhint %}

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

Флажок «Отображать шаги для всех значений» необходим для полного отображения значений при расчёте статистики на графике, если вам нужна более подробная информация в виджете.

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

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

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

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

В этом случае в статистике будет учитываться количество посещений сайта (НЕ уникальные клиенты).

#### Фильтры

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

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

Например, у вас есть несколько списков, в которые входят клиенты. Этот тип виджета поможет вам показать точное количество клиентов, присутствующих в каждом из списков, и отобразить их в виджете.

#### Как настроить виджет?

Сначала нужно добавить необходимое количество значений для отображения данных в виджете.

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

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

После этого выберите нужный фильтр для отображения количества клиентов.

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

Если вы не зададите название шага, по умолчанию будут «Шаг 1», «Шаг 2» и т. д.

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

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

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

2. Списки и метки — значение отображает количество клиентов соответственно в заданных вами списках и метках.

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

Это похоже на каналы. Вы также можете выбрать сразу несколько списков/меток, чтобы отображать клиентов по фильтрам.

3. Блок воронки — шаг будет показывать количество клиентов по соответствующему блоку(ам) воронки.

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

3. По клиентам: отписавшиеся, исключая их или отображая всех.

Вы можете применить это как дополнительный фильтр в значении для клиентов: например, чтобы просматривать данные по отписавшимся клиентам в определённых каналах.

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

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

5. Будут отображаться клиенты со статусом «Отписался», независимо от того, когда пользователь отписался.
6. По тегу — системной переменной, назначенной клиенту.

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

### Как удалить виджет

Чтобы удалить или продублировать виджет, нужно найти соответствующую иконку прямо на самом виджете.

<div data-with-frame="true"><figure><img src="/files/67b0a13396444838f25e9a65bab1b85ecae85be2" 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/ru/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.