1. iOS SDK 快速接入指南


本文档将帮助您快速接入大家都在使用的MTA统计功能,高级功能接入请参考高级功能接入或者 MTA.h 以及 MTAConfig.h 头文件。

1.1. 配置Xcode工程


(1) 前往“SDK下载中心”下载对应压缩包到本地。

(2)解压mta-ios-sdk-x.x.x.zip到本地目录,可以看到其中sdk目录下的三个文件libmtasdk.a, MTA.h, MTAConfig.h。

(3)将MTA.h, MTAConfig.h以及libmtasdk.a添加到工程。

(4)添加以下库或者framework的引用libz.tbd, libsqlite3.tbd, QuartzCore.framework, Security.framework, CFNetwork.framework, SystemConfiguration.framework, CoreTelephony.framework, UIKit.framework, Foundation.framework, CoreGraphics.framework以及libmtasdk.a。添加完成后,库的引用如下

(5)在工程配置的Other Linker Flags中添加 '-ObjC' 参数。如下图

linkflag

1.2. 嵌入MTA代码


(1) 切换到工程目录,打开AppDelegate.m,在文件开头import 部分增加import:

#import "MTA.h"
#import "MTAConfig.h"

(2)在启动方法

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;

方法内添加如下语句

[MTA startWithAppkey:@"xxxx"]; //xxxx为注册App时得到的APPKEY

添加完成后的代码如下:

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // ...
    [MTA startWithAppkey:@"ABCDEFGH"];
    // ...
}

1.3. 验证数据上报


成功嵌入sdk后,在模拟器或手机运行您上面已经编译好的应用(确保已执行MTA代码),便会自动上报数据。

1

登陆MTA前台,等待5秒钟左右再刷新app首页,实时指标将有变化,表示已成功上报;若超过3分钟指标仍未变化,请按以下顺序检查:

(1)手机的wifi是否打开,是否正常联网;

(2)APPKEY设置是否正确;

(3)确保已触发MTA统计代码;

(4) 查看Xcode的输出是否有错误信息。

1.4. SDK嵌入完成


恭喜!到这里您已经顺利接入MTA的统计功能,需要获得更高级的服务功能,请参考接口说明

1.5. 接口说明


本文档提供了 MTA.h 头文件中大部分接口的使用方法。全部接口及使用方法请查看头文件 MTA.h。

1.5.1. 头文件 MTA.h

启动 MTA

使用统计功能以前,需要先启动MTA。在UIApplicationDelegate的

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions;

回调中调用 MTA 的 startWithAppkey 方法即可启动MTA。

(1)接口内容

/**
启动MTA

@param appkey 从网页申请的appKey
*/
+ (void)startWithAppkey:(NSString *)appkey;

/**
检测版本,并启动MTA。
如果当前MTA的版本小于ver参数,则MTA不启动。否则启动MTA。

@param appkey 从网页申请的appKey

@param ver 最低允许启动的版本

@return 如果MTA成功启动,返回YES,否则返回NO

*/
+ (BOOL)startWithAppkey:(NSString *)appkey checkedSdkVersion:(NSString *)ver;

(2)代码示例

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [MTA startWithAppkey:@"ABCDEFG"];
}

统计页面时长

页面时长可以统计某个页面的访问时长

(1)接口内容

/**
标记一次页面访问的开始
此接口需要跟trackPageViewEnd配对使用
多次开始以第一次开始的时间为准

@param page 页面ID,ID需要先在MTA前台配置好才能生效
*/
+ (void)trackPageViewBegin:(NSString *)page;

/**
标记一起页面访问的开始
并且指定上报方式
此接口需要跟trackPageViewEnd配对使用
多次开始以第一次开始的时间为准

@param page 页面ID,ID需要先在MTA前台配置好才能生效

@param appkey 若此参数不为nil,则上报到此appkey。否则,上报到startWithAppkey中传入的appkey
*/
+ (void)trackPageViewBegin:(NSString *)page appkey:(NSString *)appkey;


/**
标记一次页面访问的结束
此接口需要跟trackPageViewBegin配对使用
多次结束以第一次结束的时间为准

@param page 页面ID,ID需要先在MTA前台配置好才能生效
*/
+ (void)trackPageViewEnd:(NSString *)page;

/**
标记一起页面访问的结束

并且指定上报方式
此接口需要跟trackPageViewBegin配对使用
多次结束以第一次结束的时间为准

@param page 页面ID,ID需要先在MTA前台配置好才能生效
@param appkey 若此参数不为nil,则上报到此appkey。否则,上报到startWithAppkey中传入的appkey
@param isRealTime 是否实时上报,若传入YES,则忽略全局上报策略实时上报。否则按照全局策略上报。
*/
+ (void)trackPageViewEnd:(NSString *)page
appkey:(NSString *)appkey
isRealTime:(BOOL)isRealTime;

(2)代码示例

-(void) viewDidAppear:(BOOL)animated {
    [MTA trackPageViewBegin:@"Page"];
    [super viewDidAppear:animated];
}

- (void)viewWillDisappear:(BOOL)animated {
    [MTA trackPageViewEnd:@"Page"];
    [super viewWillDisappear:animated];
}

注意:trackPageViewBegin和trackPageViewEnd必须成对使用才能生效

使用时长统计

在UIApplicationDelegate的

- (void)applicationDidBecomeActive:(UIApplication *)application;
- (void)applicationWillResignActive:(UIApplication *)application;

两个回调中,分别添加对应的打点代码,即可上报app的使用时长。

(1)接口内容

/**
开始统计使用时长
建议在App进入前台时调用
*/
+ (void)trackActiveBegin;

/**
结束统计使用时长
建议在App离开前台时调用
*/
+ (void)trackActiveEnd;

(2)代码示例

// 开始打点
- (void)applicationDidBecomeActive:(UIApplication *)application {
    [MTA trackActiveBegin];
}

// 结束打点
- (void)applicationWillResignActive:(UIApplication *)application {
    [MTA trackActiveEnd];
}

1.5.2. 头文件MTAConfig.h

头文件 MTAConfig.h 提供了一些方法来自定义MTA的上报行为,比如上报策略,一次上报的条数等等。若有需要,可以查看 MTAConfig.h 头文件,做适当修改。

注:必须在调用 MTA 启动函数之前修改 MTAConfig 中的配置。否则配置可能不生效并且可能会引发 SDK 的一些未定义行为。

更多内容可参考sdk zip包中的开发文档

1.6. IDFA采集指南


1.6.1. 集成步骤

第一步,下载标准SDK

第二步,解压下载的SDK包,将libidfa.a和AdSupport.framework链接到工程中即可。如下图

1.6.2. 注意事项

MTA SDK支持采集iOS用户的IDFA(identifier for advertising)信息,IDFA是更通用、更精准的一种标记用户的方式,广泛应用于精准的广告效果统计、APP换量、数据互换合作等跨应用数据交叉分析场景。

使用IDFA原则上需要集成任意一家的广告SDK,如果您期望采集IDFA但是并未使用任何广告,可以采用以下方法通过Appstore审核: 1.serve advertisements within the app

应用内广告服务,适用于应用内集成了广告的场景,如果您的情况符合,需要勾选此选项。

√2.Attribute this app installation to a previously served advertisement.

用于跟踪和统计广告带来的安装量,需要勾选。

√3.Attribute an action taken within this app to a previously served advertisement

用于跟踪和统计广告安装后带来的用户行为,需要勾选。

√4.Limit Ad Tracking setting in iOS

此项属于确认项,需要勾选。

如果您仍因为采集IDFA被Appstore审核拒绝,建议您集成任意一家广告或选用MTA普通版

results matching ""

    No results matching ""