# Пользовательская аналитика
{% hint style="warning" %} **`Пользовательская аналитика`** сейчас находится в **бета-версии**.\
После официального релиза эта функция станет платной.
{% endhint %}
***
## Ключевые моменты
* Используйте SQL для запросов к вашим данным BoxHero.
* Объединяйте условия (например, товар, атрибут, цена, диапазон дат, партнёр), чтобы определить данные, которые вы хотите получить в виде пользовательского отчёта.
* Сохраняйте запросы, которые используете часто, и открывайте их снова в любое время.
* Экспортируйте результаты в Excel для дополнительного анализа или отчётности.
## Когда использовать пользовательскую аналитику
Стандартная **`Отчёты по запасам`** функция даёт вам быстрый обзор ключевых показателей, таких как средний остаток и оборачиваемость запасов за выбранный период. Поскольку эти отчёты используют предопределённые формулы и поля, они могут не охватывать все виды анализа, которые нужны вашей команде.
**`Пользовательская аналитика`** даёт вам больше контроля над тем, как вы исследуете свои данные. Она особенно полезна, когда:
* Вы не можете найти нужные данные в стандартной [Отчёты по запасам](https://www.boxhero.io/docs/documentation/ru/drugie-funkcii/analytics)
* Вы хотите фильтровать или группировать данные по товару, поставщику, клиенту, сотруднику или другим детальным условиям
* Вам нужен анализ по времени, например помесячный, поквартальный или год к году
* Вы хотите сохранять отчёты, на которые полагаетесь, и использовать их снова
* Вам нужны гибкие данные для поддержки отчётности или принятия решений
***
## Как использовать пользовательскую аналитику
### 1. Начало работы
Перейдите в **`Отчёты`** > **`Пользовательская аналитика`**. Откроется новое рабочее пространство, где вы сможете создавать и управлять своими SQL-запросами. Затем выберите **`+ Новый`** чтобы создать новый запрос.
### 2. Напишите запрос
Запросы используют [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction). Вы можете скачать файл **`AI Prompt`** чтобы увидеть все доступные таблицы и столбцы.
{% hint style="success" %}
Если вы используете **инструменты ИИ** такие как ChatGPT или Gemini, добавление файла "*AI Prompt"* помогает сгенерировать точный SQL.
{% endhint %}
Выберите **`Выполнить`** чтобы протестировать ваш запрос. Поскольку результаты зависят от условий, которые вы задаёте, проверьте вывод, чтобы убедиться, что он соответствует вашим ожиданиям.
После успешного выполнения запроса вы можете экспортировать результаты с помощью **`Экспорт в Excel`**.
### 3. Сохраните запрос
Если вы планируете использовать запрос повторно, выберите **`Сохранить`** в правом верхнем углу.
Сохранённые запросы отображаются в левой боковой панели, где вы можете открывать и запускать их в любое время.
{% hint style="info" %}
Ваши данные синхронизируются автоматически **раз в день**.\
Чтобы синхронизировать немедленно, нажмите значок синхронизации (🔄) внизу боковой панели.
{% endhint %}
***
## Переменные запроса
Если вы включите `{{variable_name}}` в свой запрос, при его выполнении автоматически будет создано поле ввода. Значение, введённое в это поле, будет подставлено в переменную вашего SQL-запроса.
Когда вы сохраняете запрос, члены вашей команды могут вводить свои значения в поле переменной и запускать отчёт в любое нужное время.
#### Пример
1. Чтобы найти товары, содержащие определённое ключевое слово, введите следующий запрос:
```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```
2. Когда вы запускаете запрос, появляется поле ввода с названием **item\_name** .
3. Введите ключевое слово, например *`свитер`* и результаты покажут все товары с *«свитер»* в названии.
4. Сохраните запрос, если планируете использовать его снова. Вы можете в любой момент выбрать и загрузить сохранённые запросы из левого меню.
***
## Варианты использования
Пользовательская аналитика включает готовые шаблоны, которые можно запустить сразу. Изучите шаблон, чтобы понять, как он работает, затем настройте его или создайте новый запрос в соответствии с вашими потребностями.
#### Шаблоны
* Еженедельный отчёт по поступлению и отгрузке запасов
* Ежемесячный тренд закупок и продаж
* Дата последней отгрузки по товару
***
## Часто задаваемые вопросы (FAQ)
### Могу ли я объединять данные из нескольких команд?
Нет. Данные разделены по командам, и вы можете анализировать только данные той команды, в которую вы сейчас вошли.
### Могу ли я ограничить участников в использовании пользовательской аналитики?
Администраторы и участники могут создавать и просматривать запросы. Участники с пользовательскими правами *не* имеют доступа к этой функции.
Если вам нужно ограничить доступ для участника, назначьте ему [пользовательские права](https://www.boxhero.io/docs/documentation/ru/parametry/members#custom-roles-and-permissions) с **выбранными всеми разрешениями**. Пользовательская аналитика *не* включена в параметры пользовательских прав, поэтому даже при выборе всех разрешений участник не будет иметь доступа.
