5.【MTA】腾讯移动分析Android 统计SDK开发者接入指南.docx

Android 统计SDK开发者使用指南
腾讯移动分析出品
目录
Android 统计SDK开发者使用指南 1
1 开始嵌入SDK 3
安装和部署 3
升级SDK 6
2 初始化并启动MTA 7
3 基础指标统计 9
页面统计 9
会话统计 10
错误统计 11
4 自定义事件 13
注册自定义事件 13
【次数统计】Key-Value参数的事件 13
【次数统计】带任意参数的事件 14
【时长统计】Key-Value参数事件 14
【时长统计】带有统计时长的自定义参数事件 15
5 接口监控 17
6 高级功能 19
游戏统计 19
在线配置更新 19
7 数据上报 21
数据上报策略 21
数据上报相关的设置接口 22
8 APP设置接口 23
9 注意事项 25
何时调用StatConfig配置接口 25
调试app 25
发布app 26
SDK冲突问题 26
提示兼容性错误 28
10 特殊需求 29
激活量统计 29
只做少数页面统计 29
只统计用户打开app的次数 29
只统计app的设备、网络等信息 29
只上报app未捕获的异常 29
只用于接口监控 29
开始嵌入SDK
安装和部署
欢迎使用腾讯移动分析(简称MTA)Android统计SDK,您可以按照下面6步开始SDK的统计。
Step 1 获取AppKey
MTA已经将开放平台的appid注册到系统上,开发者只需要在appid上添加前缀,即为MTA的AppKey,其中规则如下表(大小写敏感)。
系统平台
前缀
Android
Aqc
iOS
Iqc
例如appid为“123456”的应用对应于MTA的Android AppKey是“Aqc123456”,iOS AppKey是“Iqc123456”。
Step 2 向工程中导入SDK
(、---这两个文档中也有同样的操作说明,参照任意一个即可)
下载SDK压缩包,解压至本地目录,将其中lib目录下的mta-sdk-,以实际SDK的名字为准
复制到您的应用工程的库存储目录(通常为libs或lib目录)中。以Eclipse为例:右键点击工程根目录→选择Properties → Java Build Path →Libraries →点击Add JARs…选中当前工程libs目彔下的mta-sdk-,点击“OK”按钮即导入成功。
Step 3
Appkey和渠道设置
Meta-Data
类型
用途
必选
TA_APPKEY
String
MTA提供给每个app的appkey,用来定位该应用程序的唯一性
√
InstallChannel
String
用来标注应用推广渠道,区分新用户的来源来查看统计
√
(注意:appkey和installChannel也能够在代码中设置,见APP设置接口)
权限设置
需要的权限
用途
必选
允许应用程序联网,以便向我们的服务器端发送数据
√
READ_PHONE_STATE
获取用户手机的IMEI,用来唯一的标识用户。(运行在平板上的应用会读取mac地址作为用户的唯一标识
√
WORK_STATE
获取设备的网络状态
√
ACCESS_WIFI_STATE
获取设备的WIFI网络状态
√
WRITE_EXTERNAL_STORAGE
获取SD卡信息
√
<?xml version="" encoding="utf-8"?>
<manifest ......>
<uses-sdk android:minSdkVersion="7" android:targetSdkVersion="7"/>
<!—为MTA授权。< -->
<!—如果是第三方lib项目,请在手册中提示app开发者授予以下权限! < -->
<uses-permission android:name="."/>
<uses-permission android:name=""/>
<uses-permission andr