AB 实验服务端 SDK 整体说明
概述
AB 实验服务端 SDK 用于在业务服务端获取实验参数,并根据参数执行不同的业务策略,帮助您验证不同方案对业务指标的影响。
您可以配置实验的目标受众、流量分配及各实验组的 Feature 值,由业务服务端接入 SDK 获取对应配置,再结合实验曝光数据和业务行为数据,在实验报告中评估各组表现。
当前服务端 SDK 支持 Java。
适用场景
当实验方案由后端业务逻辑控制时,可以使用服务端 SDK。例如:
| 场景 | 示例 |
|---|---|
| 推荐与排序策略 | 对比不同推荐算法、内容排序规则的效果 |
| 游戏业务策略 | 对比不同奖励数量、任务难度或资源配置 |
| 营销与权益策略 | 对比不同优惠方案、权益组合或触达策略 |
| 服务端控制的页面内容 | 由服务端返回不同的内容配置,供客户端展示 |
工作流程
服务端实验包含实验配置、获取参数、业务执行和效果分析四个环节。
-
配置实验。 创建需要调整的 Feature,设置默认值;配置实验指标、流量层、目标受众,以及对照组和实验组的参数值,完成实验发布。
-
业务服务端获取实验参数。 集成 Java SDK,在业务请求中提供实验所需的分流主体标识及相关属性,获取对应的 Feature 值。
-
根据参数执行业务逻辑。 业务服务端根据返回值选择对应策略,例如使用不同的推荐规则或奖励配置。
-
记录曝光和业务行为。 在实验方案实际生效的位置记录实验曝光,并通过数据采集链路上报点击、下单、付费等业务事件。
-
查看实验报告。 查看各实验组的曝光情况与指标表现,评估实验方案的效果。
获取实验参数、实验曝光和业务行为上报分别承担不同作用。 获取参数用于决定业务执行方案;曝光用于记录实验方案实际生效;业务事件用于计算实验指标。接入时应分别验证这三个环节。
接入准备
接入 Java SDK 前,请准备以下信息:
| 准备项 | 说明 |
|---|---|
| 项目信息 | 确认 SDK 接入项目与实验所属项目一致 |
| 服务地址 | 获取当前部署环境对应的实验配置服务及数据上报地址,并确认业务服务器可以访问 |
| Feature 配置 | 明确业务需要读取的 Feature Key、值类型和默认值 |
| 分流主体 | 确认实验按用户、账户、设备或其他主体分配流量,并准备对应标识 |
| 请求属性 | 使用受众条件时,准备条件判断所需的属性,确保名称、类型和值与后台配置一致 |
| 数据采集 | 确认实验曝光及业务指标事件能够正常上报,并关联到正确的实验主体 |
分流主体标识应保持稳定。例如,按账户分流的实验,应持续使用同一账户标识,避免在不同请求中切换标识而影响分组和统计。
业务代码还应设置明确的兜底方案,在配置获取异常、返回值缺失或类型不符合预期时,能够继续执行预设业务逻辑。
Java SDK 的安装依赖、初始化方式、参数获取及曝光接口,应参阅对应版本的 Java SDK 接入文档。
常见问题
服务端实验是否必须同时接入客户端实验 SDK?
实验参数由业务服务端获取并执行时,客户端无需为这部分逻辑重复接入实验 SDK。如果实验指标来自客户端行为,仍需通过客户端数据采集 SDK 或其他已接入的数据链路上报相应事件。
已获取实验参数,为什么报告中没有曝光数据?
获取配置成功并不代表曝光数据已经成功上报。请检查实验方案是否实际执行、曝光记录是否在正确位置触发,以及数据上报链路和主体标识是否正确。
实验已有曝光,为什么指标没有数据?
请检查指标对应的业务事件是否上报、事件名称和属性是否符合指标定义,以及业务事件能否与曝光主体正确关联,同时核对报告的统计时间范围。
调整后台实验配置后,业务是否立即生效?
业务使用新配置的时间取决于 Java SDK 的配置获取与刷新机制。发布或调整实验后,应验证业务服务端已经获取并使用更新后的配置;具体刷新行为以所用 SDK 版本的接入说明为准。

