Типы виджетов
Виджеты — это основные строительные блоки дашборда в Metriox. Каждый тип виджета предназначен для решения определенных аналитических задач.
Metriox поддерживает 9 типов отчётов, но они доступны по-разному. Шесть добавляются на дашборд как карточки (Top, Funnel, Table, KPI, Histogram, Series). Остальные три — Heatmap, Retention и Cohort — живут на собственных страницах и на дашборд не добавляются: Heatmap на странице «Аудитория», Retention и Cohort — на одноимённых. Ниже описаны все девять.
1. Top (Топ)
Показывает рейтинг событий или свойств по частоте встречаемости.
Когда использовать:
- Топ-10 самых популярных событий
- Самые активные пользователи
- Популярные экраны или функции
Настройки:
- Метрика: Events, Users, Events per User
- Группировка: по событию или свойству
- Лимит: количество элементов (5, 10, 20, 50)
Пример:
Виджет «Top country» показывает топ стран: RU — 27, NL — 5, DE — 2, US, LV и FI — по 1.
Те же данные можно вывести круговой диаграммой — это альтернативная визуализация того же виджета Top, она показывает доли значений в процентах.
Визуализация:
- Столбчатая диаграмма
- Круговая диаграмма
- Таблица с процентами
2. Funnel (Воронка)
Анализирует последовательность событий и конверсию между шагами.
Когда использовать:
- Воронка покупки
- Онбординг пользователей
- Многошаговые процессы
Настройки:
- Шаги воронки: последовательность событий (минимум 2)
- Временное окно: время между шагами (1 час, 1 день, 7 дней)
- Метрика: Users (уникальные пользователи)
Пример:
Воронка из трёх шагов: Start — 514 пользователей, Trial — 102 (19.84%), Buy — 37 (7.19%). Столбец From previous показывает конверсию из предыдущего шага, From start — от первого шага воронки.
Визуализация:
- Классическая воронка с процентами
- Таблица с абсолютными и относительными значениями
3. Table (Таблица)
Показывает детализированные данные в табличном формате.
Когда использовать:
- Детальный анализ свойств
- Сравнение нескольких метрик
- Экспорт данных
Настройки:
- Строки: группировка по событию или свойству
- Столбцы: метрики (Events, Users, Events per User)
- Сортировка: по любому столбцу
- Фильтры: ограничение строк
Пример:
| Событие | События | Пользователи | События/Польз. |
|---|---|---|---|
| button_click | 15,432 | 3,214 | 4.8 |
| screen_view | 12,891 | 2,987 | 4.3 |
| purchase_started | 3,456 | 1,234 | 2.8 |
| message_sent | 2,105 | 876 | 2.4 |
Визуализация:
- Интерактивная таблица
- Поддержка сортировки и пагинации
4. KPI (Ключевой показатель)
Отображает одно значение метрики — важный показатель эффективности.
Когда использовать:
- Ключевая метрика продукта
- Текущее значение важного показателя
- Быстрый мониторинг
Настройки:
- Метрика: Events, Users, Events per User
- Фильтры: ограничение по событиям или свойствам
- Сравнение: с предыдущим периодом (опционально)
Пример:
Виджет с метрикой MAU: одно крупное число — 28.
Визуализация:
- Крупное число
- Изменение в процентах с иконкой тренда
5. Histogram (Гистограмма)
Двумерная гистограмма для распределения значений.
Когда использовать:
- Распределение по часам дня
- Группировка по числовым свойствам
- Анализ паттернов активности
Настройки:
- Ось X: временной или числовой диапазон
- Ось Y: метрика (Events, Users)
- Бакеты: группировка значений (часы, интервалы)
Пример:
Распределение значений по бакетам с шагом 30 — от 0–30 до 720–750. Самый крупный бакет — 150–180 (122), самые мелкие — 60–90 (8) и 420–450 (12).
Визуализация:
- Столбчатая диаграмма
- Тепловая карта
6. Series (Временной ряд)
График изменения метрики во времени.
Когда использовать:
- Динамика активности
- Тренды по дням/неделям
- Сравнение периодов
Настройки:
- Метрика: Events, Users, Events per User
- Гранулярность: минута, час, день, неделя, месяц
- Линии: одна или несколько метрик
- Сглаживание: скользящее среднее (опционально)
Пример:
Временной ряд с часовой гранулярностью: ночью активность держится на минимуме, растёт с 08:00 и достигает пика к 13:00.
Визуализация:
- Линейный график
- Область под графиком
- Несколько линий для сравнения
7. Heatmap (Тепловая карта)
Показывает распределение активности по двумерной сетке: день недели + час суток или день месяца + час суток.
Когда использовать:
- Определить пиковые часы активности пользователей
- Планировать рассылки и уведомления
- Выявлять паттерны поведения по времени
Настройки:
- Режим: День недели × Час (
WeekdayHour) или День × Час (DayHour) - Метрика: Events, Users, Events per User
- Часовой пояс: для корректного отображения по местному времени
Пример:
Уровень активности по дням недели и часам суток. В интерфейсе уровни показаны цветом: чем темнее ячейка, тем выше активность.
| День недели | 00 | 02 | 04 | 06 | 08 | 10 | 12 | 14 | 16 | 18 | 20 | 22 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Пн | низкая | низкая | низкая | низкая | средняя | высокая | высокая | высокая | высокая | высокая | средняя | низкая |
| Вт | низкая | низкая | низкая | низкая | средняя | высокая | высокая | высокая | высокая | высокая | средняя | низкая |
| Ср | низкая | низкая | низкая | низкая | средняя | высокая | высокая | высокая | высокая | высокая | средняя | низкая |
| Чт | низкая | низкая | низкая | низкая | средняя | высокая | высокая | высокая | высокая | высокая | средняя | низкая |
| Пт | низкая | низкая | низкая | низкая | средняя | высокая | высокая | высокая | высокая | высокая | средняя | низкая |
| Сб | низкая | низкая | низкая | низкая | низкая | средняя | средняя | средняя | средняя | низкая | низкая | низкая |
| Вс | низкая | низкая | низкая | низкая | низкая | средняя | средняя | средняя | средняя | низкая | низкая | низкая |
Визуализация:
- Цветовая шкала: чем темнее — тем больше активность
8. Retention (Удержание)
Показывает, какой процент пользователей возвращается в бот через N дней после первого визита.
Каждый столбец — один период: Day 7 значит «вернулся именно на 7-й день», а не «в течение 7 дней». Накопительные показатели «в течение N дней» смотрите на странице Vitals.
Когда использовать:
- Измерять удержание пользователей (D1, D7, D30)
- Сравнивать удержание разных когорт
- Оценивать эффект изменений на возвращаемость
Настройки:
- Стартовое событие: любое (все пользователи) или конкретное событие по фильтру
- Возвратное событие: любое (все пользователи) или конкретное событие по фильтру
- Группировка: календарная единица когорт и шага возврата — день, неделя или месяц (неделя считается с понедельника)
- Окно наблюдения: сколько единиц группировки отслеживать возврат (например, 30 дней, 12 недель или 12 месяцев)
Пример:
Таблица когорт с дневной гранулярностью: строка — когорта, столбцы Day 0 … Day 13 — доля вернувшихся пользователей. Чем насыщеннее зелёный, тем выше удержание.
Настройки виджета собраны в панели Retention Configuration: там выбираются стартовое и возвратное события (Start Event и Return Event) и общий фильтр (Global Filter). Ниже — те же когорты с недельной гранулярностью, Week 0 … Week 7.
Визуализация:
- Таблица когорт с цветовой шкалой по проценту удержания
9. Cohort (Когорты)
Группирует пользователей по дате первого появления и показывает размер каждой когорты.
Когда использовать:
- Отслеживать рост аудитории по когортам
- Сравнивать размеры когорт до и после изменений
- Анализировать сезонность притока пользователей
Настройки:
- Стартовое событие: любое (все новые пользователи) или конкретное событие по фильтру
- Размер бакета: интервал группировки (например, 7 = недельные когорты)
Пример:
| Когорта | Новых пользователей |
|---|---|
| 01–07 апр | 1 200 |
| 08–14 апр | 1 450 |
| 15–21 апр | 1 100 |
| 22–28 апр | 980 |
Визуализация:
- Столбчатая диаграмма или таблица по периодам
Общие настройки виджетов
Настройки ниже относятся к карточкам дашборда. У Heatmap, Retention и Cohort на их страницах свой набор настроек — например, у Retention это размер когорты и событие возврата.
Размер и расположение карточки
Размер задаётся не в настройках, а прямо на карточке: наведите на неё курсор и потяните за правый край (ширина), нижний край (высота) или за угол (сразу оба). Пока вы тянете, карточка показывает результат по-настоящему — соседи расступаются так же, как после отпускания. Отпустили — сохранилось, локально и на сервере, без кнопки «Сохранить».
Порядок меняется перетаскиванием за значок в левом верхнем углу карточки.
Сетка — 12 колонок. Карточка занимает целое число колонок, поэтому карточки всегда выравниваются друг по другу, а не встают «почти ровно». По высоте шаг такой же дискретный. Если после широкой карточки в строке остаётся место, следующая карточка, которая туда влезает, займёт его сама — пустых провалов в сетке не остаётся.
На узких экранах (до 768 px) карточки выстраиваются в одну колонку на всю ширину, а перетаскивание отключается: там менять ширину нечем. Сохранённый размер при этом не теряется — он вернётся, как только вы откроете дашборд на широком экране.
Ручки изменения размера получают фокус по Tab, дальше стрелки меняют размер на одну ячейку. Escape отменяет начатое перетаскивание.
Временной диапазон (Time Range)
- Последние 1 час / 6 часов / 24 часа
- Последние 7 дней / 14 дней / 30 дней / 90 дней
- Пользовательский период
Гранулярность (Granularity)
Только для виджета Series. У Histogram своя группировка — по значению числового свойства, а не по времени.
Гранулярность задаёт размер временно́го интервала, в который группируются события. У каждой из них свой максимальный период: чем детальнее интервал, тем короче отрезок времени, который можно за раз запросить.
| Гранулярность | Максимальный период | Точек на максимуме |
|---|---|---|
| Минута | 2 часа | 120 |
| Час | 90 дней | 2 160 |
| День | 370 дней | 370 |
| Неделя | 1 100 дней (около 3 лет) | 157 |
| Месяц | 1 830 дней (около 5 лет) | 60 |
Ограничения существуют, чтобы один запрос не мог потребовать неограниченного числа точек. Запрос с
периодом больше допустимого отклоняется с кодом 400 и сообщением, которое называет сам предел —
например, Minute granularity is limited to 02:00:00. Это осознанный отказ, а не ошибка: график не
строится вместо того, чтобы строиться очень долго.
Недели начинаются с понедельника (UTC) — так же, как когорты в Retention и календарные периоды в Vitals, чтобы «неделя» везде означала одно и то же. Месяцы — календарные, с первого числа.
Авто (Auto)
Значение по умолчанию. Сервер выбирает самую детальную гранулярность, при которой получается не больше 400 точек и не превышается её максимальный период:
| Запрошенный период | Гранулярность | Точек |
|---|---|---|
| до 400 часов (около 16,5 дней) | Час | до 400 |
| от 16,5 до 370 дней | День | до 370 |
| от 370 до 1 100 дней | Неделя | до 157 |
| от 1 100 до 1 830 дней | Месяц | до 60 |
Границы задаются двумя разными правилами, и это стоит различать. Переход Час → День задаёт цель в 400 точек: 400 часов — это примерно 16,5 дней. А переход День → Неделя задаётся не целью, а максимальным периодом Дня: на 370 днях это всего 370 точек, то есть цель ещё не достигнута, но дальше День просто не разрешён. Поэтому год данных остаётся дневным, а не становится недельным.
Авто никогда не выбирает Минуту — её нужно указать явно.
Фактически применённая гранулярность всегда возвращается в ответе в поле usedGranularity, поэтому по
графику видно, что именно было построено, даже если выбрано Авто.
Фильтры
Все виджеты поддерживают фильтрацию:
- По событиям
- По свойствам событий
- Комбинации условий (AND/OR/NOT)
Подробнее: Фильтры
Метрики
Доступные метрики зависят от типа виджета:
- Events — количество событий
- Users — количество уникальных пользователей
- Events per User — среднее количество событий на пользователя
Подробнее: Метрики
Примеры использования
Мониторинг активности
Комбинация виджетов:
- KPI: активных пользователей за день
- Series: график DAU за месяц
- Top: топ-10 событий
Анализ воронки покупки
Комбинация виджетов:
- Funnel: воронка от старта до покупки
- Table: детализация по шагам
- Series: динамика конверсии по дням
Engagement анализ
Комбинация виджетов:
- Histogram: распределение активности по часам
- Series: Events per User по дням
- Top: самые вовлеченные пользователи
Лучшие практики
Выбор типа виджета
- Top — для рейтингов и популярности
- Funnel — только для последовательных процессов
- Table — когда нужны детали и экспорт
- KPI — для одной важной метрики
- Histogram — для распределений числовых свойств
- Series — для трендов во времени
- Heatmap — для паттернов активности по времени суток/дням
- Retention — для измерения удержания пользователей
- Cohort — для анализа роста и притока аудитории
Настройка виджетов
- Используйте осмысленные названия: "Конверсия в покупку", а не "Воронка 1"
- Настраивайте цвета для лучшей читаемости
- Добавляйте описания к виджетам
- Группируйте связанные виджеты на одном дашборде
- Таблицам и воронкам давайте высоту побольше: содержимое внутри карточки прокручивается, но читать его удобнее, когда видно все строки сразу
Оптимизация производительности
- Избегайте слишком больших временных диапазонов для минутной гранулярности
- Используйте фильтры для ограничения данных
- Не создавайте слишком много виджетов на одном дашборде (оптимально 4-8)