初始化 SDK
在神策分析中创建 A/B Testing 后,会生成分流试验请求 URL,通过该 URL 初始化 A/B Testing SDK:
import 'package:abtesting_sdk_flutter/abtesting_sdk_flutter.dart';
// 注意需要在埋点 SDK 初始化后初始化 A/B Testing SDK
// A/B Testing SDK 初始化
SensorsABTest.startWithConfigOptions("分流试验请求地址");
Flutter 中获取试验变量
初始化 SDK 之后,通过 API 获取具体试验的变量值,根据获取试验变量值的方式,可分为下面三种策略:
-
fetchCacheABTest
:
读取本地缓存
,缓存不存在时使用默认值
-
asyncFetchABTest
:
忽略本地缓存,从服务端获取数据
-
fastFetchABTest
:
优先读取本地缓存,缓存不存在时从服务端获取数据
以
fastFetchABTest
为例,可在相应的业务逻辑中添加如下代码:
import 'package:abtesting_sdk_flutter/abtesting_sdk_flutter.dart';
// int 类型试验(第二个参数 0,表示未命中试验时,会返回此默认值,请根据业务需要更改此处的值)
int? result = await SensorsABTest.fastFetchABTest("具体的 paramName", 0);
// TODO 根据 result 处理相应逻辑
switch (result) {
case 0:
break;
case 1:
// 试验组 1 的处理逻辑
break;
case 2:
// 试验组 2 的处理逻辑
break;
// ……
// ……
default:
// 其他情况的处理逻辑
如果您的项目不支持 Null safety ,请使用如下方式获取实验结果:
int result = await SensorsABTest.fastFetchABTest("具体的 paramName", 0);
// TODO 根据 result 处理相应逻辑
获取设备主体试验变量
SDK支持使用设备主体进行分流。需要您在初始化SDK时,将匿名ID设置为公共属性。初始化并设置公共属性的具体方式如下:
// Android 端 A/B Testing SDK 初始化相关代码
import com.sensorsdata.abtest.SensorsABTest;
import com.sensorsdata.abtest.SensorsABTestConfigOptions;
import com.sensorsdata.abtest.OnABTestReceivedData;
必须先初始化神策分析 SDK(参考文档 https://manual.sensorsdata.cn/sa/latest/tech_sdk_client_android_basic-27726353.html)
// A/B Testing SDK 初始化(试验上线前,请检查试验的分流服务的 url 是否正确)
SensorsABTestConfigOptions abTestConfigOptions = new SensorsABTestConfigOptions("http://10.129.26.177:8202/api/v2/abtest/online/results?project-key=6C6658034A6581A9C3CC3D888B3DEFB6CDB6606C");
SensorsABTest.startWithConfigOptions(this, abTestConfigOptions);
//设备主体分流需要将匿名ID设置为公共属性
try {
JSONObject properties = new JSONObject();
properties.put("anonymous_id", SensorsDataAPI.sharedInstance().getAnonymousId());
SensorsDataAPI.sharedInstance().registerSuperProperties(properties);
} catch (JSONException e) {
e.printStackTrace();
// iOS 端 A/B Testing SDK 初始化相关代码
#import <SensorsABTest.h>
必须先初始化神策分析 SDK(参考文档 https://manual.sensorsdata.cn/sa/latest/tech_sdk_client_ios_use-27724338.html)
// A/B Testing SDK 初始化
SensorsABTestConfigOptions *abtestConfigOptions = [[SensorsABTestConfigOptions alloc] initWithURL:@"http://10.129.26.177:8202/api/v2/abtest/online/results?project-key=6C6658034A6581A9C3CC3D888B3DEFB6CDB6606C"];
[SensorsABTest startWithConfigOptions:abtestConfigOptions];
//设备主体分流需要将匿名ID设置为公共属性
NSString *anonymousId = [[SensorsAnalyticsSDK sharedInstance] anonymousId];
[[SensorsAnalyticsSDK sharedInstance] registerSuperProperties:@{@"anonymous_id" : anonymousId}];
APPLESCRIPT
后续可以使用
- fetchCacheABTest :读取本地缓存,缓存不存在时使用默认值
- asyncFetchABTest :忽略本地缓存,从服务端获取数据
- fastFetchABTest :优先读取本地缓存,缓存不存在时从服务端获取数据
三种方式同Flutter中获取试验变量
调试试验
对于 iOS 需要在 AppDelegate 的 - application:openURL:options: 方法中调用 -handleOpenURL: 对神策 A/B Testing Scheme 进行处理:
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
if ([[SensorsABTest sharedInstance] handleOpenURL:url]) {
return YES;
return NO;
APPLESCRIPT
先将设备录入到调试设备管理列表中,在创建试验时,直接将指定调试设备录入到对应试验分组。