我财统计分析iOS集成文档

集成文档 统计分析

1. 集成准备

1.1 获取Appkey

集成我财统计SDK之前，您首先需要到App统计平台添加新应用，获得Appkey

• 安卓版和iOS版本分开使用Appkey，不同平台的应用禁止使用相同的Appkey，需要分开添加
• 添加应用时，建议命名为“应用名+平台(iOS/Android)”

1.2 下载SDK

下载统计SDK并解压缩。

1.3 导入SDK

请在你的工程目录结构中，右键选择 Add->Existing Files…,选择libWCMobClick.a WCMobClick.h,或者将这两个文件拖入XCode工程目录结构中，在弹出的界面中勾选Copy items into destination group's folder(if needed),并确保Add To Targets勾选相应的target。

添加依赖框架(Framework)和编译器选项TARGETS-->Build Phases-->Link Binary With Libraries--> + -->,依次添加如下三个框架
- Security.framework确保安全，我们对所有传输的数据均进行了严格加密
- CoreTelephony.framework配合运营需求，需要对用户所使用的运营商进行统计
- libz.dylib （Xcode7请选择libz.tbd）库文件需要

2. 基本功能集成

2.1 配置AppDelegate.m

AppDelegate.m的配置主要包括填写Appkey和设置渠道id两个部分，代码示例如下：

- (BOOL])application:(UIApplication] *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
[WCMobClick startWithAppkey:@"xxxxxxxxxxxxxxx" channelId:@"xxxxx"];
}

2.1.1 appkey填写

将startWithAppkey:@"xxxxxxxxxxxxxxx"中的xxxxxxxxxxxxxxx替换为您在统计后台申请的应用Appkey（Appkey可在统计后台的应用管理页面中查看）

2.1.2 channel填写

将channelId:@"xxxxx"中的xxxxx替换为您在统计后台中统计分析->设置->渠道中对应的渠道id,不同渠道需要打不同的渠道包

2.2 iOS9中ATS配置

由于iOS9引入了AppTransportSecurity(ATS)特性，要求App访问的网络使用HTTPS协议，如果不做特殊设置，http请求会失败,所以需要开发者在工程中增加设置以便可以发送http请求，如下：

在info.plist中增加字段：

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

配置完后如图所示：

3. 页面的统计

实现页面的统计需要在每个View中配对调用如下方法：

- (void)viewWillAppear:(BOOL)animated {
    [super viewWillAppear:animated];
    [WCMobClick beginLogPageView:@"PageOne"];
}
- (void)viewWillDisappear:(BOOL)animated {
    [super viewWillDisappear:animated];
    [WCMobClick endLogPageView:@"PageOne"];
}

注意： 页面统计集成正确，才能够通过正确的页面访问路径、访问深度(PV)的数据。

4. 自定义事件的统计

自定义事件可以实现在应用程序中埋点来统计用户的点击行为。自定义事件目标包括计数事件和计算事件，计数事件主要统计事件的发生次数、独立用户数及事件各参数的发生次数。计算事件主要用于解决对某个参数值求和，计算某个参数值的单次均值及单用户均值等计算事务。

4.1 使用自定义事件

使用自定义事件功能请先登录App统计平台，在应用管理->设置->事件中添加相应的事件id(事件id可用英文或数字，不要使用中文和特殊字符且不能使用英文句号“.”您可以使用下划线“_”),然后服务器才会对相应的事件请求进行处理。

4.2 计数事件

使用计数事件需要在后台添加事件时选择“计数事件”。

4.2.1 统计发生次数

在您希望跟踪的代码部分，调用如下方法：

[WCMobClick event:(NSString *)eventId];

eventId为当前统计的事件ID。

示例：统计微博应用中"转发"事件发生的次数，那么在转发的函数里调用:

[WCMobClick event:@"Forward"];

4.2.2 统计点击行为各属性被触发的次数

考虑事件在不同属性上的取值，可以调用如下方法：

[WCMobClick event:(NSString *)eventId attributes:(NSDictionary *)attributes];

attributes为当前事件的属性和取值（键值对），不能为空。

示例：统计电商应用中“购买”事件发生的次数，以及购买的商品类型及数量，那么在购买的函数里调用：

NSDictionary *dict = @{@"type" : @"book", @"quantity" : @"3"};
[WCMobClick event:@"purchase" attributes:dict];    

4.3 计算事件

使用计算事件需要在后台添加事件时选择“计算事件”。

4.3.1 统计数值型变量的值的分布

统计一个数值类型的连续变量（该变量必须为整数），用户每次触发的数值的分布情况，如事件持续时间、每次付款金额等，可以调用如下方法：

[WCMobClick event:(NSString *)eventId attributes:(NSDictionary *)attributes eventvalue:(NSString *)eventvalue;];

示例：购买《Swift Fundamentals》这本书，花了110元

[WCMobClick umengEvent:@"pay" attributes:@{@"book" : @"Swift Fundamentals"} eventvalue:@"110"];

5. 测试与调试

5.1 确认如下内容

• 确认Appkey正确
• 确认添加了依赖库Security.framework、CoreTelephony.framework、libz.tbd
• 确认测试手机(或者模拟器)已成功连入网络

5.2 调试模式

为方便查看日志信息，调试模式下可以在程序入口打开Log，开启后会打印出报备信息和调试数据

[WCMobClick setLogEnabled:YES];

6. 技术支持

• QQ:386877150(在线时间:工作日9:00~18:00)
• Email: support@zjwocai.com