MTA(Android)快速接入

本文档将帮助您快速接入大家都在使用的腾讯移动分析统计功能,高级的功能接入请参考开发者手册。

注册app,下载SDK



图1:首页

登陆MTA首页http://mta.qq.com,点击MTA首页的“立即使用”(可能会弹出登陆窗口,请使用您的QQ号码登陆)。


图2 注册页面

在注册页面,请填写您的应用名称,选择应用分类和应用平台,应用负责人和关注人(也可稍后在“我的应用”“设置”里面配置),点击完成。

图3 注册成功

注册成功即可获取应用唯一的appkey(建议您保存到本地,并做好标识),可以前往“SDK下载中心”下载对应压缩包到本地。


 配置工程


图4 配置MTA SDK路径

打开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”按钮即导入成功。

图5 AndroidManifest.xml

图6 AndroidManifest.xml编辑

双击工程目录下的AndroidManifest.xml文件,在打开的页面下面的标签点击“AndroidManifest.xml”切换到源代码编辑界面,将“</application>”用以下内容替换。其中“YOUR_APPKEY”修改为刚刚注册得到的AppKey,比如:“A31BQW6MZ5RP”,而“YOUR_CHANNEL”修改为发布的渠道(市场)。

MID3.5 增加provider 配置

<provider

     android:name="com.tencent.mid.api.MidProvider"

     android:authorities="你的包名.TENCENT.MID.V3"

     android:exported="true" >

</provider>



<meta-data android:name="TA_APPKEY" android:value="YOUR_APPKEY" />
<meta-data android:name="InstallChannel" android:value="YOUR_CHANNEL" />
</application>
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_SETTINGS"/>


图7 AndroidManifest.xml 配置



嵌入MTA代码



图8 AndroidManifest中找最先启动的activity

切换到工程目录,双击app最先启动的activity,即MTAMainActivity。

双击MTAMainActivity.java源代码文件,在onCreate函数中输入以下1行MTA代码。


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



图9 嵌入代码


验证数据上报


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

图10 验证数据上报

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

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

2、 APPKEY、权限等设置是否正确;

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

4、 参考图8,打开MTA的debug开关,重新编译运行,查看标签为“MtaSDK“的logcat提示,是否有错误日志;

5、 如果logcat提示“Compatibility problem was found in this device!“,请先删除apk重新安装,可参考开发者手册里的兼容性错误;


SDK嵌入完成


恭喜!到这里您已经顺利接入MTA的统计功能,需要获得更高级的服务功能,请参考开发者手册。



目录

回到顶部