M 2 · DOC-2026-017 · extracted

13-埋点与监控

原文 · 14 段（高亮 = 已被卡片引用）

p1# 13 · 埋点与监控

p2> 事实来源 = SDK 代码仓 `ifes-resm`（`src/constants/stats/*`、`utils/report.js`）。

p3## 模块定位

p4H5 客户端的行为埋点（`$report.stats`）+ 对外/风控平台事件上报 + GPS 定位上报。用于功能响应率分析、风控、合规留痕。

p5## 埋点体系（`constants/stats/*.js`）

p6- 调用：`this.$report.stats(EVENT, extraParams?)`；事件是 `{label, category, action}` 对象，`action` 常带占位符（如 `..._${term}m.click`）。 - 主要分区与代表事件：

p7| 分区（文件）| 代表事件 | |---|---| | **CREDITLINE**（creditline.js）| `CREDITLINE_PAGEVIEW` / `CREDITLINE_GETCASH_CLICK` / `CREDITLINE_REPAYNOW_CLICK` / `creditline_min_repay.click`（首页最小还款入口）| | **INSTANT_CASH** | `INTRO/WITHDRAW/WITHDRAW_CONFIRM_PAGEVIEW`、`WITHDRAW_SELECTED_TERM`、`WITHDRAW_CHECK_PIN_SUCCESSED/_FAILED`、`INSTANT_CASH_COUPONS_*` | | **BILL / REPAYMENT** | `REPAYMENT_PAGEVIEW`、`repayment_in_full.click` / `minimum_repayment.click`、`REPAYMENT_CHECK_PIN_*` | | **FLEXIBLE_LIMIT_ADD_LIMIT** | 提额页 PV/按钮、快捷金额 `..._${amount}.click`、`SWITCH_ASSET`（积分/钱包切换）、CHECK_PIN | | **COUPONS**（coupons.js）| `COUPONS_PAGEVIEW`、`TOP/ALL_COUPONS_${id}.click`、`MY_COUPONS_USE_${id}.click` | | **PAY_LATER**（pay-later.js）| `PAYLATER_HOME_PAGEVIEW`、`BANNER_VIEW/CLICK`、`GET_CASH/PAY/REPAY_NOW_CLICK`、`LIMIT_UP_ENTRY_CLICK`、`ACTIVATE/RENEW_MEMBER_CLICK`、`PAYLATER_LANDING_*`、`MGM_TASK_GO`、`PAYLATER_INVESTIGATION_POPUP`（问卷/挽留弹窗）|

p8> 弹窗曝光/关闭埋点部分在 H5 侧（如 `PAYLATER_INVESTIGATION_POPUP` 等问卷/挽留弹窗），部分主页/原生壳弹窗在原生侧；逐事件归属以代码为准。

p9> 上表为代表分区，并非 `constants/stats/` 全集。`stats/` 目录还含以下埋点文件：

p10| 分区（文件）| 覆盖范围 | |---|---| | **allo-balance-and-points.js** | Allo 余额与积分相关页面/动作 | | **allo-pay-upgrade.js** | Allo Pay 钱包升级（中级/高级户）流程 | | **deals.js** | 商城/优惠 Deals 模块 | | **deposit-liquidity.js** | 流动性定存与质押链路（含取现的 `WITHDRAWAL_PROCESS` 部分） | | **native.js** | 原生壳触发的通用事件 | | **news.js** | 资讯/消息模块 | | **top-up.js** | 充值，按渠道细分为 **8 个分区**（`TOPUP` / `TOPUP_MEGA` / `TOPUP_INSTANT` / `TOPUP_DEBIT` 等，每渠道独立 category） | | **pay-later-application.js** | 开通申请全链路，顶层共 **11 个分区（顶层 key）**：`APPLICATION_PAYLATER` / `APPLICATION_PIN` / `APPLICATION_OCR` / `APPLICATION_FACE` / `APPLICATION_PAYLATER_FORM` / `APPLICATION_PDF_VIEWER` / `APPLICATION_UPGRADE_FORM` / `APPLICATION_PAYLATER_RESULT` / `APPLICATION_VIDEO_BANKING` / `APPLICATION_IOH_OTP` / `CHECK_APP_LIST`。注：landingpage / terms&conditions / detain / KTP / pre credit limit / face scan preparation / face detection / information / application.paylater 等是 **`APPLICATION_PAYLATER` 这一个顶层分区内部的 category 细分值**，不是顶层分区 |

p11## 对外/风控上报

p12- **`report-to-outside.js`**（`$native.reportToOutside`）：发给原生/三方 —— 如 `ENTER_GET_CASH_CLICK`、`VIEW_COUPON_PAGE`、`FACE_VERIFICATION_SUCCESS/_FAILED`、`LIMITUP / LIQUIDITY_LOAN`（产品采纳）。 - **`report-to-cnc.js`**：发给内部风控/CNC —— 落地页进入、T&C、OCR/活体（`APPLY_OCR_SUCCESS/_FAIL`、`APPLY_FACIAL_RECOGNITION_*`）。 - **GPS 定位**（`utils/report.js#reportLocation`）：KYC 人脸 / 开户 / 首借场景采集经纬度，SDK≥1.0.6 走原生权限申请，拒绝则弹引导。该上报本身也是一个 `location` 埋点分区，按取位结果分 **success / fail** 两个事件（`utils/report.js:32-33,55`，action 为 `location.success` / `location.fail`）。是否真正触发受后台两个开关控制：`openPaylaterScanFaceSwitch`（开户刷脸场景强制上报 GPS）与 `cashLoanSceneSwitch`（首次取现场景强制上报 GPS），且需场景命中 `locationReportScenes`（`utils/report.js:64-83`）。 - **开户外部上报**（`utils/report.js:197`）：以 `category: 'paylater_open_account_tracking'` 向外部上报开户埋点。 - **锁额成功上报**（`utils/report.js:221`）：以 `eventName: 'limit_lock_amount_success'` 上报锁额（LimitUp 锁额）成功事件。

p13## 待确认 / 风险

p14- **全量事件字典**：label/category/action 完整清单未逐事件枚举，本节只列代表项与分区；完整字典由 BI 侧从代码导出维护。 - **GPS 后台开关现网取值**：`openPaylaterScanFaceSwitch`（开户刷脸）/ `cashLoanSceneSwitch`（首次取现）由后台下发于 `payLaterSetting`，前端读不到现网默认值，是否开启需后端/PM 确认。

抽出的卡片 · 13

动作条件DOC-2026-017#p12pending_review

GPS定位在KYC人脸、开户、首借场景采集经纬度；SDK≥1.0.6走原生权限申请，用户拒绝则弹出引导。

"KYC 人脸 / 开户 / 首借场景采集经纬度，SDK≥1.0.6 走原生权限申请，拒绝则弹引导。"

动作条件DOC-2026-017#p12pending_review

GPS上报是否真正触发受后台两个开关控制：openPaylaterScanFaceSwitch（开户刷脸场景强制上报GPS）、cashLoanSceneSwitch（首次取现场景强制上报GPS），且需场景命中locationReportScenes。

"是否真正触发受后台两个开关控制：`openPaylaterScanFaceSwitch`（开户刷脸场景强制上报 GPS）与 `cashLoanSceneSwitch`（首次取现场景强制上报 GPS），且需场景命中 `locationReportScenes`"

动作条件DOC-2026-017#p12pending_review

锁额（LimitUp锁额）成功时，以eventName为limit_lock_amount_success上报锁额成功事件。

"以 `eventName: 'limit_lock_amount_success'` 上报锁额（LimitUp 锁额）成功事件。"

动作条件DOC-2026-017#p12pending_review

开户外部上报以category为paylater_open_account_tracking向外部上报开户埋点。

"以 `category: 'paylater_open_account_tracking'` 向外部上报开户埋点。"

定义DOC-2026-017#p4pending_review

埋点与监控模块由三部分组成：H5 客户端行为埋点（$report.stats）、对外/风控平台事件上报、GPS 定位上报；用途为功能响应率分析、风控和合规留痕。

"H5 客户端的行为埋点（`$report.stats`）+ 对外/风控平台事件上报 + GPS 定位上报。用于功能响应率分析、风控、合规留痕。"

定义DOC-2026-017#p6pending_review

埋点通过 this.$report.stats(EVENT, extraParams?) 调用；埋点事件是包含 label、category、action 三字段的对象，action 常带占位符。

"调用：`this.$report.stats(EVENT, extraParams?)`；事件是 `{label, category, action}` 对象，`action` 常带占位符（如 `..._${term}m.click`）。"

边界DOC-2026-017#p8pending_review

弹窗曝光/关闭埋点的归属分散：问卷/挽留类弹窗（如 PAYLATER_INVESTIGATION_POPUP）在 H5 侧，部分主页/原生壳弹窗在原生侧；逐事件归属须以代码为准。

"弹窗曝光/关闭埋点部分在 H5 侧（如 `PAYLATER_INVESTIGATION_POPUP` 等问卷/挽留弹窗），部分主页/原生壳弹窗在原生侧；逐事件归属以代码为准。"

边界DOC-2026-017#p9pending_review

文档所列埋点分区表仅为代表分区，不是 constants/stats/ 目录下埋点文件的全集。

"上表为代表分区，并非 `constants/stats/` 全集。"

定义DOC-2026-017#p10pending_review

充值埋点（top-up.js）按渠道细分为 8 个分区（如 TOPUP、TOPUP_MEGA、TOPUP_INSTANT、TOPUP_DEBIT 等），每个渠道使用独立 category。

"充值，按渠道细分为 **8 个分区**（`TOPUP` / `TOPUP_MEGA` / `TOPUP_INSTANT` / `TOPUP_DEBIT` 等，每渠道独立 category）"

定义DOC-2026-017#p10pending_review

开通申请全链路埋点（pay-later-application.js）顶层共 11 个分区（顶层 key）：APPLICATION_PAYLATER、APPLICATION_PIN、APPLICATION_OCR、APPLICATION_FACE、APPLICATION_PAYLATER_FORM、APPLICATION_PDF_VIEWER、APPLICATION_UPGRADE_FORM、APPLICATION_PAYLATER_RESULT、APPLICATION_VIDEO_BANKING、APPLICATION_IOH_OTP、CHECK_APP_LIST。

"开通申请全链路，顶层共 **11 个分区（顶层 key）**：`APPLICATION_PAYLATER` / `APPLICATION_PIN` / `APPLICATION_OCR` / `APPLICATION_FACE` / `APPLICATION_PAYLATER_FORM` / `APPLICATION_PDF_VIEWER` / `APPLICATION_UPGRADE_FORM` / `APPLICATION_PAYLATER_RESULT` / `APPLICATION_VIDEO_BANKING` / `APPLICATION_IOH_OTP` / `CHECK_APP_LIST`"

边界DOC-2026-017#p10pending_review

landingpage、terms&conditions、detain、KTP、pre credit limit、face scan preparation、face detection、information、application.paylater 等属于 APPLICATION_PAYLATER 这一个顶层分区内部的 category 细分值，不是顶层分区。

"landingpage / terms&conditions / detain / KTP / pre credit limit / face scan preparation / face detection / information / application.paylater 等是 **`APPLICATION_PAYLATER` 这一个顶层分区内部的 category 细分值**，不是顶层分区"

边界DOC-2026-017#p14pending_review

全量事件字典（label/category/action 完整清单）未在本节逐事件枚举，本节只列代表项与分区；完整字典由 BI 侧从代码导出维护。

"label/category/action 完整清单未逐事件枚举，本节只列代表项与分区；完整字典由 BI 侧从代码导出维护。"

边界DOC-2026-017#p14pending_review

GPS 上报的后台开关 openPaylaterScanFaceSwitch（开户刷脸）与 cashLoanSceneSwitch（首次取现）由后台在 payLaterSetting 中下发；前端读不到现网默认值，其是否开启需后端/PM 确认。

"`openPaylaterScanFaceSwitch`（开户刷脸）/ `cashLoanSceneSwitch`（首次取现）由后台下发于 `payLaterSetting`，前端读不到现网默认值，是否开启需后端/PM 确认。"