SDK 集成

SDK 最低兼容系统版本 iOS 8.0

1. 接入SDK

1. 下载 SDK 点击下载
2. 解压后把 TrackSDK.framework 拖入工程目录中
3. 选中 Copy items if needed 、Create Groups，点击 Finish

2. 初始化 TrackSDK

1. 在 AppDelegate.m 引入头文件

   #import <TrackSDK/TrackSDK.h>
   

2. 在 AppDelegate.m 初始化

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
      [TrackSDK initWithAppId:@"平台提供的AppId"];
      return YES;
   }
   

3. 获取绑定数据和渠道ID

//可多次调用获取，data有可能是nil,请做好非空判断
[TrackSDK getBindData:^(TSBindData *data) {
    ...
}];

//只在应用安装后第一次调用时执行，覆盖安装后调用不会执行，data有可能是nil,请做好非空判断
[TrackSDK getBindDataOnce:^(TSBindData *data) {
    ...
}];

4. 触发事件

• 触发注册事件，用于渠道统计分析

  //用户唯一标识最大长度在128个字符以内，例如：使用md5加密用户ID作为用户唯一标识
  [TrackSDK onRegister:@"用户唯一标识"];
  

• 触发自定义事件

  //事件ID需要登陆控制进行查看，【控制台->管理->事件管理】
  [TrackSDK onEventWithId:@"事件ID"];
  
  //有些场景可能需要事件值，例如：用户充值事件，需要统计充值金额
  [TrackSDK onEventWithId:@"事件ID" value:100.10];
  

5. 下载页打开应用

通过 Universal Links 和 Scheme 配置，用户在下载页点击下载按钮时，如果应用已安装则直接打开应用，否则跳转 App Store 进行下载。

• Universal Links 配置

  在Capabilities中启用Associated Domain并添加domains，值为：applinks:应用AppId.tracksdk.com，也可登陆到控制台的开发信息中查看【控制台->开发->iOS】

  

• Scheme 配置

  Identifier固定值为tracksdk.com，URL Schemes为平台提供的AppId