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。
修改标记对“<application>、</application>”中的内容。其中“YOUR_APPKEY”修改为开放平台应用appid加上“Aqc”前缀得到的AppKey，比如：“Aqc123456”，“InstallChannel”保持为默认值即可。
<application>
<meta-data android:name="TA_APPKEY" android:value="YOUR_APPKEY" />
<meta-data android:name="InstallChannel" android:value="OpenPlatform" />
</application>
需修改的地方如下图：
其中，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样例：下载地址