注意:A/B Testing SDK 依赖于海纳分析 SDK 4.0.2 及以上版本,在使用前请确保已经成功集成海纳分析 SDK,并进行了 SDK 初始化,详情可参考 【SDK集成(iOS)】

SDK 集成

  • 在 Podfile 文件中添加 pod 'HinaABTesting'
    注意:需要确认已经集成了海纳分析SDK 4.0.2及以上版本:pod 'HinaCloudSDK', '~> 4.0.2'
  • 打开终端,切换到项目目录
  • 执行 pod installpod update

注:如果执行 pod install 无法检测到最新版本,可以在podfile文件顶部添加source 'https://github.com/CocoaPods/Specs.git'再执行pod install

初始化 SDK

在海纳分析中创建 A/B Testing 后,会生成分流试验请求 URL,通过该 URL 初始化 A/B Testing SDK:

    #import <HinaABTest/HinaABTest.h>

    // 必须先初始化海纳分析 SDK(参考文档 https://himanual.hinadt.com/docs/hicloud/hicloud-1ehbp66rkb1nn)

    // A/B Testing SDK 初始化
    HinaABTestConfigOptions *abtestConfigOptions = [[HinaABTestConfigOptions alloc] initWithURL:"配置项目的分流接口"];
    [HinaABTest startWithConfigOptions:abtestConfigOptions];

获取试验变量

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

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

例如:以fastFetchABTest为例, 对首页背景色进行实验,获取实验下的颜色值,默认是 #ffffff(白色),示例如下:

id result = [[HinaABTest sharedInstance] fetchCacheABTestWithParamName:@"home_bg_color" defaultValue:@"#ffffff"];

调试试验

获取设备id

通过海纳嗨数埋点 SDK 获取设备id,详见:【获取设备唯一ID】

录入设备列表

将设备id录入到调试设备管理列表中,在创建试验时,直接将指定调试设备录入到对应试验分组。

作者:邓昊  创建时间:2024-08-01 15:55
最后编辑:邓昊  更新时间:2024-09-14 18:04