Списки метрик

Список метрик объединяет несколько метрик с заранее заданными разрезами в один переиспользуемый объект. Вы настраиваете его один раз и подключаете к любому числу экспериментов - метрики не нужно добавлять по одной в каждом эксперименте.

Список создаётся в интерфейсе 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 вводить не нужно.

Готовый пресет показывает, какой набор метрик с каким набором разрезов считается:

Зачем нужен список метрик

• Переиспользование. Один список подключается к любому числу экспериментов - настройка хранится отдельно и не дублируется.
• Единообразие. Команда считает одни и те же метрики в одних и тех же разрезах во всех экспериментах.
• Скорость. Метрики не добавляются по одной в каждом новом эксперименте.

Как подключить к эксперименту

1. Создайте набор метрик и хотя бы один набор разрезов.
2. Свяжите их пресетом.
3. В форме эксперимента на шаге «Метрики» подключите список. К одному эксперименту можно подключить несколько.

При подключении можно исключить отдельные метрики или отдельные разрезы для конкретного эксперимента. Сам список при этом не меняется - исключения действуют только в этом эксперименте.

Ограничения

• Лимиты размера. Число списков, размер набора метрик и суммарный размер ограничены. Значения настраиваются на стороне платформы и зависят от инсталляции. Размер - это число уникальных пар «метрика - разрез».
• Удаление. Набор метрик или разрезов нельзя удалить, пока он входит хотя бы в один список. Сначала отвяжите его от всех списков.
• Владелец. Владельцем становится тот, кто создал объект первым. При последующих правках владелец не меняется.

Ошибки валидации

• неизвестная метрика: <имя> - метрика не объявлена в семантическом слое. Проверьте написание имени.
• Ошибка на каждую букву (неизвестная метрика: h, затем o, t и так далее) - в наборе метрик пропущен - перед именами. Без префикса YAML склеивает строки в один скаляр и разбирает его по символам. Добавьте - к каждой строке.
• Неизвестный дименшен: <имя> - дименшен не объявлен в семантическом слое. Проверьте написание имени.
• Неизвестное значение <значение> для дименшена <дименшен> - у дименшена нет такого значения. Проверьте значение в наборе разрезов.