快速集成

通过以下方式可以快速完成SDK的集成，更多方式请查SDK集成文档

集成配置

Cocoapods集成

1. 安装CocoaPods

2. 工程目录下创建Podfile文件，并添加pod 'AnalysysAgent'，示例如下：

platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
    pod 'AnalysysAgent'
end

3. 关闭Xcode，在工程目录下执行pod install或pod install --verbose --no-repo-update，完成后打开xxx.xcworkspace工程

手动集成

获取上报地址

登录易观方舟系统后点击”管理“——”数据接入管理“——”集成SDK接入数据”——“获取数据接收地址”

点击后即可获取您的数据上报地址。

获取数据接收地址

基础模块介绍

以下接口生效依赖于基础SDK模块，需集成基础SDK相关AnalysysAgent.framework文件，请正确集成。

初始化接口

在Xcode工程文件~AppDelegate.m 中导入头文件"#import <AnalysysAgent/AnalysysAgent.h>"。接口如下：

请确保初始化SDK在 (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary)launchOptions中主线程初始化

+ (AnalysysAgent *)startWithConfig:(AnalysysAgentConfig *)config;

设置上传地址

自定义上传地址，接口设置后，所有事件信息将上传到该地址。接口如下：

+ (void)setUploadURL:(NSString *)uploadURL;

Debug 接口

Debug 接口主要用于开发者测试。可以开/关日志，查看tag为[analysys]的Log日志。接口如下：

+ (void)setDebugMode:(AnalysysDebugMode)debugMode;

初始化示例代码

    //  导入SDK  
#import <AnalysysAgent/AnalysysAgent.h>
    //在主线程中开始初始化代码
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //  AnalysysAgent 配置信息
    //  设置key，77a52s552c892bn442v721为样例数据，请根据实际情况替换相应内容
    AnalysysConfig.appKey = @"77a52s552c892bn442v721";
    // 设置渠道默认App Store
    //AnalysysConfig.channel = @"App Store";
    //  使用配置初始化SDK
    [AnalysysAgent startWithConfig:AnalysysConfig];
    
    //开启DeBug模式，并在控制台输出日志
    #ifdef DEBUG
        [AnalysysAgent setDebugMode:AnalysysDebugButTrack];
    #else
    //关闭Debug模式，并关闭控制台输入日志
        [AnalysysAgent setDebugMode:AnalysysDebugOff];
    #endif

    //  设置上传地址，http://example.com为您上报地址

    [AnalysysAgent setUploadURL:@"htts://example.com"];
     // 开启全埋点
    [AnalysysAgent setAutoTrackClick:YES];

    return YES;
}

自定义事件接口

自定义事件接口，可以设置自定义属性。接口如下：

+ (void)track:(NSString *)event;

+ (void)track:(NSString *)event properties:(NSDictionary *)properties;

• event：事件ID，以字母或 $ 开头，只能包含字母、数字、下划线和 $，字母不区分大小写，$ 开头为预置事件/属性，最大长度 99字符，不支持乱码和中文

• properties：自定义属性，用于对事件描述。properties最多包含100对，且 key 以字母或 $ 开头，只能包含字母、数字、下划线和 $，字母不区分大小写，$ 开头为预置事件/属性，key长度 1 - 99 字符且不支持乱码和中文；value 支持类型：NSString/NSNumber/NSArray<NSString *>/NSSet<NSString *>/NSDate/NSURL，若为字符串，取值长度为1-255个字符

代码示例：

objective-c

//  收藏事件
[AnalysysAgent track:@"collect"];

....

// 用户购买手机
NSMutableDictionary *properties = [NSMutableDictionary dictionary];
properties[@"type"] = @"Phone";
properties[@"name"] = @"iPhone XS Max";
properties[@"money"] = [NSNumber numberWithFloat:9599.0];
properties[@"count"] = @1;
[AnalysysAgent track:@"pay" properties:properties];

Swift

账号关联

用户关联的主要作用是打通用户登录前后的行为，做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。建议在用户注册成功或者登录成功后客户端需要调用 alias 接口。

用户账号关联接口。

+ (void)alias:(NSString *)aliasId;

• aliasId：需要关联的用户ID。 取值长度为1-255个字符

代码示例：

objective-c

//登陆账号时调用，只设置当前登陆账号即可和之前行为打通
[AnalysysAgent alias:@"sanbo"];

Swift

设置用户属性

给用户设置单个或多个属性，如果之前不存在，则新建，否则覆盖。接口如下：

+ (void)profileSet:(NSDictionary *)property;

+ (void)profileSet:(NSString *)propertyName value:(id)propertyValue;

• propertyName：属性名称，约束见属性名称

• propertyValue：属性值，约束见属性值

• property：属性列表，约束见属性名称，属性值

代码示例：

objective-c

// 设置用户的 `Job` 是 `Engineer`
[AnalysysAgent profileSet:@"Job" propertyValue:@"Engineer"];

Swift

验证数据

开启Debug模式后，用户可以通过Xcode的控制台中查看tag为[analysys]的Log日志

Xcode中的日志

• 检查上报地址是否正确

• 检查是否发送成功

• 检查事件名称及内容与预期相同