39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
# 杜康好客 · V3 埋点规范
|
||
|
||
> 存储：C→`log_user_analytics` · 门店→`log_store_analytics` · 合伙人→`log_partner_analytics`
|
||
> 契约：`packages/shared-types/src/*-log.ts` · HQ：`/logs/users|stores|partners`
|
||
|
||
## 原则
|
||
|
||
1. 端侧 page_view/点击 → `track()`；支付/核销结果 → 后端 `AnalyticsService.track*Safe`
|
||
2. 携带 `sessionId`（`dukang_session_id`）
|
||
3. `extraJson` 无密码/令牌；手机号脱敏
|
||
4. eventName 先登记 taxonomy 再 emit
|
||
|
||
## API
|
||
|
||
| 端 | 路由 | 鉴权 |
|
||
|----|------|------|
|
||
| C | `POST /analytics/events` | OptionalJwt |
|
||
| 门店 | `POST /analytics/store-events` | Jwt+STORE |
|
||
| 合伙人 | `POST /analytics/partner-events` | Jwt+PARTNER |
|
||
| 推广 | `POST /promo/touch` | OptionalJwt（双写 touch） |
|
||
|
||
## eventName
|
||
|
||
完整清单 → `user-log.ts` / `store-log.ts` / `partner-log.ts`
|
||
|
||
## extraJson 要点
|
||
|
||
| 端 | 常用字段 |
|
||
|----|----------|
|
||
| C | sessionId, cityCode, productId, storeId, orderId, amount, pagePath, failReason |
|
||
| 门店 | redeemChannel, amount, durationMs, failReason |
|
||
| 合伙人 | storeId, orderId, billId, cityCode |
|
||
|
||
## 漏斗（摘要）
|
||
|
||
- **C**：session→home→detail→confirm→submit→pay→redeem
|
||
- **门店**：home→scan→preview→confirm
|
||
- **合伙人**：home→store_create→audit / orders→ship / bills→confirm
|