docs_content/what_bot_understands.md

Что понимает бот

Метрики

Бот понимает базовые и производные метрики. Самые полезные пользовательские формулировки:

  • бюджет / расход
  • лиды
  • выручка
  • оплаты
  • ROMI / окупаемость
  • цена заявки
  • средний чек
  • конверсия
  • автооплаты
  • показы
  • клики

Также поддерживаются более узкие внутренние метрики вроде пользователей, посетителей, заказов, оплат ЧПЗ, рассрочек, дебиторки и связанных выручек. Полный user-facing список вынесен на страницу Метрики и срезы.

Если бот не уверен, какую именно метрику вы имеете в виду, он попросит уточнение.

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

Теперь базовый FACT-движок поддерживает до 7 метрик в одном запросе, если у них общий:

  • период
  • набор фильтров
  • срез
  • атрибуция
  • тип даты

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

  • лиды
  • расход
  • выручку
  • ROMI 2
  • цену лида

Для loss-вопросов бот также понимает формулировки:

  • где сливаем деньги
  • где не окупается
  • куда уходит бюджет без результата

Отдельно внутри режима ANALYZE работает свободный анализ через agent-only runtime. Это не набор отдельных family, а общий agent с безопасными инструментами доступа к данным. Он может запрашивать метрики и срезы через query_data, сравнивать периоды и собирать рекомендации поверх полученных чисел.

Подробности вынесены на страницу Свободный анализ.

Срезы

Бот умеет строить ответ по следующим срезам:

  • подрядчик
  • канал
  • тип трафика
  • воронка
  • кампания
  • объявление
  • рекламный кабинет
  • группа объявлений
  • год / месяц / дата события
  • год / месяц / дата регистрации
  • месяц / дата события
  • месяц / дата регистрации

Для кампаний и объявлений бот старается показывать и ID, и название вместе. Отдельно поддерживаются также source / medium / campaign через UTM-сущности.

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

  • ВК, vk, ВК таргет -> ВК таргет
  • Соц сети -> Соц.сети
  • Нейро доход -> нейродоход
  • фдк 26 -> фдк26

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

  • по каналу "ВК таргет"
  • по подрядчику "ALEX"
  • по воронке "нейродоход"

Периоды

Бот понимает:

  • конкретный месяц: за февраль 2026
  • год: за 2025 год
  • относительные периоды: вчера, в этом году, последние 12 месяцев, последние 30 дней
  • периоды для динамики: по дням, по месяцам, по годам, в динамике помесячно

Если период не указан, бот может взять период по умолчанию и показать это в интерпретации.

Для вопросов про аномалии лучше всего работают формулировки вроде:

  • за последнюю неделю
  • за этот месяц
  • за март 2026

В режиме ANALYZE бот сравнивает текущий период с предыдущим равным окном и дополнительно смотрит фон предыдущих окон.

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

Атрибуция

Поддерживаются:

  • по первому касанию
  • по последнему касанию
  • с закреплением за ХТ на 14 дней

Если атрибуция не указана, может использоваться значение по умолчанию.

Тип даты

Поддерживаются:

  • дата события
  • дата регистрации

Если тип даты не указан, бот обычно использует дату события.