# Аналитика клиентов

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

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

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

По умолчанию в разделе "Аналитика" - "Клиенты" существуют три виджета, о которых расскажем подробнее далее:

1. [Сводка](#vidzhet-svodka);
2. [Клиенты](#vidzhet-klienty);
3. [Клиенты по каналам](#vidzhet-klienty-po-kanalam).

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

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

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

## Виджеты по умолчанию

### **Виджет "Сводка"**

Виджет по умолчанию "Сводка" представляет собой краткий обзор аналитики по клиентам, подразделяющийся на несколько частей:

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

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

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

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

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

* Выбранный период времени сводки:

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

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

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

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

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

### **Виджет "Клиенты"**

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

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

а) Общее количество клиентов за год и за месяц, отображаемое вверху диаграммы:

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

б) Столбчатая диаграмма, в которой отображен период с января по декабрь:

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

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

В данном виджете также можно менять цвета столбцов для большей наглядности:

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

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

* По спискам и меткам:

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

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

* По каналам:

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

* По блоку воронки:

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

* По клиентам:

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

* По тегу:

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

Тег - это системная переменная, которая указывается в настройках сайта. Тег присваивается клиенту, если он запустил бота с сайта и если вы указали тег в настройках сайта.&#x20;

{% hint style="info" %}
Подробнее о теге рассказали в разделе "[ТЕГ](/websites/konstruktor-saitov/nastroiki-stranicy-saita.md#teg)" в настройках страницы сайта.
{% endhint %}

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

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

Данный виджет представлен в виде круговой диаграммы, где отображены соотношение количества клиентов по различным каналам (мессенджерам) друг к другу.&#x20;

Из виджета, представленного в качестве примера, видно:

а) общее количество новых клиентов за отчетный период (в данном случае это с 01.01.2024 по 23.01.2024);

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

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

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

#### Видео-разбор

{% embed url="<https://www.youtube.com/watch?v=sdj-t18xjJo>" %}

## **Как создать виджет в разделе "Клиенты"**

Для того чтобы создать свой виджет, нужно нажать на кнопку "Добавить виджет", где можно применить необходимый функционал и отобразить все в нужном ключе.&#x20;

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

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

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

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

<div><figure><img src="/files/n2wmCUWaTAv1VyCsT12v" alt=""><figcaption><p>Круговая диаграмма</p></figcaption></figure> <figure><img src="/files/ZzbBdinIE92c48uq8S3s" alt=""><figcaption><p>Упрощенная диаграмма</p></figcaption></figure></div>

<div><figure><img src="/files/mnzH1bnVR5FpO916d5qf" alt="" width="563"><figcaption><p>Столбчатая диаграмма</p></figcaption></figure> <figure><img src="/files/2QjAwOdv94AGxyuPcMn8" alt="" width="563"><figcaption><p>Линейчатая диаграмма</p></figcaption></figure></div>

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

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

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

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

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

На примере выше мы указали переменную age, в которую записывается возраст клиента в боте. Поскольку нами указано "По переменным клиента", система будет считывать значения клиентов именно по данной переменной и будет учитывать только тех, кому 18 и старше.&#x20;

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

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

Максимальное количество строк (значений переменной) - 6.&#x20;
{% endhint %}

#### Операторы "И" и "ИЛИ"

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

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

1. Фильтрация по оператору "И" обозначает включение значений всех переменных.&#x20;

То есть, если вы выбрали "И", то система будет осуществлять поиск и включение в статистику только тех, у кого есть <mark style="color:red;">**сразу несколько выбранных значений**</mark> переменных.&#x20;

Например, если вы выбрали переменную age, присвоили ей значений 18, а также выбрали переменную gender, присвоив ей значение male (мужчина), и поставили фильтрацию "И", то система осуществит выборку только по тем клиентам, которые являются мужчинами старше 18 лет.&#x20;

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

Условно система понимает, что нужен клиент И старше 18, И мужчина. Других клиентов система не включит в статистику.&#x20;

**Как работает И:**

Можно также делать поиск только по одной переменной.

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

Если написать var1 = 1, var2 = 2, система вернет 0: это сделано для того, чтобы можно было ставить некоторые условия типа var1 != 1 **И** var1 > 0 - в таком случае система вернет тех клиентов, чьи переменные не равны одному и больше нулю (со значениями 2, 3, 4 и т.п.).&#x20;

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

Название переменной для **оператора И** для всех строчек должно быть одним.

Например:

per1 = 1 AND pre2 = 2 - является НЕверным!&#x20;

per1 < 400 AND per1 > 4 - верное написание для переменных.&#x20;
{% endhint %}

{% hint style="warning" %}
Если Вам необходимо использовать переменные следующим образом:

per1 = 1 AND pre2 = 2, то воспользуйтесь оператором ИЛИ.&#x20;
{% endhint %}

2. Фильтрация по оператору "ИЛИ" включает одно из несколько значений (или несколько).&#x20;

Такой фильтр применяется в том случае, если вам нужна выборка клиентов с различными значениями переменных: например, вам нужны клиенты либо старше 18 лет, либо проживающие в городе Москве.&#x20;

Тогда оператор "ИЛИ" включит в выборку всех, у кого есть одна из двух переменных age или city:

То есть, условно система понимает, что нужны те, кто ИЛИ старше 18, ИЛИ проживающие в Москве.&#x20;

**Как работает ИЛИ**:&#x20;

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

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

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

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

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

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

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

Безусловно можно использовать и схему конструктора для учета клиентов, находящихся в определенном состоянии воронки:

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

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

Далее можно применить фильтр отображения клиентов по отпискам или наоборот исключить их:

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

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

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

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

Тег нужно вписать в соответствующее поле:

<div><figure><img src="/files/PducNZCXdXUN8zpFddds" alt="" width="203"><figcaption></figcaption></figure> <figure><img src="/files/5SoAVKDIsQIiA2ekpGih" alt=""><figcaption></figcaption></figure></div>

### UTM-метки

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

{% hint style="info" %}
Чтобы узнать, что такое UTM-метки и как ими пользоваться, рекомендуем прочитать статью "[Как передать параметры и UTM-метки](/websites/konstruktor-saitov/kak-peredat-parametry-i-utm-metki.md)".
{% endhint %}

В первом поле "Название значений" вы прописываете необходимое для отображения результатов в диаграмме наименование:

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

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

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

Далее вписываете необходимое значение метки - это может быть любое присвоенное значение для данных меток:

<figure><img src="/files/VvL9Qk05HWm9hAvDhkbS" alt="" width="540"><figcaption></figcaption></figure>

Аналогично созданию виджета по переменным, здесь существует выбор фильтрации "все значения" и "одно из значений"

{% hint style="success" %}
Если вы создаете виджет по нескольким UTM-меткам и вам необходимо, чтобы итоговый результат включал в себя ВСЕ значения, то используйте оператор "Все значения".

Если вам необходимо отображение результатов по одному из значений, используйте оператор "Одно из значений".&#x20;
{% endhint %}

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

При вводе значения для метки можно установить соответствие:&#x20;

1. равно;
2. не равно;
3. больше;
4. больше или равно;
5. меньше;
6. меньше или равно.

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

Далее вы выбираете из каких каналов учитывать UTM-метки для статистики:

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

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

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

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

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

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

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

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

Далее доступно поля для ввода **тега**: как было написано ранее в разделе "По переменным", тег - это системная переменная, которую можно найти в диалоге с клиентом (ее нельзя изменять).

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

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

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

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

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

1. **Количество** - подсчет числа клиентов за определенный период времени и по определенному событию/категории или сайту.

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

a) все прохождения клиентов

b)  уникальные клиенты (т.е. впервые посетившие за определенный промежуток времени):

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

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

Наглядно покажем разницу отображения виджета с разными значениями для поля "Что считать": возьмем в пример виджет:

<div data-with-frame="true"><figure><img src="/files/Gfd4dtpRaZPRre0XfbmM" alt="" width="562"><figcaption><p>"Что считать" ➡️ Количество</p></figcaption></figure></div>

В данном случае видно, что высчитывает система - это количество клиентов, которые купили/согласились купить шапки.&#x20;

Теперь изменим "Что считать" на сумму значений:

<div data-with-frame="true"><figure><img src="/files/ET1igXWTxjTMOTfb8kuP" alt="" width="560"><figcaption><p>"Что считать" ➡️ Сумма значений</p></figcaption></figure></div>

Теперь система высчитывает значения, присвоенные клиентам: то есть сколько всего шапок купили или согласились купить 10 клиентов.&#x20;

Далее поменяем "Что считать" на среднее значение:

<div data-with-frame="true"><figure><img src="/files/JWMPiyTeISDk9RQ0ejvc" alt="" width="563"><figcaption><p>"Что считать" ➡️ Среднее значение</p></figcaption></figure></div>

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

Далее рассмотрим разницу отображения количества и медианного значения:

<div><figure><img src="/files/rwvd8k6EBVUa7ciNYs2U" alt=""><figcaption><p>Количество</p></figcaption></figure> <figure><img src="/files/DH47vFhtiHCsCs3QaS4E" alt=""><figcaption><p>Медианное значение</p></figcaption></figure></div>

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

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

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

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

Чтобы конверсия работала по воронке, необходимо устанавливать блоки с "Аналитикой" с настройками категорий событий и событиями в схеме конструктора.&#x20;

<div data-with-frame="true"><figure><img src="/files/l9iUIusK4fFEvreQMEiG" alt=""><figcaption><p>Настройки блока в конструкторе воронок</p></figcaption></figure></div>

{% hint style="success" %}
Подробнее об этом в статье "Что в редакторе означает каждое поле" в разделе "[Вкладка 'Аналитика'](/chatbots/builder/message/analytics.md)".&#x20;
{% endhint %}

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

**Чекбокс "Отобразить шаги для всех значений"** необходим для того, чтобы полностью отображать значения при подсчете статистики в диаграмме, если вам нужна более подробная информация в виджете:

<div><figure><img src="/files/oLi1KhUZQ6W8Ek0mM2y1" alt=""><figcaption><p>Чекбокс не активирован</p></figcaption></figure> <figure><img src="/files/WF0uzb3u9tnO6YAt9Xtp" alt=""><figcaption><p>Чекбокс активирован</p></figcaption></figure></div>

В случае если необходимо отображать конверсию по сайту, то в поле "Название шага" можно прописать необходимое наименование (либо оставить по умолчанию - тогда название сгенерируется автоматически) и выбрать необходимый сайт:

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

Для того чтобы учитывалась статистика по сайту, необходимо в настройках сайта в разделе "Аналитика" поставить галочку для сохранения данных:

<div><figure><img src="/files/6n6I5JbdEevnA1jwUVjl" alt="" width="563"><figcaption></figcaption></figure> <figure><img src="/files/BbgrQeyQ7TzF8I6XljEc" alt="" width="563"><figcaption></figcaption></figure></div>

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

### Фильтры

Виджет в виде фильтра поможет отобразить данные, отфильтрованные определенным образом по установленным значениям.&#x20;

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

Например, у вас есть несколько списков, в которые включены клиенты. Данный тип виджета поможет отобразить точное количество клиентов, которые присутствуют в каждом из списков и отобразит их на виджете.&#x20;

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

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

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

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

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

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

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

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

1. Каналы - будет выведено количество клиентов из определенного канала.&#x20;

Например, в проекте у вас подключено несколько Телеграм-каналов: в фильтре можно отобразить значение для каждого.

<div><figure><img src="/files/19jpYPzoXM8PkcGnOgNn" alt=""><figcaption></figcaption></figure> <figure><img src="/files/M2kwgaJgjmFhxI4dyBJe" alt=""><figcaption></figcaption></figure> <figure><img src="/files/PkeboF6Gw4EkWeXcQY3k" alt=""><figcaption></figcaption></figure></div>

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

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

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

3. Блок воронки - шаг выразит количество клиентов по соответствующему (соответствующим) блокам воронки.&#x20;

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

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

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

{% hint style="danger" %}
Обращаем внимание!&#x20;

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

<div data-with-frame="true"><figure><img src="/files/RF3PEQa0U9FBAy764x4n" alt="" width="563"><figcaption><p>Отобразятся клиенты, добавленные со статусом "Отписка", незавимо от того, когда пользователь отписался.</p></figcaption></figure></div>

5. По тегу - системной переменной, присваиваемой клиенту.&#x20;

## Пример работы с конверсиями

В настройках блока схемы чат-бота создайте блок, в котором необходимо настроить события в аналитике:

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

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

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

с полями:

* категория события - обобщенное название для каких-либо событий в боте:

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

Например, к категориям в боте можно отнести:\
а)  обобщенные действия: пришли, купили, оплатили; \
б) обобщенные категории товаров: одежда женская, одежда мужская, обувь, хозтовары и пр.\
в) категории услуги: стрижки, маникюр и т.д.

Является необязательным полем для настройки. &#x20;

* название события, для которого будет собираться статистика (Обязательное поле!)

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

Частное из обобщенной категории.&#x20;

Например, в категории обобщенных действий:

а) пришли: из бота ТГ, из бота ВК, из бота Whatsapp; \
б) купили: товар1, товар2, товар3 и т.п.&#x20;

Является обязательным полем.&#x20;

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

<div><figure><img src="/files/rfdcdEV9k5TCgtgzyl3x" alt=""><figcaption><p>Указание числового значения</p></figcaption></figure> <figure><img src="/files/ttiJjAS5lFImAHmDcasP" alt=""><figcaption><p>Указание значения через переменную</p></figcaption></figure></div>

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

{% hint style="warning" %} <mark style="color:red;">**Внимание:**</mark>**&#x20;в разделе Конверсии -&#x20;**<mark style="color:red;">**"Текущий момент"**</mark>**&#x20; события&#x20;**<mark style="color:red;">**НЕ считаются**</mark>**&#x20;в блоках&#x20;**<mark style="color:red;">**не состояний:**</mark>

* Не состояние передача данных
* Не состояние конец сбора данных
* Не состояние с условием
* Не состояние
  {% endhint %}

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

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

Необходимо создать виджет в разделе "Клиенты":

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

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

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

1\) указать период аналитики

2\) прописать название виджета;

3\) выбрать вид отображения данных для аналитики (круговая диаграмма, столбчатая и тп)

4\) выбрать данные, которые будут отображены в виджете:

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

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

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

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

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

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

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

**Как считать** - параметры для подсчета количества прохождения клиента

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

* Уникальное прохождение - подсчет уникальных пользователей, которые впервые прошли через воронку (данный блок, в котором настроена Аналитики);&#x20;
* Все прохождения - подсчет всех прохождений (как первых, так и повторных) через данный блок воронки.

**Как считать %**

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

* подсчет с первого шага.
* подсчет с последнего шага.

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

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

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

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

Если необходимо отображать только определенное значение событий, то пропишите необходимое значение в строке "Значение событий":

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

Если нужно отображать все значения, то оставьте поле пустым.&#x20;

### Видеообзор: Конверсии в чат-боте

{% embed url="<https://youtu.be/bxyGhJp5sDk>" %}

## Удалить данные конверсий

Удалить данные конверсий можно в разделе Аналитика - Клиенты -  кнопка "Удалить данные конверсий":

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

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

<div><figure><img src="/files/3Lh2f7GMjMWgOsIQDWce" alt="" width="531"><figcaption></figcaption></figure> <figure><img src="/files/nblQAig7Z5NTnQY8EP3V" alt="" width="530"><figcaption></figcaption></figure></div>

1. **Удалить данные по блоку**

В данном случае при выборе удаления данных по блоку, открываются поля для выбора блоков, по которым необходимо очистить данные конверсии, а также клиентов.&#x20;

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

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

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

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

В случае, если вы из выпадающего списка выберите "Удалить данные пользователей по списку" (метке) , откроется дополнительное поле с выбором списка клиентов или меток, данные по которым собираетесь удалить:

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

2. **Удалить данные по категории + событию**

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

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

Удаление конверсии можно осуществить как по одной отдельной категории, так и по всем вместе взятым:

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

Соответственно, при выборе **удалить все категории** по умолчанию во втором поле "Событие" выбирается удаление всех событий.&#x20;

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

В случае, если была выбрана одна категория, то во втором поле "Событие" также можно выбрать либо удаление конверсии по всем событиям, либо по отдельному.&#x20;

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

3. Удалить данные по сайту

При выборе удаления данных конверсии по сайту откроется соответствующее поле для выбора необходимого сайта: одного или нескольких.

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

После того как вами были выбраны необходимые критерии для удаления данных конверсии, необходимо нажать на кнопку "Удалить", после чего появится уведомление следующего вида:

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


---

# 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.salebot.pro/analitika-dlya-biznesa/analitika-salebot/analitika-klientov.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.
