MMA 中国广告监测及验证统一SDK (iOS) 部署指南

步骤1：添加 MMA iOS SDK 到工程中

  1. 点此下载 （下载内容为：MMA 中国广告监测及验证统一SDK (iOS) 安装包）MMA iOS SDK (如需浏览此开源项目和 demo 工程请到 https://gitee.com/MMAChinaSDK 注册账号后邮件联系 yanluchen@admaster.com.cn)
  2. 将SDK发布文件中，release目录下的MobileTracking.h 、libMobileTracking.a、sdkconfig.xml 三个文件拷贝到项目工程中，将sdkconfig.xml上传到 web 服务器，使其可以通过 web 方式访问，假设其地址为http://xxxxxx.com/sdkconfig.xml（其后会用到）。
  3. 在项目工程 App 的 Target Build Settings 中的Other Linker Flags 选项里添加 -lxml2 -all_load 或 -lxml2 -force_load 静态库的绝对路径

步骤2:配置文件sdkconfig.xml的使用方法

在使用的文件中引用 #import "MobileTracking.h".

使用说明:

1、初始化方法

在进行监测之前，必须进行初始化，通过以上的代码进行初始化操作

[MobileTracking sharedInstance]

2、配置远程配置文件地址方法

SDK 会自动下载远程的配置文件，使用最新的配置文件进行参数的组装。

[[MobileTracking sharedInstance] configFromUrl:@“http://xxxxxx.com/sdkconfig.xml”];

3、曝光的监测

通过调用以下的代码进行曝光的监测，

  1. 第一个参数为第三方公司的监测地址
  2. 第二个参数为当前广告视图对象（可视化广告监测为必传字段，普通广告监测默认缺省。）
  3. 第三个参数为当前视频广告的播放类型（视频可视化广告监测为可选字段，1-自动播放，2-手动播放，0-无法识别。）

普通广告监测

[[MobileTracking sharedInstance] view:@"http://example.com/xxxxxx”];

可见性广告监测

[[MobileTracking sharedInstance] view:@"http://example.com/xxxxxx” ad:adview];

视频可见性广告监测

[[MobileTracking sharedInstance] viewVideo:@"http://example.com/xxxxxx” ad:adview];

[[MobileTracking sharedInstance] viewVideo:@"http://example.com/xxxxxx” ad:adview videoPlayType:type];

可见性广告JS监测

[[MobileTracking sharedInstance] jsView:@"http://example.com/xxxxxx” ad:adview];

视频可见性广告JS监测

[[MobileTracking sharedInstance] jsViewVideo:@"http://example.com/xxxxxx” ad:adview];

可见性广告监测停止，广告播放结束时调用

[[MobileTracking sharedInstance] stop:@"http://example.com/xxxxxx”];

4、点击监测

通过调用以下的代码进行点击的监测，参数为第三方公司的监测地址

[[MobileTracking sharedInstance] click:@"http://example.com/xxxxxx"];

5、进入后台时调用

主要用于保存当前监测数据，不被丢失。建议放在AppDelegate的applicationDidEnterBackground方法中

[[MobileTracking sharedInstance] didEnterBackground];

6、回到前台时调用

重新读取缓存数据，主要用于保证当前监测数据，及时上报,建议放在AppDelegate的applicationWillEnterForeground方法中

[[MobileTracking sharedInstance] didEnterForeground];

7、应用结束时调用

主要用于保存当前监测数据，不被丢失。

[[MobileTracking sharedInstance] willTerminate];

8、开启调试日志

建议在测试时候打开

[[MobileTracking sharedInstance] enableLog:YES];

步骤3：验证和调试

SDK 的测试有两个方面：

  1. 参数是否齐全，URL 拼接方式是否正确
  2. 请求次数和第三方监测平台是否能对应上

请联系第三方监测平台完成测试