跳到主要内容

AB 实验服务端 SDK 整体说明

最近更新 2026/10/20

概述​

AB 实验服务端 SDK 用于在业务服务端获取实验参数,并根据参数执行不同的业务策略,帮助您验证不同方案对业务指标的影响。

您可以配置实验的目标受众、流量分配及各实验组的 Feature 值,由业务服务端接入 SDK 获取对应配置,再结合实验曝光数据和业务行为数据,在实验报告中评估各组表现。

当前服务端 SDK 支持 Java。

适用场景​

当实验方案由后端业务逻辑控制时,可以使用服务端 SDK。例如:

场景示例
推荐与排序策略对比不同推荐算法、内容排序规则的效果
游戏业务策略对比不同奖励数量、任务难度或资源配置
营销与权益策略对比不同优惠方案、权益组合或触达策略
服务端控制的页面内容由服务端返回不同的内容配置,供客户端展示

工作流程​

服务端实验包含实验配置、获取参数、业务执行和效果分析四个环节。

  1. 配置实验。 创建需要调整的 Feature,设置默认值;配置实验指标、流量层、目标受众,以及对照组和实验组的参数值,完成实验发布。

  2. 业务服务端获取实验参数。 集成 Java SDK,在业务请求中提供实验所需的分流主体标识及相关属性,获取对应的 Feature 值。

  3. 根据参数执行业务逻辑。 业务服务端根据返回值选择对应策略,例如使用不同的推荐规则或奖励配置。

  4. 记录曝光和业务行为。 在实验方案实际生效的位置记录实验曝光,并通过数据采集链路上报点击、下单、付费等业务事件。

  5. 查看实验报告。 查看各实验组的曝光情况与指标表现,评估实验方案的效果。

获取实验参数、实验曝光和业务行为上报分别承担不同作用。 获取参数用于决定业务执行方案;曝光用于记录实验方案实际生效;业务事件用于计算实验指标。接入时应分别验证这三个环节。

接入准备​

接入 Java SDK 前,请准备以下信息:

准备项说明
项目信息确认 SDK 接入项目与实验所属项目一致
服务地址获取当前部署环境对应的实验配置服务及数据上报地址,并确认业务服务器可以访问
Feature 配置明确业务需要读取的 Feature Key、值类型和默认值
分流主体确认实验按用户、账户、设备或其他主体分配流量,并准备对应标识
请求属性使用受众条件时,准备条件判断所需的属性,确保名称、类型和值与后台配置一致
数据采集确认实验曝光及业务指标事件能够正常上报,并关联到正确的实验主体

分流主体标识应保持稳定。例如,按账户分流的实验,应持续使用同一账户标识,避免在不同请求中切换标识而影响分组和统计。

业务代码还应设置明确的兜底方案,在配置获取异常、返回值缺失或类型不符合预期时,能够继续执行预设业务逻辑。

Java SDK 的安装依赖、初始化方式、参数获取及曝光接口,应参阅对应版本的 Java SDK 接入文档。

常见问题​

服务端实验是否必须同时接入客户端实验 SDK?​

实验参数由业务服务端获取并执行时,客户端无需为这部分逻辑重复接入实验 SDK。如果实验指标来自客户端行为,仍需通过客户端数据采集 SDK 或其他已接入的数据链路上报相应事件。

已获取实验参数,为什么报告中没有曝光数据?​

获取配置成功并不代表曝光数据已经成功上报。请检查实验方案是否实际执行、曝光记录是否在正确位置触发,以及数据上报链路和主体标识是否正确。

实验已有曝光,为什么指标没有数据?​

请检查指标对应的业务事件是否上报、事件名称和属性是否符合指标定义,以及业务事件能否与曝光主体正确关联,同时核对报告的统计时间范围。

调整后台实验配置后,业务是否立即生效?​

业务使用新配置的时间取决于 Java SDK 的配置获取与刷新机制。发布或调整实验后,应验证业务服务端已经获取并使用更新后的配置;具体刷新行为以所用 SDK 版本的接入说明为准。

这篇文档对你有帮助吗?