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

Сохранённая воронка измеряет путь пользователя по уже собираемым событиям: например, просмотр товара → оформление → оплата, онбординг или путь от обращения в поддержку до конверсии. Это не прежняя воронка только по реакциям из обзора Аналитики: здесь используется общий словарь событий.

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

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

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

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

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

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

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

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

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

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

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

У шага показаны число пользователей, конверсия от первого и предыдущего шага, отвал и медианное время с предыдущего шага. Для разбивки по свойству выводятся не более 25 значений и Другое, поэтому свойство с большим числом значений не создаёт неограниченный отчёт.

Тренд UTC состоит из непрерывных дневных корзин, которые точно покрывают запрошенный диапазон [from, to). Первая, неполная корзина начинается в from, следующие начинаются в полночь UTC. В пустых корзинах стоят нули.

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

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

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

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

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

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

Пример 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.