Списки участников

Список участников - заранее подготовленный набор пользователей для эксперимента. Списки используются при разметке типа Разметка списком: в эксперимент попадают все пользователи из списка, независимо от того, заходили ли они на платформу за период эксперимента.

Список можно использовать тремя способами:

1. Как white list - перечислить тех, кто может попасть в эксперимент;
2. Как black list - не дать пользователям из списка попасть в эксперимент;
3. Для назначения пользователей в конкретные группы эксперимента.

Создание списка

В разделе «Списки участников» доступна опция создания списка.

Список состоит из двух колонок - param и ext_param. Они задают значение идентификатора, выбранного в поле «Тип участника»:

• param - идентификатор для отчётов и аналитики. Сохраняется в аналитическом хранилище в том виде, в котором вы его загрузили.
• ext_param - идентификатор для распределения по группам в Splitter. В Splitter он не логируется и не сохраняется.

Платформа не преобразует эти значения и не требует, чтобы они различались. Можно передать в param и ext_param одно и то же число - распределение и отчёт строятся по нему, это корректный сценарий. Обезличивание - на вашей стороне: если по требованиям аналитика должна работать с обезличенными идентификаторами, заранее подставьте обезличенное значение в param, платформа сама его не обезличивает.

Требования к данным:

• Целые числа. Значения param и ext_param - целые. Нечисловые значения не пройдут проверку.
• Диапазон. Значение идентификатора должно помещаться в 64-битное целое число (тип int64, не больше 9 223 372 036 854 775 807). Значение за пределами диапазона не выгружается в Splitter.
• Объём. До 1 000 000 строк в одном списке.

Данные с ошибками не попадают в распределение

Если данные не отвечают требованиям, список получает статус ошибки и не участвует в распределении трафика. Подробнее - в разделе Статусы выгрузки.

Предоставить данные можно двумя способами - файлом CSV или таблицей Trino.

Список из файла CSV

Способ доступен всегда. Загрузите в интерфейсе Trisigma CSV-файл с двумя колонками - param и ext_param. Разделитель определяется автоматически: поддерживаются запятая, точка с запятой, вертикальная черта и табуляция, в шаблоне используется запятая. Ограничения файла - до 1 000 000 строк и до 50 МиБ.

Шаблон файла доступен для скачивания. Ссылка на скачивание также есть в форме создания списка.

Список из таблицы Trino

Способ работает поверх интеграции с вашим хранилищем данных: Trisigma читает таблицу через движок Trino - ту же интеграцию использует весь семантический слой. О подключении хранилища - в разделе Подключение данных.

Создайте таблицу с двумя колонками, param и ext_param, и укажите путь до неё в поле «Источник» в формате каталог.схема.таблица. Если хранилище ещё не подключено, уточните детали у команды Trisigma.

Статусы выгрузки списка

После создания данные списка выгружаются для распределения трафика и построения отчёта. Список не сразу готов к использованию: он встаёт в очередь, проходит проверку и выгружается в Splitter и в отчёты. Выгрузка запускается раз в минуту - небольшой список готов в пределах минуты после создания, для крупного (ближе к лимиту в миллион строк) время больше и зависит от размера. Если вы обновили данные списка, его можно выгрузить повторно - данные в Trisigma обновляются. Текущее состояние отражает статус выгрузки:

Статус	Что означает
«На проверке»	Список в очереди на проверку и выгрузку. Дождитесь завершения.
«Выгружен в сплиттер»	Список проверен и готов к использованию в эксперименте.
«Ошибка валидации»	Список не прошёл проверку. Причины: неверный формат колонок, нечисловые значения, превышен лимит строк. Не участвует в распределении трафика.
«Ошибка»	Сбой при выгрузке в Splitter - например, значение вышло за допустимый диапазон. Не участвует в распределении трафика.
«Выгрузка не требуется»	Для выбранного типа участника выгрузка в Splitter не нужна.

Используйте список только после успешной выгрузки

Список со статусом «Ошибка» или «Ошибка валидации» не участвует в распределении трафика. Эксперимент, который на него ссылается, распределяет трафик некорректно - часть групп остаётся пустой.

Перед запуском эксперимента дождитесь статуса «Выгружен в сплиттер». Если список оказался в ошибке, исправьте данные и выгрузите его повторно.