支付寶小程序：事件管理

事件及字段

事件是自定義分析進行用戶行為數據收集和分析的模型。

一個事件的數據都是由多個字段組成，字段包括系統默認字段和用戶自定義字段。

系統默認字段由系統收集數據，如省份，城市，國家等；而用戶自定義字段則是用戶指定并收集數據。

字段的定義是全局的，即事件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個狀態。

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

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

• 停用：刪除當前事件的字段。

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

字段檢查后，完善字段信息，點擊保存按鈕，提交保存本次事件配置。

點擊保存并測試，先保存事件，再開始測試流程。先選擇人員，點擊下一步。此時會同步把事件配置下發給該用戶的小程序。

點擊 同步結果 同步數據。

等待數據上報，數據一旦上報，會在表格展示。

點擊關閉結束測試。

點擊保存并發布，先保存事件配置，再發布配置。終端用戶打開小程序時會拉取到最新發布的配置。