MTA统计功能接入指引

来源:互联网 发布:拆分盘系统源码 编辑:程序博客网 时间:2024/05/24 02:35

原文地址: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
  • 2. 配置工程
  • 3. 嵌入MTA代码
  • 4. 验证数据上报
  • 5. 附件

1. 获取AppKey

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

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

系统平台前缀AndroidAqcIOSIqc

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”按钮即导入成功。如下图所示:
mta_1.png

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

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

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>

需修改的地方如下图:
mta_4.png

其中,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", "");

如下图所示:
mta_5.png


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


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如下图所示:
mta_7.png

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


5. 附件

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


0 0
原创粉丝点击