iOS SDK

1.集成代码明细

A/B Testing SDK 依赖iOS SDKv1.6.0及以上版本，在使用前请确保已经成功集成QuickTracking 统计SDK，并进行了SDK初始化，详情可参考引入&配置SDK。

2.编程实验

2.1集成与初始化SDK

首先您需要使用同步方式初始化QuickTracking 统计SDK。初始化QuickTracking 统计SDK 完成之后，再初始化QuickTracking A/B Testing SDK。在QuickTracking A/B Testing SDK 初始化时需要传入请求分流试验的地址，请联系运营人员获取。

离线引入方式

请联系运营同学获取ABTest SDK离线包QTABTestSDK.xcframework文件。

SDK初始化

/** 初始化QuickTracking ABTest iOS SDK
 @param configOptions 初始化配置
 */
+ (void)startWithConfigOptions:(QTABTestConfigOptions *)configOptions;

QTABTestConfigOptions类

@interface QTABTestConfigOptions : NSObject

/// 获取实验结果 url
@property (nonatomic, copy) NSURL *baseURL;

/// SDK 主动轮询最新实验结果间隔时间（单位：秒），默认10分钟，最小支持10秒，最大支持30分钟，超出使用默认值
@property (nonatomic) NSTimeInterval updateInterval;

- (instancetype)init NS_UNAVAILABLE;

/** 初始化方法
 @param urlString 地址链接URL
 @return 实例对象
 */
- (instancetype)initWithURL:(NSString *)urlString NS_DESIGNATED_INITIALIZER;

@end

示例：

#import <QTABTestSDK/QTABTestSDK.h>

QTABTestConfigOptions *configOptions = [[QTABTestConfigOptions alloc] initWithURL:@"您的请求分流实验的地址"];
configOptions.updateInterval = 30;
[QTABTest startWithConfigOptions:configOptions];

开启日志

/// 设置是否在console输出SDK的日志信息
/// @param enable 开启/关闭调试日志输出； YES：开启， NO：关闭，默认为 NO
+ (void)setLogEnabled:(BOOL)enable;

示例：

 [QTABTest setLogEnabled:YES];

2.2获取实验变量

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

• fetchABTestFromCache ：读取本地缓存，缓存不存在时使用默认值

• fetchABTestFromServer ：忽略本地缓存，从服务端获取数据

• fetchABTestFromCacheThenServer ：优先读取本地缓存，缓存不存在时从服务端获取数据

使用场景说明

2.3 API 介绍

fetchABTestFromCache

//读取本地缓存获取实验，缓存不存在时使用默认值
/// @param paramName 实验参数名
/// @param defaultValue 默认结果
/// @return 实验值
- (nullable id)fetchABTestFromCacheWithParamName:(NSString*)paramName
                                   defaultValue:(id)defaultValue;

请求参数

返回结果

使用示例

#import "QTABTest.h"

// 请求返回String参数 
id result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"ios_test_string" defaultValue:@"111"];

// 请求返回Boolean参数 
id result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"ios_test_bool" defaultValue:@(YES)];

// 请求返回Number参数 
id result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"ios_test_number" defaultValue:@1];

//请求返回JSONObject参数
NSDictionary *dict = @{
    @"param1" : @"1"
    };
id result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"ios_test_json" defaultValue:dict];

fetchABTestFromServer

//忽略本地缓存，从服务端获取数据，异步从服务端获取最新实验结果
/// @param paramName 实验参数名
/// @param defaultValue 默认结果
/// @param timeoutInterval 超时时间，单位为秒
/// @param completionHandler 主线程回调，返回实验结果
- (void)fetchABTestFromServerWithParamName:(NSString*)paramName
                             defaultValue:(id)defaultValue
                          timeoutInterval:(NSTimeInterval)timeoutInterval
                        completionHandler:(void (^)(id _Nullable result))completionHandler;

请求参数

Callback说明：

typedef void (^QTABCompletionHandler)(id _Nullable result);

返回参数：

返回结果

使用示例

NSDictionary *dict = @{
    @"param1" : @"1"
    };
NSString *paramName = @"ios_test_json";

[[QTABTest sharedInstance] fetchABTestFromServerWithParamName:paramName defaultValue:dict timeoutInterval:10 completionHandler:^(id  _Nullable result) {

    if (result) {

        NSLog(@"======result:%@", result);
    }
}];

fetchABTestFromCacheThenServer

//优先读取本地缓存，缓存不存在时从服务端获取数据
/// @param paramName 实验参数名
/// @param defaultValue 默认值
/// @param timeoutInterval 超时时间，单位为秒
/// @param completionHandler 主线程回调，返回实验结果
- (void)fetchABTestFromCacheThenServerWithParamName:(NSString*)paramName
                                      defaultValue:(id)defaultValue
                                   timeoutInterval:(NSTimeInterval)timeoutInterval
                                 completionHandler:(void (^)(id _Nullable result))completionHandler;

请求参数

返回结果

使用示例

NSString *defaultValue = @"111";
NSString *paramName = @"ios_test_string";
[[QTABTest sharedInstance] fetchABTestFromCacheThenServerWithParamName:paramName defaultValue:defaultValue timeoutInterval:10 completionHandler:^(id  _Nullable result) {

    if (result) {

        NSLog(@"======result:%@", result);

    }
}];

3.调试试验

开启实验后

开启log时会打印出您对应的实验列表