> 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 %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/ru/drugie-funkcii/custom-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.