Управление контекстными параметрами и типами участников в интерфейсе

В этой статье разберём, как создать, активировать, изменить, архивировать и удалить контекстный параметр и тип участника без изменений в репозитории метрик. Что это за сущности и как они влияют на эксперимент и отчёт - в обзоре.

Перед началом

• Для просмотра раздела нужно право чтения настроек экспериментирования, для создания и изменения - право редактирования.
• Label после создания не меняется и остаётся занятым даже после удаления.

Где находится раздел

Нажмите «Настройки воркспейса» (значок с ползунками) в нижней части левого меню. Раздел открывается на странице «Экспериментирование» → «Контекстные параметры». «Типы участников» - соседний пункт того же меню.

Список записей

Таблица показывает все записи пространства, включая созданные в репозитории метрик и удалённые.

Колонка	Что показывает
«Название»	Название и под ним label
«Домен»	Домен или -, если домен не задан
«Тип»	Тип данных
«Типы экспериментов»	Только для типов участников: разрешённые типы экспериментов
«Статус»	«Черновик», «Активный», «Архив» или «Удалён»
«Источник»	custom_ui, custom_git или system_git. Подсказка при наведении объясняет, где запись меняется

Над таблицей:

• фильтры «Статус» и «Источник» с множественным выбором;
• поиск по строке;
• переключатель размера страницы: 10, 20 или 50 записей.

Сортировка по клику на заголовок колонки упорядочивает только текущую страницу. Чтобы найти запись среди всех, используйте поиск и фильтры.

Создать контекстный параметр

1. На странице «Контекстные параметры» нажмите «Создать контекстный параметр».

2. Заполните поля:

   Поле	Обязательность	Пример	Описание
   «Название»	Да	"Средний чек"	Название в списках и в конструкторе условий эксперимента
   «Лейбл»	Да	"avg_order_value"	Ключ в randomizationUnits. Латинские строчные буквы, цифры и _, начинается с буквы
   «Домен»	Нет	Не выбран	Без домена параметр доступен в экспериментах любого домена
   «Тип данных»	Да	"float"	Определяет операторы в условии и формат значения в запросе

3. Нажмите «Сохранить черновик», чтобы вернуться к параметру позже, или «Активировать», чтобы сразу сделать его доступным в экспериментах.

Параметр появляется в конструкторе условий на шаге «Дизайн эксперимента» сразу после активации. Splitter начинает проверять условие в течение минуты после запуска эксперимента. Операторы для каждого типа данных - в таблице операторов.

Создать тип участника

1. На странице «Типы участников» нажмите «Создать тип участника».

2. Заполните поля:

   Поле	Обязательность	Пример	Описание
   «Название»	Да	"Магазин"	Название в поле «Тип участника» формы эксперимента
   «Лейбл»	Да	"store_id"	Ключ в randomizationUnits и в поле participant источника метрик
   «Домен»	Нет	Не выбран	Тип участника доступен только в экспериментах с тем же доменом. Укажите домен ваших экспериментов
   «Тип данных»	Да	"int"	Для типа int ключом служит сам идентификатор, для остальных типов ключ строится хешем
   «Типы экспериментов»	Да	regular, retro	Типы экспериментов, в которых можно выбрать этот тип участника

3. Нажмите «Сохранить черновик» или «Активировать».

Список в поле «Типы экспериментов» зависит от настроек вашего пространства:

Значение	Тип эксперимента
regular	Стандартный A/B-эксперимент
retro	Ретроанализ
switchback	Switchback-эксперимент. Доступен не во всех пространствах, включается по запросу в поддержку Trisigma

Тип участника, созданный в интерфейсе, не связан с другими типами участников. Связи между типами (participation_mapping) и маппинг идентификаторов настраиваются только в репозитории метрик.

Отчёт видит новую запись не сразу

Активная запись доступна в форме эксперимента сразу. В отчёт она попадает в течение 10 минут: с такой периодичностью обновляется view, по которому строится отчёт.

Изменить запись

Нажмите на значок карандаша в строке. Что можно изменить, зависит от статуса:

Статус	Что меняется	Как сохранить
«Черновик»	Все поля, кроме «Лейбл»	«Сохранить черновик» или «Активировать»
«Активный»	Только «Название»	«Редактировать», затем «Сохранить»
«Архив», «Удалён»	Ничего	-

Записи с источником custom_git и system_git открываются только для просмотра. В карточке отображается подсказка «Управляется через репозиторий метрик. Изменение только через Pull Request» со ссылкой на репозиторий.

Чтобы изменить тип данных или домен активной записи, создайте новую запись с другим label. Старую архивируйте после того, как приложение и эксперименты перейдут на новую.

Сменить статус

Действие	Из статуса	Где	Подтверждение
Активировать	«Черновик»	Карточка, кнопка «Активировать»	Нет
Архивировать	«Активный»	Значок корзины в строке или «В Архив» в карточке	«Существующие эксперименты продолжат работу». Новые эксперименты с этой записью создать нельзя
Восстановить	«Архив»	Значок стрелки в строке или «Восстановить» в карточке	Запись переходит в статус «Активный»
Удалить черновик	«Черновик»	Значок корзины в строке	«Черновик <label> будет удален безвозвратно.»
Удалить из архива	«Архив»	Кнопка «Удалить» в карточке	«Вы уверены, что хотите удалить архив?»

Активную запись нельзя удалить сразу: сначала архивируйте её. Удаление необратимо, label остаётся занятым.

Удаление не выполняется в двух случаях:

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

Базовые типы user и visitor с источником system_git нельзя архивировать и удалить.

Если что-то пошло не так

Сервер проверяет каждое действие. При ошибке появляется уведомление с текстом сервера и ID запроса, поле с ошибкой подсвечивается.

Контекстный параметр

Ситуация	Текст ошибки	Что сделать
Label занят другим контекстным параметром, в том числе удалённым	Context param label already exists: <label>	Выберите другой label
В домене есть активный или архивный параметр с таким названием	Context param title already exists in domain: <title>	Измените название
Параметр используется в условиях незавершённого эксперимента	Context params used in active experiments cannot be deleted	Дождитесь завершения эксперимента

Тип участника

Ситуация	Текст ошибки	Что сделать
Label занят другим типом участника, в том числе удалённым	Participant type already exists for label: <label>	Выберите другой label
В домене есть активный или архивный тип участника с таким названием	Participant type title already exists in domain: <title>	Измените название
Тип участника выбран в незавершённом эксперименте	Participant types used in active experiments cannot be deleted	Дождитесь завершения эксперимента