JS

最近更新 2026/10/07

最新版本：v1.0.0

更新时间：2026-07-24

资源下载：下载

1. 概述

从 6.1 版本开始，AE 新增实验套件功能，支持在 AE 后台创建实验，设置对照组和实验组的变量值，通过客户端 SDK 拉取至App，为不同组别的用户展示不同的内容。

本文介绍客户端SDK的集成过程，App 端只需要关注与数数 SDK 的交互即可，不需要关心 AE 后台的任务细节。

需要注意的是，实验 SDK 必须搭配配置中心 SDK 一起使用。

2. 集成

2.1 手动集成 SDK

配置中心需要依赖以下数数 SDK：

SDK名称	介绍	版本要求
TDAnalytics	实现数据采集与处理	>= 2.6.0
TDRemoteconfig	拉取 AE 后台的配置信息	>= 1.3.0

1. 点击页面上方资源下载链接，下载 SDK 并解压
2. 将thinkingdata.umd.min.js、tdremoteconfig.umd.min.js、tdexperiment.umd.min.js拖入项目同一目录下

3. 初始化

切换当前集成方式后，SDK初始化使用TDApp示例，其他数据采集和上报使用 window.thinkingdata实例。

<script src="./thinkingdata.umd.min.js"></script>
<script src="./tdremoteconfig.umd.min.js"></script>
<script src="./tdexperiment.umd.min.js"></script>
//初始化采集SDK
window.ta = thinkingdata;
ta.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
});
//初始化实验 SDK
TDExperiment.init({
    appId: 'APP_ID',
    serverUrl: 'https://YOUR_SERVER_URL',
    automaticExposureTracking: true,
    customBucketId:{},
    customFetchParams: {},
    enableLog: true,
    onFetchSuccess: function () {
    },
    onFetchFailure: function (code, msg) {

    }
});

初始化参数说明：

• appId：APP ID
• serverUrl：数据上报地址
• automaticExposureTracking：默认设置为true，在get获取实验参数的时候自动上传曝光事件
• customBucketId：自定义分流主体
• customFetchParams：客户端配置通道上的自定义参数
• enableLog：是否开启调试日志
• onFetchSuccess：拉取实验配置信息成功
• onFetchFailure：拉取实验配置信息失败

4. 使用

4.1 获取实验信息

TDExperiment.getValueAsString(key)

TDExperiment.getValueAsNumber(key)

TDExperiment.getValueAsBoolean(key)

TDExperiment.getValueAsJson(key)

如果automaticExposureTracking为true，在get的时候会自动上传曝光事件

4.2 上传曝光事件

可以调用exposure方法，手动上传曝光事件

TDExperiment.exposure(key);

4.3 主动拉取所有实验信息

TDExperiment.fetch();

TDExperiment.fetch().addOnSuccessListener(function () {
    //成功
}).addOnFailureListener(function (code, msg) {
    //失败
});

4.4 自定义分流主体

TDExperiment.setCustomBucketId({
    'bucket_id':'account_id'
});

4.5 自定义请求参数

TDExperiment.setCustomFetchParams({
    'key':'value'
});