MTA统计功能接入指引

原文地址：http://wiki.open.qq.com/wiki/mobile/MTA%E7%BB%9F%E8%AE%A1%E5%8A%9F%E8%83%BD%E6%8E%A5%E5%85%A5%E6%8C%87%E5%BC%95

MTA统计功能接入指引

本文档将帮助您快速接入大家都在使用的MTA统计功能，高级的功能接入请参考开发者手册。

1. 获取AppKey

MTA已经将开放平台的应用appid注册到系统上，开发者只需要在appid上添加前缀，即为MTA的AppKey，其中规则如下表（大小写敏感）。

例如开放平台appid为“123456”的应用对应于MTA的Android AppKey是“Aqc123456”，iOS AppKey是“Iqc123456”。

系统平台	前缀
Android	Aqc
IOS	Iqc

2. 配置工程

1. 打开eclipse，新建或选择现有的Android项目。解压下载的MTA压缩包，将其中lib目录下的mta-sdk-x.x.x.jar 复制到应用工程库目录（通常名为libs，如果不存在请新建一个）中。右键点击工程根目录，选择Properties → Java Build Path →Libraries →点击Add JARs…，选中当前工程libs目录下的mta-sdk-x.x.x.jar文件，点击“OK”按钮即导入成功。如下图所示：

2. 双击工程目录下的AndroidManifest.xml文件。

3. 双击工程目录下的AndroidManifest.xml文件，在打开的页面下面的标签点击“AndroidManifest.xml”切换到源代码编辑界面。

4. 配置AndroidManifest.xml。
修改标记对“、”中的内容。其中“YOUR_APPKEY”修改为开放平台应用appid加上“Aqc”前缀得到的AppKey，比如：“Aqc123456”，“InstallChannel”保持为默认值即可。

需修改的地方如下图：

其中，AppKey也可通过初始化代码设置。

String open_appid = "开放平台appid";
StatConfig.setAppKey(this, "Aqc" + open_appid);

3. 嵌入MTA代码

1. 切换到工程目录，双击app最先启动的activity，即MTAMainActivity。
双击MTAMainActivity.java源代码文件，在onCreate函数中输入以下1行MTA代码。

StatService.trackCustomEvent(this, "onCreate", "");

如下图所示：

2. 然后在每个Activity中，重载onResume和onPause函数，分别调用StatService.onResume(this)和StatService.onPause(this)统计每天的激活量。代码示例如下：

4. 验证数据上报

成功嵌入SDK后，在模拟器或手机运行上面已经编译好的应用（确保已执行MTA代码），便会自动上报数据。
如果需要验证数据是否上报，请在代码中开启MTA的debug开关，然后查看logcat标签为“MtaSDK”的输出内容。
注：在发布时，务必关闭debug。

正常上报日志
如果logcat输出上报内容及返回码200，说明成功上报到服务器。
假如要检查页面上报是否成功，请切换Activity，若切换后看到有类似内容上报即表示打点成功，其中et为1，pi为当前Activity的名称。

{"ui":"354316058466436","du":21,"ky":"Aqc222222","ts":1374749000,"mc":"38:AA:3C:74:74:2D",
"et":1,"pi":"com.tencent.mtasdkdemo.MainActivity","si":1377143681}

上报成功logcat如下图所示：

上报失败
提示AppKey错误，请检查Appkey是否满足要求并配置正确。
上报失败的logcat示例：

5. 附件

MtaSdkDemo代码：下载地址
MTA AndroidManifest.xml样例：下载地址