uni-app 微信小程序 + 友盟统计 sdk

在开发小程序时，有些功能会需要统计用户点击次数、登录人数、访问时长等数据，用来分析用户的一些行为；这里分享一下用 uni-app 开发微信小程序借助友盟 SDK 在前端页面中埋点统计的实现过程；

1、注册友盟账号

友盟官网：https://www.umeng.com/；按照指引注册友盟账号，如果是企业使用，建议使用企业邮箱；

2、申请 AppKey

登录之后产品-统计分析-小程序统计-进入控制台，这里需要绑定邮箱，绑定成功之后就可以创建自己的应用；点击 添加应用 来添加自己的小程序；
按照指引填写小程序相关信息，在创建过程中就会生成这个小程序的 AppKey，这个 AppKey 在后面开发过程中连接小程序和友盟后台的一个标识；

3、uni-app微信小程序使用友盟SDK

1、安装引入友盟

npm install umtrack-wx --save
npm install

2、在 main.js 文件中引用

//接入友盟统计
import uma from "umtrack-wx";
uma.init({appKey: `${友盟给出的appkey}`,// 使用Openid进行统计，此项为false时将使用友盟+uuid进行用户统计。// 使用Openid来统计微信小程序的用户，会使统计的指标更为准确，对系统准确性要求高的应用推荐使用Openid。useOpenid: true, // 使用openid进行统计时，是否授权友盟自动获取Openid，// 如若需要，请到友盟后台"设置管理-应用信息"(https://mp.umeng.com/setting/appset)中设置appId及secretautoGetOpenid: true,debug: true, //是否打开调试模式uploadUserInfo: true // 自动上传用户信息，设为false取消上传，默认为false
});
uma.install = function (Vue) {Vue.prototype.$uma = uma;
};
Vue.use(uma);

这里使用 useOpenid 时建议将 autoGetOpenid 也设置为 true，这样就不用开发者手动上传 openId 了；

3、小程序后台增加友盟服务域名
登录小程序后台，在开发-开发管理-开发设置-服务器域名-request合法域名 增加友盟的域名：https://umini.shujupie.com；

4、自定义事件
在友盟后台自定义事件页面，点击事件管理 然后点击添加事件，填写小程序埋点的事件 ID 和名称，然后小程序就可以使用自定义事件来进行埋点；

5、小程序使用

this.$uma.trackEvent('自定义事件', { "属性名": '属性值' });

在需要埋点的地方加上上面这段代码就可以真的自定义的事件进行埋点了；

6、自定义事件使用方法

//只统计事件
this.$uma.trackEvent('自定义事件');
//携带参数，字符型属性值
this.$uma.trackEvent('自定义事件', { "属性名": '属性值' });
//携带参数，数值型属性值
this.$uma.trackEvent('自定义事件', { "属性名": 1 });

4、SDK接人成功查看

按照上面方法引入之后，在微信开发者工具的 调试器 Console 中，如果接人成功则会打印出： [UMENG] – SDK集成成功；

注意

1、慎重调用 uni.clearStorage() 以及 uni.clearStorageSync() 接口，SDK 会将用户相关操作数据缓存在客户端数据存储模块，在特定时间启动发送策略；若调用该接口可导致数据统计不准确的问题；

2、若用户在使用小程序过程强制关闭微信有可能会造成统计数据丢失的情况；

3、在埋点触发之后，友盟后台不会立刻就有对应的数据变化，它会将数据存储在客户端，在特点时间发送之后才能看到数据的变化；所以才测试过程中，数据没变化不要着急，先等一等；