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录入到调试设备管理列表中,在创建试验时,可以将指定调试设备录入到对应试验分组,这样就可以在调试设备看到分流后的试验效果了。

作者:王建华  创建时间:2024-09-26 14:23
最后编辑:王建华  更新时间:2024-10-31 14:08