Списки метрик
Список метрик объединяет несколько метрик с заранее заданными разрезами в один переиспользуемый объект. Вы настраиваете его один раз и подключаете к любому числу экспериментов - метрики не нужно добавлять по одной в каждом эксперименте.
Список создаётся в интерфейсе Trisigma и подключается в форме эксперимента на шаге «Метрики». К одному эксперименту можно подключить несколько списков.
Ожидаемые эффекты (lift, приоры) задаются отдельно, в цели эксперимента, а не в списке метрик. Список отвечает только за то, какие метрики и в каких разрезах считать.
Из чего состоит список
Список собирается из трёх частей:
- набор метрик - какие метрики входят в список;
- набор разрезов - в каких разрезах считать метрики;
- пресет - связка набора метрик с одним или несколькими наборами разрезов.
Набор метрик и набор разрезов задаются в формате YAML, пресет - отдельной формой. Списки метрик находятся в разделе Метрики → Пресеты.
Набор метрик
YAML-список: каждая метрика на отдельной строке с префиксом - . Имена метрик должны совпадать с теми, что объявлены в семантическом слое. Где задаются метрики - в шаге quickstart Настройка метрик и в разделе Metrics.
- purchases_ecom
- revenue_ecom
- views_ecom
- added_to_cart_ecom
Набор разрезов
YAML-список, где каждый элемент - отдельная разбивка отчёта. Элемент задаёт дименшен и его значения: - { дименшен: [значения] }. Имена дименшенов и их значения должны совпадать с объявленными в семантическом слое. Где задаются дименшены и справочники их допустимых значений - в разделе Dimensions.
- product_type: ['Туфли']
- product_type: ['Сланцы']
Формы записи разрезов
| Форма | Запись | Что считается |
|---|---|---|
| Одно значение | - product_type: ['Туфли'] | разбивка по product_type для значения Туфли |
| Несколько значений | - product_type: ['Туфли', 'Сланцы'] | одна разбивка по product_type: значения Туфли или Сланцы |
| Скрещивание дименшенов | - { product_type: ['Туфли'], device: ['mobile'] } | одна комбинированная разбивка по product_type и device |
| Булев дименшен | - is_subscriber: ['true'] | булево пишется строкой в нижнем регистре: 'true' или 'false' |
| Несколько разбивок | два и более элемента - | каждый элемент - отдельная независимая разбивка |
Формы комбинируются - несколько значений и скрещивание в одном элементе:
- { product_type: ['Туфли', 'Сланцы'], device: ['mobile'] }
В отчёте значения одного дименшена выводятся через |, скрещённые дименшены - через запятую. Запись выше даёт разбивку product_type[Туфли | Сланцы], device[mobile].
Принципы: один элемент списка - одна разбивка; значения всегда строки (даже одно: ['Туфли']); отдельного элемента «без разбивки» в наборе нет - каждый элемент задаёт конкретную разбивку. Чтобы видеть true и false раздельно, вынесите их в отдельные элементы - как Туфли и Сланцы выше.
Пресет
Связывает готовый набор метрик с одним или несколькими наборами разрезов. Задаётся отдельной формой, YAML вводить не нужно.
Готовый пресет показывает, какой набор метрик с каким набором разрезов считается:
Зачем нужен список метрик
- Переиспользование. Один список подключается к любому числу экспериментов - настройка хранится отдельно и не дублируется.
- Единообразие. Команда считает одни и те же метрики в одних и тех же разрезах во всех экспериментах.
- Скорость. Метрики не добавляются по одной в каждом новом эксперименте.
Как подключить к эксперименту
- Создайте набор метрик и хотя бы один набор разрезов.
- Свяжите их пресетом.
- В форме эксперимента на шаге «Метрики» подключите список. К одному эксперименту можно подключить несколько.
При подключении можно исключить отдельные метрики или отдельные разрезы для конкретного эксперимента. Сам список при этом не меняется - исключения действуют только в этом эксперименте.
Ограничения
- Лимиты размера. Число списков, размер набора метрик и суммарный размер ограничены. Значения настраиваются на стороне платформы и зависят от инсталляции. Размер - это число уникальных пар «метрика - разрез».
- Удаление. Набор метрик или разрезов нельзя удалить, пока он входит хотя бы в один список. Сначала отвяжите его от всех списков.
- Владелец. Владельцем становится тот, кто создал объект первым. При последующих правках владелец не меняется.
Ошибки валидации
неизвестная метрика: <имя>- метрика не объявлена в семантическом слое. Проверьте написание имени.- Ошибка на каждую букву (
неизвестная метрика: h, затемo,tи так далее) - в наборе метрик пропущен-перед именами. Без префикса YAML склеивает строки в один скаляр и разбирает его по символам. Добавьте-к каждой строке. Неизвестный дименшен: <имя>- дименшен не объявлен в семантическом слое. Проверьте написание имени.Неизвестное значение <значение> для дименшена <дименшен>- у дименшена нет такого значения. Проверьте значение в наборе разрезов.