导航
用户测试白名单
最近更新时间：2024.07.05 15:59:16首次发布时间：2021.02.23 10:41:56
在实验正式开启之前，通常需要先选择几名用户进入测试阶段，观察实验是否能够正常获取想要收集的数据，或客户端是否有bug等。参与这一步的用户被称为“白名单用户”。本文为您介绍测试白名单用户的应用场景和添加的操作步骤。
背景信息
实验上线前需要保证SDK的集成过程无误，上线后才能保证实验结果的科学和有效。添加的白名单用户主要用来调试实验/feature，检查白名单用户是否可以命中实验/feature。
您可以在创建实验/Feature过程中手动输入白名单用户的UUID/SSID，也可先将常用的测试用户添加至测试用户白名单中，后续在创建实验/Feature时直接选择。
- 白名单和SSID/UUID是一一对应的，可以为每个难于记忆的SSID/UUID起个别名、打若干个分类标签，便于理解/记忆。
- 在创建实验/feature的过程中，可以直接添加常用白名单，避免多次手动填写长串的SSID/UUID而出错，同时也可以降低管理成本。
说明
UUID和SSID：都是用户的唯一标识，主要区别在于UUID由您和团队为用户分配管理，SSID由火山引擎A/B测试分配管理。
- UUID：即User Unique Id，一般与用户的登录id（如手机号、email）一一对应，UUID由客户来维护；
- SSID：即标准化服务ID（Standardized Service Id），是火山引擎增长营销套件系列产品用来标记和识别用户而提供的用户标识。SSID由火山引擎增长营销套件生成和维护，客户可以根据需要使用。
进入白名单列表页面
您可以登录Tester控制台后，在左侧导航栏的全局设置>受众管理>用户测试白名单进入白名单列表页面。白名单列表为您展示白名单的基本情况，如下图：
可操作内容如下：
- 搜索：可输入“白名单名称、创建人、SSID/UUID、标签”搜索白名单。
- 添加测试白名单：点击“+测试白名单”，填写“白名单名称、描述、等白名单用户信息即可创建。白名单名称和SSID/UUID添加后不可修改。
- 关联实验和Feature：点击具体数字，可查看白名单关联的“实验和Feature”的详情。
- 操作：
- 编辑：仅白名单负责人可修改对应的白名单信息，编辑修改白名单后，已使用该白名单的实验或Feature也会生即时生效。
- 删除：删除白名单后，创建实验或Feature将无法看到该常驻白名单。已使用该白名单的实验和Feature不影响。
新建白名单
单击白名单列表的**+测试白名单**，即可在弹窗中配置新增白名单的参数。
参数 | 配置说明 |
|---|---|
名称&描述 | 自定义白名单的名称和描述，用于标识白名单。 |
负责人 | 白名单维护的负责人。 |
用户白名单 | 输入后续需参与调试的用户用户ID（SSID/UUID），用户ID字符最长不能超过100个字符。
您可以在输入框中直接手动输入，也可单击输入框后的二维码标识，通过扫码录入。 |
使用白名单
- 创建实验：在创建实验的过程中，“添加白名单”位置，下拉可选择常用的白名单，也可创建常用的白名单。
- 创建Feature：在创建Feature的过程中，“发布受众”位置，下拉可选择常用的白名单，也可创建常用的白名单。
如果一个用户是某个版本的白名单用户，那么实验分流对该用户是没有影响的，会固定在该版本。
白名单的用户，实验开启后的数据也会被计算到实验报告里。