1、背景信息

① 什么是白名单用户？

在实验正式开启之前，通常需要先选择几名用户进入测试阶段，观察实验过程是否能正常运行，以及实验策略是否生效等。参与这一步的用户被称为“白名单用户”。（白名单用户数据不会被计入实验结果）

② 白名单用户分类

•临时白名单：在创建/管理实验时，可以通过手动输入用户ID，添加只针对此实验的一次性白名单

•长期白名单：为了在之后实验中重复调用同一组白名单，可以通过手动输入/文件上传的方式，保存常用白名单，避免每次管理实验时重复性输入用户ID的冗杂和易错。

③ 什么是白名单组？

多个白名单用户，在一个组内，即被称为白名单组。

2、白名单组列表

•搜索：输入“白名单名称”即可搜索

•创建白名单组：点击【创建白名单组】按钮，填写信息，即可创建

•编辑：可修改白名单组名称、备注，可添加新的白名单用户ID，可删除现有的白名单用户ID

•查看：可查看白名单内容、别名和创建时间、所绑定实验的ID、版本和绑定时间

•更多：可下载白名单、禁用/上线白名单

3、新增白名单组

点击【创建白名单组】按钮，进入创建流程：

•手动输入：手动输入白名单ID，还可在该页面删除已添加的白名单组

•文件上传：通过文件上传的方式，添加白名单。仅支持 txt 文件，每一行代表一个白名单。（单个实验版本绑定的白名单总数不得超过5000个，一个白名单组内白名单数量不得超过5000个）

4、使用白名单

在实验列表页，在操作中点击【白名单管理】按钮：

进入实验详情页：

在当前弹窗页面，可给该实验的各个版本添加白名单。

•添加临时白名单：填写用户ID，该ID只针对该实验

•选择白名单组：选择已经创建的长期白名单组

•白名单优先级管理：若多个白名单组内添加了同一个白名单，那么可进行白名单优先级管理。比如白名单组“测试1“和“测试2”内，有同一个白名单“AA”，那么选择“测试1”的优先级高于“测试2”，那么白名单“AA”会优先命中“测试1”所在的实验版本。

•其他：如果一个实验有2个版本，“版本1”的临时白名单和“版本2”的白名单组下的某个白名单用户重复，那么不做重复校验，但重复的这个白名单用户默认优先命中“版本1”

白名单命中规则：白名单同时添加在2个不同的实验层的实验，则2个实验都会命中；若添加在同层的2个实验，则后添加的会覆盖前面添加的。