快应用统计SDK集成文档
前言：
适用范围
该文档适用于友盟+快应用统计SDK 2.0.3 及以上版本
点击下载：2.0.3
一、快应用统计SDK快速集成
1. Appkey申请——为您的快应用申请新的Appkey
登录友盟+官网，在我的产品页面添加新应用，然后获取到Appkey，为下一步集成做准备。
2. 创建快应用并接入SDK
2.1 获取SDK文件
获取js文件：umengannlysis.es.min.js
点击下载：快应用SDK 2.0.3版
2.2 为快应用项目导入SDK
将umengannlysis.es.min.js拷贝到您的快应用项目src/路径下
2.3 为SDK添加相应权限
在您项目中的manifest.json文件中加入相应的权限信息：
添加代码如下：
"features": [
{ "name": "system.storage"},
{ "name": "system.fetch"},
{ "name": "system.network"},
{ "name": "system.device"},
{ "name": "system.file"}
]2.4 为快应用项目配置Appkey
在您项目中的manifest.json文件中加入appkey信息，添加代码如下：
"config": {
"data":{
"umeng_appkey" : "5ad7fb4**********d0000d5",//umeng_appkey即为上步申请的Appkey
}
}2.5 为快应用项目的app.ux文件中添加如下代码：
<script>
import './umenganalysis.es.min'; //必须添加！！！
export default {
onCreate(){
console.log("[app.ux] onCreate...");
$umeng_stat.init(this); //在onCreate函数中加入该行代码，必须添加！！！
}
}
</script>3. 基础接口引入
在每个页面中添加基础数据统计接口：
$umeng_stat.resume(this);
$umeng_stat.pause(this);示例：在App中每个路由页面的onShow和onHide方法中调用$umeng_stat.resume()和$umeng_stat.pause()方法，添加代码如下：
<script>
export default {
onShow(){
$umeng_stat.resume(this) //在onShow方法的第一行加入此代码
//App业务代码
},
..............
onHide() {
$umeng_stat.pause(this);//在onHide方法的第一行加入此代码
//App业务代码
}
}
</script>注意：请确保在所有路由页面都调用$umeng_stat.resume()和$umeng_stat.pause()这两个方法。
至此快应用SDK统计接入完成，您可以在U-App官网中查看应用新增用户、活跃用户、启动次数、使用时长等基本数据。
二、高级功能
1. 自定义事件打点接口及调用说明
$umeng_stat.trackEvent(id,attr);1.1 仅需统计事件，无参数时，可使用如下方法：
$umeng_stat.trackEvent('事件ID');//事件ID需在官网申请，长度在128个字符内1.2 需要给id打标签，attr属性可以传入字符串：
$umeng_stat.trackEvent('事件ID','事件标签');1.3 需要统计带参数的事件时，可使用如下方法：
$umeng_stat.trackEvent('事件ID',{'参数_1':'参数值1','参数_2':'参数值2'});注意：
使用自定义事件功能请先登录U-App管理页面，点击【应用列表】-> 【应用名称】 -> 【应用设置】 -> 【事件】（子账户由于权限限制可能无法看到”设置”选项，请联系主帐号开通权限。）页面中添加相应的事件id（事件id可用英文或数字，不要使用中文和特殊字符且不能使用英文句号”.”您可以使用下划线”_”），事件类型选择【计数事件】，然后服务器才会对相应的事件请求进行处理。
请在sdk初始化之后调用事件。
三、进阶功能
开发者无需在页面主动调用$umeng_stat.resume()和$umeng_stat.pause()这两个方法，该埋点方式更加简洁。可以根据您的需求自由选择 :) 配置方式如下所示：
<script>
// export default {//原有导出方式
export default Page ({//新加入的代码
data: {
},
onInit () {
console.log('index onInit');
}
//如无业务代码，可以无需调用onShow和onHide函数
/*onShow () {
console.log('index onShow');
$umeng_stat.resume(this);
},
onHide (){
console.log('index onHide');
$umeng_stat.pause(this);
}*/
// } //原有导出方式
}) //新加入的代码
</script>四、说明事项
1、快应用SDK1.0.0 Beta版本发送策略：APP启动时发送当次启动数据和上次的使用时长等缓存数据，当次使用过程中产生的自定义事件数据缓存在客户端，下次启动时发送。
2、慎重调用storage.clear(OBJECT)接口！友盟+SDK会将用户相关操作数据缓存在客户端数据存储模块，在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题。
重要更新
2022.09.01——2.0.3
优化了id生成逻辑
2018.07.12——1.0.0_Beta：
友盟+快应用SDK 1.0.0_Beta版正式公测，提供包括用户分析、终端分析、渠道分析等移动应用统计基础功能
2018.07.13——1.0.1_Beta：
1、更改页面路径采集方案；
2、优化新增用户标识。
2018.07.17——1.0.2_Beta：
1、优化入口页名称采集方案
2018.07.20——1.0.3_Beta：
1、优化设备终端显示名称采集方案
2018.07.30——1.0.4_Beta：
1、优化页面名称采集方案
2018.08.08——1.0.5_Beta：
1、去掉“http”样式代码
2018.11.28——2.0.0：
1、加入间隔发送策略
FAQ:
Q：快应用和安卓版本能否共用一个appkey
A：快应用目前没有单独规划为一个独立平台，但是建议用户分开注册不同的appkey
Q: 注册应用时，提示应用名称已存在
A：【友盟+】后台的应用名与实际应用名和包名无关，建议命名为应用名+平台
Q: 我忘记我的Appkey了，在哪里能查到
A：登录管理页面，在应用列表中点击去集成，即可看到当前应用的Appkey