Quick Tracking：macOS SDK

pod 'QuickTrackingSDK'
pod 'QTABTest'

編程實驗

#import <QuickTrackingSDK/QuickTrackingSDK.h>

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification {
    QTSDKConfig *sdkConfig;
    // 初始化SDK配置
    sdkConfig = [[QTSDKConfig alloc] initWithAppkey:@"您的應用唯一標識"
                                        trackDomain:@"https://您的收數網域名稱"
                                      launchOptions:nil];
    // 設定應用發布渠道，例如:appstore
    sdkConfig.channel = @"您的應用發布渠道";
    
    // 初始化 SDK
    [QuickTrackingSDK initWithConfig:sdkConfig];
    
    //初始化ABTest配置
    QTABTestConfigOptions *configOptions;
    configOptions = [[QTABTestConfigOptions alloc] initWithURL:@"https://您的收數網域名稱/abtest_results?appkey=您的應用唯一標識"];
    
    // SDK主動輪詢最新實驗結果間隔時間，單位秒
    // 預設600s，即10分鐘
    // 最小間隔 10s，最大間隔 1800s（即30分鐘），超過範圍使用預設間隔時間
    //configOptions.updateInterval = 300;
    
    // ABTest 日誌開關，預設關閉，即 NO
    configOptions.enableLog = YES;
    
    // ABTest 屬性變更回調，
    configOptions.onABTestPropertyChangedBlock = ^(NSArray * _Nonnull result) {
       /** 輸出樣本
        [
          {"gid": xxx, "expid": xxx}, 
          {"gid": xxx, "expid": xxx}
        ]
        **/
        NSLog(@"-----%@", result);
    };
    
    // ABTest SDK 初始化
    [QTABTest startWithConfigOptions:configOptions];
}

/// 設定是否在console輸出SDK的日誌資訊
/// @param enable 開啟/關閉調試日誌輸出； YES：開啟， NO：關閉，預設為 NO
+ (void)setLogEnabled:(BOOL)enable;

 [QTABTest setLogEnabled:YES];

API 介紹

fetchABTestFromCache

介面函數

//讀取本機快取擷取實驗，緩衝不存在時使用預設值
/// @param paramName 實驗參數名
/// @param defaultValue 預設結果
/// @return 實驗值
- (nullable id)fetchABTestFromCacheWithParamName:(NSString*)paramName
                                   defaultValue:(id)defaultValue;

參數說明

傳回值說明

完整樣本

#import "QTABTest.h"

// 請求返回NSString參數 
NSString *result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"test_string" defaultValue:@"111"];

// 請求返回Boolean參數 
BOOL result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"test_bool" defaultValue:@(YES)];

// 請求返回Number參數 
NSNumber result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"test_number" defaultValue:@1];

//請求返回JSONObject參數
NSDictionary *dict = @{
    @"param1" : @"1"
};
NSDictionary *result = [[QTABTest sharedInstance] fetchABTestFromCacheWithParamName:@"test_json" defaultValue:dict];

使用注意：

請確保對A/B分流介面中使用的預設值，都做了正常的商務邏輯處理！

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 = @"test_json";

[[QTABTest sharedInstance] fetchABTestFromServerWithParamName:paramName defaultValue:dict timeoutInterval:10 completionHandler:^(id  _Nullable result) {
    if (result) {
        NSLog(@"======result:%@", result);
    }
}];

使用注意：

請確保對A/B分流介面中使用的預設值，都做了正常的商務邏輯處理！

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 = @"test_string";
[[QTABTest sharedInstance] fetchABTestFromCacheThenServerWithParamName:paramName defaultValue:defaultValue timeoutInterval:10 completionHandler:^(id  _Nullable result) {
    if (result) {
        NSLog(@"======result:%@", result);
    }
}];

使用注意：

請確保對A/B分流介面中使用的預設值，都做了正常的商務邏輯處理！

3.調試實驗

開啟實驗後