受众白名单

什么是白名单用户？

• 在实验正式开启之前，通常需要先选择几名用户进入测试阶段，观察实验是否能够正常获取想要收集的数据，或客户端是否有bug等。参与这一步的用户被称为“白名单用户”。

添加常用白名单，有什么好处？

• 白名单和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由火山引擎增长营销套件生成和维护，客户可以根据需要使用。

添加的白名单，主要用来调试实验/feature，检查白名单用户是否可以命中实验/feature。

为什么需要调试实验？

• 实验上线前需要保证SDK的集成过程无误，上线后才能保证实验结果的科学和有效。

白名单列表为您展示白名单的基本情况，如下图：

可操作内容如下：

• 搜索：可输入“白名单名称、创建人、SSID/UUID、标签”搜索白名单。
• 添加白名单：点击“+常用白名单”，填写“白名单名称、描述、SSID/UUID、标签”即可创建。白名单名称和SSID/UUID添加后不可修改。
• 所在实验和Feature：点击具体数字，可查看白名单关联的“实验和Feature”的详情。
• 操作：
  • 编辑：除了白名单名称和ssid外，其他均可编辑
  • 删除：删除白名单后，创建实验或Feature将无法看到该常驻白名单。已使用该白名单的实验和Feature不影响。

1. 模式选择

• 创建白名单时，支持单个和批量两种模式，可在创建页右上角切换模式
  • 批量: 一次登记多个白名单(即一次可输入多个ssid, 以逗号分割)
    • 个数限制：批量登记一次ssid个数不超过500(<=500)
  • 单个: 一次登记一个白名单(即一次仅输入1个ssid)
    

2. SSID添加方式

2.1 手动录入

点击“+常用白名单”，填写“白名单名称、描述、SSID/UUID、标签”即可创建。白名单名称和SSID/UUID添加后不可修改。

• SSID获取方式：
  • 可通过在用户细查输入UUID，可查询SSID。
  • 获取SSID的方法，可参考「应用接入」文档。

2.2 扫码录入

填写白名单，手动输入的UUID、SSID数字较长（如：ssid="a0166a58-137a-410c-af02-04acc905edc9"），容易出错且不方便。因此对移动端的应用（iOS、Android），支持扫描二维码来录入设备ID。
详见：扫码录入设备ID

• 创建实验：在创建实验的过程中，“添加白名单”位置，下拉可选择常用的白名单，也可创建常用的白名单。

• 创建Feature：在创建Feature的过程中，“发布受众”位置，下拉可选择常用的白名单，也可创建常用的白名单。

如果一个用户是某个版本的白名单用户，那么实验分流对该用户是没有影响的，会固定在该版本。

白名单的用户，实验开启后的数据也会被计算到实验报告里。