小程序埋点与流量管理

## 功能概述

小程序数据分析，是面向小程序开发者、运营者的数据分析工具，提供关键指标统计、实时访问监控、自定义分析等，帮助小程序产品迭代优化和运营。主要功能包括每日例行统计的标准分析，以及满足用户个性化需求的自定义分析。

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E5%B8%B8%E8%A7%84%E5%88%86%E6%9E%90)

## 常规分析

概况：提供小程序关键指标趋势以及top页面访问数据，快速了解小程序发展概况。  
访问分析：提供小程序用户访问规模、来源、频次、时长、深度、留存以及页面详情等数据，具体分析用户新增、活跃和留存情况。  
实时统计：提供小程序实时访问数据，满足实时监控需求。  
用户画像：提供小程序的用户画像数据，包括用户年龄、性别、地区、终端及机型分布。

详情查看[常规分析](https://developers.weixin.qq.com/miniprogram/analysis/regular/)

数据分析接口调用请查看[数据分析接口文档](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/data-analysis.html)

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E8%87%AA%E5%AE%9A%E4%B9%89%E5%88%86%E6%9E%90)

## 自定义分析

自定义分析：配置自定义上报，精细跟踪用户在小程序内的行为，结合用户属性、系统属性、事件属性进行灵活多维的事件分析和漏斗分析，满足小程序的个性化分析需求。

详情查看[自定义分析](https://developers.weixin.qq.com/miniprogram/analysis/custom/)

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E5%90%8D%E8%AF%8D%E8%A7%A3%E9%87%8A)

## 名词解释

用户：使用过小程序的微信用户，根据openid来判断。  
页面：小程序的页面，以页面路径表示，如index,  product/list。  
受访页：用户访问的所有小程序页面均可称为受访页。  
入口页：用户打开小程序时首先进入的页面称为入口页，例如用户从页面A进入小程序，跳转到页面B，A为入口页，B不是。  
退出页：用户离开小程序时最后访问的页面称为退出页，例如用户从页面A跳转到页面B，从页面B退出小程序，B为退出页，A不是。  
场景：用户打开小程序的方式，如通过扫描二维码打开小程序，场景为二维码。  
访问：用户浏览小程序页面的行为。  
添加：用户将小程序添加到“我的小程序”的行为。  
分享：用户点击小程序内或小程序外菜单，将小程序及其页面分享给好友的行为。  
新增：用户首次访问小程序页面，即称为新增。  
活跃：用户在一段时间内访问过小程序即称为活跃。  
停留：用户从打开小程序内页面，到主动关闭或超时退出小程序的过程。切换到后台、显示到聊天顶部或浮窗，均不算停留在小程序。  
留存：某个时间段内新增或活跃的用户，经过一段时间后仍然使用小程序，即称为留存，区分新增留存和活跃留存。  
事件：自定义分析中进行用户行为数据收集和分析的模型，表示某个用户行为。  
漏斗：自定义分析中由一系列事件组成的数据分析模型，用于分析业务流程中每个步骤的用户转化与流失。

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E6%8C%87%E6%A0%87%E8%A7%A3%E9%87%8A)

指标解释  
[](https://developers.weixin.qq.com/miniprogram/analysis/#%E8%AE%BF%E9%97%AE)

## 访问

累计访问人数：历史累计访问小程序的用户数，同一用户多次访问不重复计。  
新访问人数：首次访问小程序页面的用户数，同一用户多次访问不重复计。  
打开次数：打开小程序的总次数。用户从打开小程序到主动关闭或超时退出小程序的过程，计为一次。  
访问次数：访问小程序页面的总次数。多个页面之间跳转、同一页面的重复访问计为多次访问。  
访问人数：访问小程序页面的总用户数，同一用户多次访问不重复计。  
人均停留时长：平均每个用户停留在小程序页面的总时长（单位为秒），即总停留时长/访问人数。  
次均停留时长：平均每次打开小程序停留在小程序页面的总时长（单位为秒），即总停留时长/打开次数。  
平均访问深度：平均每次打开小程序访问的去重页面数。  
访问留存人数：本周期有访问，且上一周期有访问的用户（如日粒度下则为当日访问且昨日有访问的用户）  
访问回流人数：本周期有访问，上一周期没有访问，但历史有访问过的用户（如日粒度下则为当日访问且昨日没有访问，但历史曾经访问过的用户）

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E5%88%86%E4%BA%AB)

## 分享

分享次数：分享小程序页面的总次数。  
分享人数：分享小程序页面的总人数，同一用户多次分享不重复计。

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E6%B7%BB%E5%8A%A0)

## 添加  
总添加人数：历史累计将小程序添加为“我的小程序”的总用户数（去除已取消添加人数）。  
新添加人数：昨日较前日相比，新增添加到“我的小程序”的用户数 。  
删除添加人数：从我的小程序移除的用户数（按当日最后是否移除计算）  
[](https://developers.weixin.qq.com/miniprogram/analysis/#%E7%95%99%E5%AD%98)留存  
新增留存：指定时间新增（即首次访问小程序）的用户，在之后的第N天（或周、月），再次访问小程序的用户数占比。  
活跃留存：指定时间活跃（即访问小程序）的用户，在之后的第N天（或周、月），再次访问小程序的用户数占比。

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E6%94%AF%E4%BB%98)

## 支付

累计支付金额：截止至昨日，小程序历史非免密支付总体累计金额。  
支付笔数：小程序内非免密支付成功次数。  
支付金额：小程序内非免密支付成功总金额。  
单均支付金额：小程序内每笔非免密支付的平均金额，即小程序内非免密支付成功总金额/小程序内非免密支付成功次数。  
支付人数：小程序内非免密支付成功人数，同一用户多次支付不重复计算。  
人均消费次数：小程序内完成非免密支付用户的平均支付次数，即小程序内非免密支付成功次数/小程序内非免密支付成功人数。  
首次支付人数：当日首次在小程序内完成支付的用户数，同一用户多次支付不重复计算。  
复购人数：非当日首次在小程序内完成支付的用户数，同一用户多次支付不重复计算。  
支付次数转化率：在小程序内，完成非免密支付转化的小程序打开次数占比，即小程序内非免密支付成功次数/小程序打开次数。  
支付人数转化率：在小程序内，完成非免密支付转化的小程序用户数占比，即小程序内非免密支付成功人数/小程序打开人数。

[](https://developers.weixin.qq.com/miniprogram/analysis/#%E9%A1%B5%E9%9D%A2)

## 页面

（页面）访问次数：访问该页面的总次数。  
（页面）访问人数：访问该页面的总用户数，同一用户多次访问不重复计。  
（页面）次均时长：用户平均每次访问该页面的停留时长（单位为秒），即该页面的总停留时长/访问次数。  
（页面）入口页次数：该页面作为入口页的访问次数，例如一用户从页面A进入小程序，则页面A的入口页次数+1。  
（页面）退出页次数：该页面作为退出页的访问次数，例如一用户从页面B退出小程序，则页面B的退出页次数+1。  
（页面）退出率：该页面作为退出页的访问次数占比，即退出页次数/访问次数。  
（页面）分享次数：分享该页面的总次数。  
（页面）分享人数：分享该页面的总人数，同一用户多次分享不重复计。  
  
  
## 事件：  
  
trigger：触发条件  
●click: 点击时触发，必须指定page和element  
●enterPage: 进入页面时触发，包括新开、后退、切换到前台都属于进入页面，必须指定page  
●leavePage: 离开页面时触发，包括离开、切换到后台都属于离开页面，必须指定page  
●pageLoad: 新开页面时触发，即第一次进入页面，必须指定page  
●pageUnload: 回收页面时触发，必须指定page  
●switchTab: 调用switchTab接口切换页面时触发，必须指定page  
●pullDownRefresh: 下拉刷新时触发，必须指定page  
●launch: 加载小程序时触发  
●background: 切换到后台触发  
●foreground: 切换到前台触发  
●share: 右上角菜单分享时触发  
  
page：触发的页面, 如pages/index/index, pages/list/list，此规则与小程序app.json的pages字段保持一致， 如果需要任意页面触发，则填写ANY\_PAGE。  
element：触发的元素，支持一层级的css的id和class选择器，即必须以.或者#开头  
data：收集的自定义数据，为0到多项，每一项都是以 “字段名 字段值”的方式；如果不填，则只收集系统数据。

●字段名：事件里的字段名  
●字段值：事件里这个字段的数据值，可收集小程序中的变量，规则如下：  
○填写的变量名，默认从page实例的data字段中获取  
○若想收集由list变量渲染的列表中的某一项数据，则可用list\[\].\*表示，这里会根据当前填写的element（只能是class）得到的NodeList的第几个来决定数组下标。  
○若列表是二维的，则可用list\[\]\[\].\*表示，这里element需填写两个class（空格隔开）分别表示父列表与子列表。  
○若想取得数组的下标，则可用list\[\].$INDEX表示  
○若想取得wxml中data-\*系列属性的值，则可用$DATASET.\*表示  
○若想取得app实例的数据，则可用$APP.\*表示，只支持获取基本类型的数据，如number、string、boolean。

除此之外，还可以填写一些提供的系统属性，以“$”开头，目前支持以下属性：

●$PAGE\_TIME 用户从进入本页面到当前的时间(触发action的时间点)  
●$APP\_TIME 用户进入小程序到当前的时间(触发action的时间点)  
●$CURRENT\_PAGE 当前用户所在的页面  
●$LAST\_PAGE 上一页

注：data可以为空，为空时该事件上报仅收集系统默认字段的数据