APICloud 集成ABTest

APICloud 集成（自定义插件）

上传自定义插件

第一步：在【资源下载】里面，找到【apicloud 资源】，下载原生插件（zip格式）；

第二步：解压zip包，目录下的“moduleHinaXXX”文件夹，就是自定义原生插件；

第三步：打开拥有开发者中心->工作台->移动应用开发，进入自己的移动应用，进入移动插件->自定义插件，进行上传即可使用；

初始化SDK

hinaABTestModule = api.require('moduleHinaABTest');
...

// 确保先初始化海纳嗨数（APICloud 原生插件）埋点 SDK
// 初始化海纳嗨数（APICloud 原生插件）ABTest SDK
var urlParam = {url:"#分流接口"};
hinaABTestModule.init(urlParam, function(ret, err){
    alert(JSON.stringify(ret));
})

获取试验变量

初始化 SDK 之后，通过 API 获取具体试验的变量值，根据获取试验变量值的方式，可分为下面三种策略：

• fetchCacheABTest ：读取本地缓存，缓存不存在时使用默认值
• asyncFetchABTest ：忽略本地缓存，从服务端获取数据
• fastFetchABTest ：优先读取本地缓存，缓存不存在时从服务端获取数据
  参数说明：

  {
    paramName: '试验变量名'，
    defaultValue：试验默认值
  }

示例：

...
// 注意试验变量类型，目前支持：数字、文本、布尔、json四种类型
var paramData = {paramName:'color', defaultValue:'#ffffff'};
hinaABTestModule.fetchCacheABTest(paramData, function(ret, err){
    alert(ret['result']);//注意返回结果示例：{result:'#000000'}
});

调试试验

获取设备id

通过海纳嗨数（APICloud 原生插件）埋点 SDK 获取设备id，详见：【获取设备唯一ID】

建议：为方便产品/运营查看，接入方可在app内预留查看设备id后门功能，比如：接入方APP->设置页面->快速点击“版本号”5次，弹出一个弹窗，弹窗上显示设备id并支持复制。【由接入方自主实现】

录入设备列表

在海纳云平台找到调试页面，将设备id录入到调试设备管理列表中，在创建试验时，可以将指定调试设备录入到对应试验分组，这样就可以在调试设备看到分流后的试验效果了。