> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/ru/drugie-funkcii/custom-analytics.md).

# Настраиваемая аналитика

<figure><img src="/files/fea7963707d1b4c8340b163c11469f653a5239b1" alt=""><figcaption></figcaption></figure>

***

## Ключевые особенности

* Задавайте вопросы простым языком, и **AI Assistant** напишет SQL за вас.
* Используйте SQL для запроса данных BoxHero.
* Сочетайте условия (например, товар, атрибут, цена, диапазон дат, партнёр), чтобы определить данные, которые вы хотите вернуть в виде настраиваемого отчёта.
* Сохраняйте запросы, которыми пользуетесь часто, и открывайте их снова в любое время.
* Экспортируйте результаты в Excel для дополнительного анализа или отчётности.

## Сценарии использования

Стандартная <mark style="color:$primary;">`отчетах по запасам`</mark> функция даёт вам быстрый обзор ключевых показателей, таких как средний остаток и оборачиваемость запасов за выбранный период. Поскольку эти отчёты используют предопределённые формулы и поля, они могут не охватывать все виды анализа, которые нужны вашей команде.

<mark style="color:$primary;">`Пользовательской аналитике`</mark> даёт вам больше контроля над тем, как вы изучаете свои данные. Особенно полезно, когда:

* Вы не можете найти нужные данные в стандартной [отчетах по запасам](/docs/documentation/ru/drugie-funkcii/analytics.md)
* Вы хотите фильтровать или группировать данные по товару, поставщику, клиенту, сотруднику команды или другим подробным условиям
* Вам нужен анализ по времени, например помесячный, поквартальный или в сравнении с прошлым годом
* Вы хотите сохранять отчёты, на которые полагаетесь, и использовать их снова
* Вам нужны гибкие данные для поддержки отчётности или принятия решений

***

## Как использовать пользовательскую аналитику

### 1. Начало работы

Перейдите в <mark style="color:$primary;">`Отчеты`</mark> > <mark style="color:$primary;">`Пользовательской аналитике`</mark>. Откроется новое рабочее пространство, где вы сможете создавать и управлять своими SQL-запросами. Затем выберите <mark style="color:$primary;">`+ New`</mark> чтобы создать новый запрос.

<figure><img src="/files/9d96ebb4c63f0fd4776904d9e519eb1da693e07c" alt=""><figcaption></figcaption></figure>

### 2. Напишите запрос

У вас есть два способа писать запросы:

1. **Используйте AI Assistant** чтобы сгенерировать SQL из вопроса на простом языке (рекомендуется большинству пользователей).
2. **Пишите SQL напрямую** с помощью [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/2f63bf5c837714f8855928c9f93972840534b508" alt=""><figcaption></figcaption></figure>

#### Использование AI Assistant

Эта <mark style="color:$primary;">`AI Assistant`</mark> превращает вопросы на простом языке в рабочие SQL-запросы. Вам не нужно знать SQL, чтобы пользоваться им.&#x20;

Введите свой вопрос в панели помощника и нажмите Enter. Помощник сгенерирует SQL, вставит его в редактор и выполнит его. Результаты появятся под запросом.

При желании вы можете отредактировать сгенерированный SQL перед сохранением, чтобы что-то скорректировать.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**Примеры вопросов**

* Товары ниже уровня страхового запаса
* Что не продавалось в последние 90 дней?
* Топ-10 SKU по количеству проданных единиц в этом месяце
* Открытые заказы на закупку с просроченной ожидаемой датой прибытия
* Уровни запасов по местоположению&#x20;

#### Создание повторно используемых запросов

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

Например, запрос *"продажи по товару за диапазон дат, который я могу изменить"* создаёт запрос с переменной даты, которая запрашивает ввод каждый раз при выполнении запроса.

<figure><img src="/files/73bcd8b2dac2d7834d961797e285ea95d64c9ce3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
AI Assistant лучше всего работает с **конкретными** **вопросами**. \
Вместо *"покажи мне продажи,"* попробуйте *"топ-10 товаров по выручке в этом месяце."*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
Нажмите кнопку <mark style="color:$primary;">`Chart`</mark> чтобы визуализировать данные — поддерживаются столбчатая, линейная, круговая, составная столбчатая и составная площадная диаграммы.
{% endhint %}

### 3. Сохраните запрос

Выберите <mark style="color:$primary;">`Execute`</mark> чтобы проверить ваш запрос. Поскольку результаты зависят от заданных вами условий, проверьте вывод, чтобы убедиться, что он соответствует ожиданиям.

Если вы планируете использовать запрос повторно, выберите <mark style="color:$primary;">`Сохранить`</mark> в правом верхнем углу. Сохранённые запросы отображаются в левой боковой панели, где вы можете открывать и запускать их в любое время.

После успешного выполнения запроса вы можете экспортировать результаты с помощью <mark style="color:$primary;">`Экспорт в Excel`</mark>.

<figure><img src="/files/ac572253c1d6bdb2edf5f1ded2cbc789cf9b7435" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Ваши данные автоматически синхронизируются **раз в день**.\
Чтобы синхронизировать сразу, нажмите значок синхронизации (🔄) внизу боковой панели.
{% endhint %}

***

## Переменные запроса

Если вы включите `{{variable_name}}` в свой запрос, при его выполнении автоматически создаётся поле ввода. Значение, введённое в это поле, применяется к переменной в вашем SQL-запросе.

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

#### Пример

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

```sql
select sku, name 
from items 
where name ilike '%' || {{item_name}} || '%';
```

2. Когда вы запустите запрос, появится поле ввода с названием **item\_name** .

<figure><img src="/files/2f0aa7ca9e083fa670e57b4c09c3f2494fc23c2c" alt=""><figcaption></figcaption></figure>

3. Введите ключевое слово, например *`sweater`* и результаты покажут все товары с *«sweater»* в названии.

<figure><img src="/files/a6cb45cbe86689e2168f03bd78266a47fe140183" alt=""><figcaption></figcaption></figure>

4. Сохраните запрос, если планируете использовать его снова. Вы можете в любое время выбрать и загрузить сохранённые запросы из левого меню.

<figure><img src="/files/5250c9f97b1f772e0a757f48f2e542d34b80eeb0" alt=""><figcaption></figcaption></figure>

***

## Примеры

Custom Analytics включает встроенные шаблоны, которые можно запустить сразу. Изучите шаблон, чтобы понять, как он работает, затем измените его или создайте новый запрос в соответствии со своими потребностями.

#### Шаблоны

* Еженедельный отчёт по приходу/расходу запасов
* Ежемесячный тренд закупок и продаж
* Дата последней отгрузки по товару

<figure><img src="/files/78f3b3027ec56621a1411ab94490c49af919d78a" alt=""><figcaption></figcaption></figure>

***

## Часто задаваемые вопросы

**Остались вопросы?** Ознакомьтесь с нашими FAQ по Custom Analytics:

{% content-ref url="/spaces/dEaESHNvEvPVtlVQWevo/pages/1744bbe77e323850603494c7dca7e9f628912cf6" %}
[Пользовательская аналитика](/docs/faq/ru/otchety/polzovatelskaya-analitika.md)
{% endcontent-ref %}