База знаний GetMyBot

Сохранённые воронки событий

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

На этой странице

Воронка показывает путь клиента по шагам. Например, 100 человек посмотрели товар, 30 начали оформление, 10 оплатили. Такой отчёт помогает найти место, где люди чаще всего останавливаются.

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

Как собрать воронку

Откройте Аналитика → Воронки и создайте воронку из двух-двадцати шагов. Дайте каждому шагу понятное имя и выберите одно или несколько альтернативных событий. Шаг выполнен, когда подходит хотя бы одно из них.

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

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

Время, профиль и аудитория

В отчёте укажите начало (from) и конец (to) периода по времени UTC. Начало включается в отчёт, конец нет. Период не может быть длиннее 366 дней. Дополнительно задайте окно конверсии, время, за которое клиент должен перейти к следующему шагу: от одной минуты до 366 дней. Более поздний переход не засчитывается.

Отчёт считает людей по единому профилю клиента, каноническому профилю. Если профили объединены и источник поддерживает объединение, их события относятся к одному человеку. Анонимные события учитываются по выбранному фильтру; сами по себе они не становятся событиями известного клиента.

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

Режим конверсии нужно выбирать осознанно:

  • Все сейчас показывает первое успешное прохождение клиента, то есть даёт тот же результат, что и Первая. Режим сохранён для совместимости; отдельного подсчёта всех прохождений пока нет.
  • Первая оставляет первую корректную конверсию пользователя.
  • Повторная сохраняет повторные успешные прохождения после первого, но пока не показывает их в отчёте. Числа, разбивки и списки людей для любого режима используют одно лучшее прохождение клиента. Этот режим пока не подходит для отчёта о повторных покупках.

Как читать отчёт

У каждого шага показаны число людей, доля дошедших от первого и предыдущего шага, доля остановившихся и медианное время перехода. Медианное время означает, что половина людей перешла быстрее, половина медленнее. Если сгруппировать отчёт по свойству события, он покажет не более 25 отдельных значений; остальные объединит в Другое.

График по дням использует время UTC. Он покрывает весь выбранный период [from, to): начальная граница включается, конечная не включается. Первый день может быть неполным, остальные начинаются в полночь UTC. Дни без событий показаны нулями.

Предупреждения указывают на особенности данных, а не на статистическую значимость результата. zero_denominator означает, что до первого шага не дошёл никто, поэтому долю дошедших посчитать нельзя. high_cardinality_truncated означает, что часть значений разбивки объединена в Другое после первых 25. Предупреждения partial_data нет. Если считать долю не от кого, интерфейс показывает ноль, а не ошибочный процент.

Когорты и сегменты

Нажмите на число у шага, чтобы увидеть людей, дошедших до него. Такая группа называется когортой. Откроется панель с краткими карточками клиентов и постраничным списком. Служебные и чувствительные поля исходных событий в ней не показаны. В API страницы запрашиваются по курсору, указателю на продолжение списка.

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

Ревизии и безопасное редактирование

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

Пример REST API

Для отчёта нужен персональный токен с analytics:read. Значения ниже: только заполнители, в них нет реального токена или данных клиента.

curl -X POST "$BASE_URL/api/bots/$BOT_ID/funnels/$FUNNEL_ID/query" \
  -H "Authorization: Bearer $PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "revision": 3,
    "from": "2026-07-01T00:00:00Z",
    "to": "2026-08-01T00:00:00Z"
  }'

Устаревшее редактирование вернёт 409 и funnel revision conflict; неверный или неограниченный диапазон вернёт 400 либо 422 в зависимости от места валидации. Для когорты передайте тот же ограниченный диапазон, step_position, completed, limit и курсор из предыдущей страницы. Для сохранения когорты как сегмента дополнительно нужен segments:write.

Связанные материалы