小程序统计需要 Pro 及以上套餐。微信、支付宝、抖音三个平台用同一套 SDK,只是入口不同,数据可以在一个项目里按平台分开看。
自动记录哪些
初始化之后不用写代码就会记录:
- 冷启动和每次切到前台
- 页面进入和离开(含停留时长)
- 分享
- 收藏
点击默认不记,这是为了控制包体大小和性能。需要的话可以在控制台打开小程序全埋点,或者在关键按钮上手动记事件。
接入步骤
1. 登记 appid
到「小程序统计 › 配置 › SDK 代码」添加 appid,必须和小程序后台里的完全一致。
2. 配置 request 合法域名
把向导里给出的采集域名加入对应平台小程序后台的「request 合法域名」。
这一步最容易漏。开发者工具里勾了「不校验合法域名」时一切正常,一到真机或体验版就没数据,几乎都是这个原因。另外,合法域名保存之后要重新编译上传,旧的预览包还是会请求失败。
3. 安装并初始化
按向导选择平台,复制安装命令和初始化代码。初始化同样分两步:在 app.js 最顶部预初始化,它会自动挂上应用和页面的生命周期;需要用户同意隐私协议的,等同意后再完成初始化。
如果你用的框架不能改写全局的 Page(部分跨端框架是这样),自动挂载会失效,要用 SDK 提供的页面包装函数包住页面配置。向导里有对应写法。
4. 预览一次
用开发者工具或真机打开首页,然后到「小程序统计 › 实时」看,能看到启动事件就说明通了。
登录之后关联用户
拿到用户的 OpenID(或你自己系统的用户编号)之后调用登录方法,类型写 OpenID。这样同一个人在小程序和网站上的行为可以合并(需要开启识别模式),见 把匿名访客和登录用户连起来。
场景值
小程序报表里的「渠道」页可以切换成场景值,看用户是从扫码、分享卡片、搜索还是公众号文章进来的。场景值由平台提供,SDK 会自动带上。
离线和弱网
SDK 会把事件先存在本地,网络恢复后再发。本地队列最多 10000 条、保存 7 天、不超过约 1 MB,超出时丢最旧的记录。正常使用一般不会触发这个上限。
排除测试设备
在「小程序统计 › 配置 › 小程序设置」里排除测试设备。没有单独设置时,小程序沿用网站端的排除和会话规则。