# Пользовательская аналитика

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

***

## Основные моменты

* Задавайте вопросы простым языком, и **ИИ-ассистент** напишет 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;">`+ Новый`</mark> чтобы создать новый запрос.

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

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

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

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

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

#### Использование ИИ-ассистента

ИИ-ассистент <mark style="color:$primary;">`ИИ-ассистент`</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" %}
ИИ-ассистент лучше всего работает с **конкретными** **вопросами**. \
Вместо *"покажи мне продажи,"* попробуйте *"топ-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;">`Диаграмма`</mark> чтобы визуализировать данные — поддерживаются столбчатая, линейная, круговая, накопленная столбчатая и накопленная областная диаграммы.
{% endhint %}

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

Выберите <mark style="color:$primary;">`Выполнить`</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>

***

## Примеры

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

#### Шаблоны

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

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

***

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

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


---

# 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://www.boxhero.io/docs/documentation/ru/drugie-funkcii/custom-analytics.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.