支付宝小程序：事件管理

事件及字段

事件是自定义分析进行用户行为数据收集和分析的模型。

一个事件的数据都是由多个字段组成，字段包括系统默认字段和用户自定义字段。

系统默认字段由系统收集数据，如省份，城市，国家等；而用户自定义字段则是用户指定并收集数据。

字段的定义是全局的，即事件A使用了字段 a，事件 B 也使用了字段 a，a 在事件 A 和 B 中的定义及描述是一致的。

目前，字段类型支持 32 位整数型及字符型。

?登录 小程序开发者中心控制台 > 小程序详情页 > 数据中心 >自定义分析 > 事件 中进行小程序事件管理。

保存并测试。保存并发布，将保存当前配置并发布，可以正式收集和分析用户行为数据。

修改事件配置时，如果不符合实际需求，可以点击 重置为线上版本 撤销修改。

注意：该操作不会自动保存，重置为线上版本 需要再点击 保存。

每个事件都需要指定收集数据的方式，这个是通过事件上报配置来管理的。

事件上报配置的每一项都是一个动作，可以由一到多个动作组成。

动作的各项含义如下。

• click 点击时触发，必须指定 page 和 elementr。

• enterPage 进入页面时触发，包括新开、后退、切换到前台都属于进入页面，必须指定 pager。

• leavePage 离开页面时触发，包括离开、切换到后台都属于离开页面，必须指定 pager。

• pageLoad 新开页面时触发，即第一次进入页面，必须指定 pager。

• pageUnload 回收页面时触发，必须指定 pager。

• switchTab 调用 switchTab 接口切换页面时触发，必须指定 pager。

• pullDownRefresh 下拉刷新时触发，必须指定 pager。

• launch 加载小程序时触发r。

• background 切换到后台触发r。

• foreground 切换到前台触发r。

• share 右上角菜单分享时触发r。

• api ?自定义分析数据的上报，调用 my.reportAnalytics 时触发。

trigger 发生时的动作，默认会收集数据，包括系统默认数据和用户自定义数据（data 中定义）。收集数据后可以立即上报，也可以分多步收集，再上报。有如下定义：

1. collect：收集数据。

2. report：收集数据并上报当前收集的所有数据。

比如：

1. collect（收集数据）> report（收集数据并上报）。

2. report（收集数据并立即上报）> collect（收集数据）> report（收集数据并上报）。

注意：事件的最后一个动作的 action 必须为 report。

触发的页面，如 pages/index/index, pages/list/list，此规则与小程序 app.json 的 pages 字段保持一致， 如果需要任意页面触发，则填写 ANY_PAGE。

触发的元素，支持一层级的 css 的 id 和 class 选择器，即必须以’.’或者’#’开头。

收集的自定义数据，为 1 到多项， 每一项都是以 “字段名 字段值”的方式；必须填写至少一项：

• 字段名：事件里的字段名r。

• 字段值：事件里这个字段的数据值，可收集小程序中的变量，规则如下：r

  • 填写的变量名，默认从 page 实例的 data 字段中获取r。

  • 若想取得 axml 中 data- 系列属性的值，则可用 $DATASET. 表示r。

  • 若想取得 app 实例的数据，则可用 $APP.* 获取 appx.globalData 的数据，只支持获取基本类型的数据，如 number、string、boolean。

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

• $PAGE_TIME 用户从进入本页面到当前的时间（触发 action 的时间点）。

• $APP_TIME 用户进入小程序到当前的时间（触发 action 的时间点）。

• $CURRENT_PAGE 当前用户所在的页面r。

• $LAST_PAGE 上一页。

多动作收集的例子：如果数据需要跨多个页面收集，那么就需要多个动作来完成上报了，比如下面的例子，在 viewList 页面收集 product_name, product_category 的数据，然后进入 viewProduct 页面时收集到 product_price 的数据，并上报。

包含新增已定义、新增未定义、停用、启用 4个状态。

• 新增已定义：本次添加的字段在小程序的其他事件中已定义，在当前事件中未定义。

• 新增未定义：本次添加的字段在小程序的所有事件中都未定义。

• 停用：删除当前事件的字段。

• 启用：添加已停用的字段。

字段检查后，完善字段信息，点击保存按钮，提交保存本次事件配置。

点击保存并测试，先保存事件，再开始测试流程。先选择人员，点击下一步。此时会同步把事件配置下发给该用户的小程序。

点击 同步结果 同步数据。

等待数据上报，数据一旦上报，会在表格展示。

点击关闭结束测试。

点击保存并发布，先保存事件配置，再发布配置。终端用户打开小程序时会拉取到最新发布的配置。