Отчёты¶
Раздел в интерфейсе: Отчёты. Три режима — Таблица, Воронка и Когорты; период и фильтры у них общие, а режим даты влияет только на Таблицу и Воронку — когорты всегда считаются по дате клика. Период — 24 часа, 7, 30 или 90 дней, верхняя граница всегда «сейчас».
Дашборд¶
Стартовый экран: KPI за период (клики, конверсии и CR, доход и EPC, ROI и профит), график дохода и расхода, воронка «клики → уникальные → конверсии → продажи», тепловая карта 7×24 (день недели × час), карта кликов по странам, топ кампаний и стран. Период — сегодня, 7 или 30 дней; блоки переставляются кнопкой Настроить. Данные обновляются в реальном времени — без перезагрузки страницы.
Метрики¶
| Метрика | Как считается |
|---|---|
clicks |
все клики |
unique_clicks |
уникальные посетители (по visitor_id) |
conversions |
все конверсии |
leads / sales / rejected |
конверсии по статусам; свой статус попадает в ту корзину, которая указана у него в counts_as |
revenue |
сумма выплат по конверсиям |
cost |
расход по режиму cost кампании |
profit |
revenue − cost |
cr |
конверсии / клики × 100 |
epc |
доход на клик |
roi |
profit / cost × 100 |
roas |
revenue / cost |
cpa |
cost / конверсии |
cpl |
cost / лиды |
approval_rate |
(конверсии − rejected) / конверсии × 100 |
Деньги считаются в базовой валюте воркспейса: cost и revenue нормализуются по курсу на дату клика, поэтому кампании в разных валютах складываются корректно.
Итоговая строка считается по всему результату, а не по загруженной странице, и проценты в ней выводятся из сумм — это средневзвешенные значения, а не среднее по строкам.
Измерения¶
| Группа | Измерения |
|---|---|
| Структура | кампания, поток, лендинг, оффер, источник |
| Гео и устройство | страна, регион, город, устройство, ОС, браузер, ISP, язык |
| Трафик и SEO | keyword, search engine, referrer |
| Токены источника | ad campaign, adset / group, creative / ad, source / site |
| Время | дата, час, день недели |
| Sub ID | sub_id_1 … sub_id_30 |
Измерений в одном отчёте — до 16. Без измерений отчёт схлопывается в одну итоговую строку за период.
Группировка и drill-down¶
Выбранные измерения задают строку: две группировки — строка на каждую комбинацию, например «страна × устройство».
Отдельно настраивается цепочка раскрытия: измерения, по которым строка разворачивается вглубь по клику на ▸. Например строки по кампаниям, а внутри — источник ▸ креатив; уровни подгружаются по мере раскрытия, с теми же фильтрами и сортировкой.
Кампании, потоки, лендинги, офферы и источники показываются именами, а не UUID; удалённая сущность так и подписана — «удалено» с началом её id.
У первой группировки есть колонка ± с пометками W и B: отмечаете значения прямо в отчёте, а кнопки в панели таблицы копируют белый или чёрный список в буфер — готовым к вставке в рекламный кабинет.
Фильтры¶
Фильтрация серверная: применяется ко всему результату, а не к загруженной странице.
=, ≠, в списке, не в списке, содержит, не содержит, начинается с,
заканчивается на, regexp. Превращаются в условие запроса к базе.
>, ≥, <, ≤, =, ≠, между. Считаются после агрегации — так
отсекают строки вроде clicks < 100 или roi < −30. Работают и с
кастомными метриками.
Дата отчёта и сравнение¶
Переключатель Дата отчёта решает, к какому дню отнести конверсию:
- дата клика — конверсия попадает в день, когда пришёл клик (атрибуция: сколько принёс трафик вторника, даже если постбэк пришёл в четверг);
- дата конверсии — в день, когда пришёл постбэк (cash-flow: сколько денег пришло вчера).
Флажок Сравнение с пред. периодом добавляет к каждой метрике значение за
предыдущий отрезок такой же длины и процент изменения; строки, которых в
прошлом периоде не было, помечаются new.
Кастомные метрики¶
Формула из готовых метрик, + − * / и скобок — без функций и условий:
(leads * 0.8 - cost) / clicks. Идентификаторы — те же имена, что в таблице
метрик выше. Выражение проверяется при сохранении: сломанное не принимается.
Метрика бывает двух видов:
- локальная — живёт в текущем отчёте;
- глобальная (кнопка Глобальные) — сохраняется в воркспейсе и доступна во всех отчётах как колонка, ключ сортировки и поле фильтра.
Локальная метрика с тем же именем перекрывает глобальную.
Сохранённые отчёты¶
Сохранить запоминает измерения, цепочку раскрытия, кастомные метрики, фильтры, сортировку, период и режим даты. Кнопка Сохранённые открывает список: применить в один клик или удалить. Отчёт принадлежит тому, кто его создал.
Экспорт¶
Меню Экспорт в панели таблицы:
- CSV, JSON, Excel (.xls) — файл собирается в браузере из видимых колонок, с именами вместо UUID;
- CSV (сервер) и HTML (сервер) — сервер стримит готовый файл с полным набором колонок метрик и кастомными метриками.
За один раз выгружается до 100 000 строк. Если результат больше, выгружаются первые 100 000 по текущей сортировке — панель предупреждает об этом, молча файл не обрезается.
Воронка¶
Этапы задаются сами: клики, уникальные и любые статусы конверсий, включая собственные, — порядок выбора статусов становится порядком этапов. По каждому этапу видно число, долю от первого этапа, долю от предыдущего и абсолютную потерю.
Разбивка по любому измерению (кроме временных) строит отдельную воронку на каждое значение — так сравнивают источники или гео между собой. Показываются 50 крупнейших сегментов по первому этапу, остальные отбрасываются с предупреждением.
Когорты¶
Строка — когорта по дате (или часу) клика, колонки — лаг до конверсии: D0 —
конверсии в тот же день, D1 — на следующий и так далее; хвост складывается в
последнюю колонку D7+. Колонок от 2 до 31, по умолчанию 8.
В клетке — CR от кликов когорты, число конверсий или доход; накопительно или по отдельным лагам. Это ответ на вопрос «через сколько приходят деньги»: видно задержку постбэков и то, как набирается апрув в следующие дни. Лаги, которые для когорты ещё не наступили, не заполняются.
Тепловая карта на дашборде — про другое
Блок «Когорта» на дашборде — карта 7×24 (день недели × час): когда идёт трафик. Режим Когорты в отчётах — про задержку конверсий.
Пределы и скорость¶
Отчёт отказывается строиться, если комбинация измерений даёт больше 500 000 групп: сузьте период, добавьте фильтры или возьмите более крупное измерение. Молча обрезанного результата не бывает.
Конверсия хранит измерения своего клика рядом с собой — гео, устройство, ISP,
sub_id_1 … sub_id_30, — поэтому отчёт по конверсиям не соединяется с
таблицей кликов. Его скорость зависит от числа конверсий, а не от объёма
трафика, и он остаётся быстрым на длинных периодах.
Симулированный трафик¶
Клики из Симулятора помечены как симулированные и по умолчанию не считаются. Показывает их флажок Симуляция → показывать симулированный трафик, общий для дашборда, отчётов и журнала кликов; после генерации симулятор включает его сам, иначе свежие данные было бы негде увидеть.
Удаляются такие клики целиком кнопкой на странице Симулятор. В метрики авто-правил они не попадают никогда.
API¶
Те же отчёты доступны через Admin API: POST /reports/query
(таблица), POST /reports/funnel, POST /reports/cohort,
POST /reports/export, GET /reports/dashboard, GET /reports/timeseries,
GET /reports/group-by, GET /reports/dimensions (список допустимых
измерений), а также CRUD /saved-reports и /custom-metrics.
Удаление статистики
POST /reports/clean удаляет клики и/или конверсии по кампании и
диапазону дат. Кнопки в интерфейсе нет, отмены тоже — только API.