本页目录
  1. 自动记录哪些
  2. 接入步骤
  3. 1. 登记 appid
  4. 2. 配置 request 合法域名
  5. 3. 安装并初始化
  6. 4. 预览一次
  7. 登录之后关联用户
  8. 场景值
  9. 离线和弱网
  10. 排除测试设备

小程序统计需要 Pro 及以上套餐。微信、支付宝、抖音三个平台用同一套 SDK,只是入口不同,数据可以在一个项目里按平台分开看。

自动记录哪些

初始化之后不用写代码就会记录:

  • 冷启动和每次切到前台
  • 页面进入和离开(含停留时长)
  • 分享
  • 收藏

点击默认不记,这是为了控制包体大小和性能。需要的话可以在控制台打开小程序全埋点,或者在关键按钮上手动记事件。

接入步骤

1. 登记 appid

到「小程序统计 › 配置 › SDK 代码」添加 appid,必须和小程序后台里的完全一致。

2. 配置 request 合法域名

把向导里给出的采集域名加入对应平台小程序后台的「request 合法域名」。

这一步最容易漏。开发者工具里勾了「不校验合法域名」时一切正常,一到真机或体验版就没数据,几乎都是这个原因。另外,合法域名保存之后要重新编译上传,旧的预览包还是会请求失败。

3. 安装并初始化

按向导选择平台,复制安装命令和初始化代码。初始化同样分两步:在 app.js 最顶部预初始化,它会自动挂上应用和页面的生命周期;需要用户同意隐私协议的,等同意后再完成初始化。

如果你用的框架不能改写全局的 Page(部分跨端框架是这样),自动挂载会失效,要用 SDK 提供的页面包装函数包住页面配置。向导里有对应写法。

4. 预览一次

用开发者工具或真机打开首页,然后到「小程序统计 › 实时」看,能看到启动事件就说明通了。

登录之后关联用户

拿到用户的 OpenID(或你自己系统的用户编号)之后调用登录方法,类型写 OpenID。这样同一个人在小程序和网站上的行为可以合并(需要开启识别模式),见 把匿名访客和登录用户连起来。

场景值

小程序报表里的「渠道」页可以切换成场景值,看用户是从扫码、分享卡片、搜索还是公众号文章进来的。场景值由平台提供,SDK 会自动带上。

离线和弱网

SDK 会把事件先存在本地,网络恢复后再发。本地队列最多 10000 条、保存 7 天、不超过约 1 MB,超出时丢最旧的记录。正常使用一般不会触发这个上限。

排除测试设备

在「小程序统计 › 配置 › 小程序设置」里排除测试设备。没有单独设置时,小程序沿用网站端的排除和会话规则。

本主题下一篇应用报表:新增、留存、版本和崩溃