适用范围

talkingdata App Analytics iOS SDK适用于iOS 7.0及以上操作系统。

集成准备-创建应用并获取App ID

App ID是TalkingData分析平台标识一款独立应用/游戏的唯一标识，集成SDK前需要在TalkingData报表中创建应用/游戏并获取相应的App ID。

步骤： 1）注册并登录https://www.talkingdata.com/ ，选择App Analytics产品线 2）创建应用并获取App ID 3）如果已创建的应用，请从“应用管理->基本信息”中查看App ID。

说明： TalkingData支持多平台使用相同的App ID。

集成准备-统计标准说明

基础统计指标定义： 1）新增用户：iOS中“用户”指一个独立设备。 2）用户的一次使用：指用户从打开应用到退出应用的全过程，如果用户按“Home”键将切出应用后30s内再次返回应用，则认为是上一次使用的延续，不会算作新的应用使用。 3）自定义事件：指用户在HTML5中进行了特定的操作或达成了特定的条件。例如：用户点击了广告栏、用户进行付费等。 自定义事件用于收集任意您期望跟踪的数据。

快速集成-导入SDK

1. 选择 File --> Add Files to“Your Project”
2. 选择 TalkingData.h 和 libTalkingData.a 两个文件
3. 勾选 Copy items if needed
4. 确保所有要用到SDK的 targets 都处于选中状态。

   

快速集成-添加依赖框架

如下图：

快速集成-添加编译参数

在Linking下的Other Linker Flags中添加“-ObjC”参数，该参数是使用灵动分析SDK的必要条件。

未添加会造成使用灵动分析时，在报表平台中获得的App截图为空白的情况。 

快速集成-SDK初始化

在 AppDelegate.m 文件中导入 TalkingData.h ，并在 application:didFinishLaunchingWithOptions: 方法中初始化 App Analytics SDK。

示例代码：

#import "TalkingData.h"
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions{ 
    // App ID: 在 App Analytics 创建应用后，进入数据报表页中，在“系统设置”-“编辑应用”页面里查看App ID。
    // 渠道 ID: 是渠道标识符，可通过不同渠道单独追踪数据。
    [TalkingData sessionStarted:@"您的 App ID" withChannelId:@"渠道 ID"];
    //other code
}