UNIAPP 集成(本地插件方式集成)

导入本地插件

第一步:下载原生插件(zip格式),在【资源下载】里面,找到【uniapp 资源】,点击下载【hina-uniapp-abtest-native-plugins-[版本号].zip】;

第二步:解压zip包,拷贝到uni-app项目下的“nativeplugins”目录;

第三步:打开manifest.json文件,进入“App原生插件配置”项,然后点击“选择本地插件”;

最后,在本地插件弹窗上面,选择 HinaABTestSDK,点击“确定”,完成添加;

初始化SDK

const hinaABTest = uni.requireNativePlugin('HinaABTestSDK');
...
// 确保先初始化海纳嗨数(uniapp原生插件)埋点 SDK
// 初始化海纳嗨数(uniapp原生插件)ABTest sdk
hinaABTest.init("#分流接口")

uni['hinaABTest'] = hinaABTest

获取试验变量

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

  • fetchCacheABTest :读取本地缓存,缓存不存在时使用默认值
  • asyncFetchABTest :忽略本地缓存,从服务端获取数据
  • fastFetchABTest :优先读取本地缓存,缓存不存在时从服务端获取数据
    参数说明:
    {
      paramName: '试验变量名',
      defaultValue:试验默认值
    }

示例:

...
// 注意试验变量类型,目前支持:数字、文本、布尔、json四种类型
uni['hinaABTest']?.fetchCacheABTest({paramName: '试验变量名', defaultValue: 试验默认值},(result)=>{
  console.log(result);
}):

调试试验

获取设备id

通过海纳嗨数(uniapp原生插件)埋点 SDK 获取设备id,详见:【获取设备唯一ID】

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

录入设备列表

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

作者:王建华  创建时间:2024-09-20 17:51
最后编辑:王建华  更新时间:2024-10-17 17:27