# Doodle Mini 埋点事件字典

> 更新日期：2026-09-24。事件名和字段名须先在微信小程序后台注册，再随版本发布。

## 通用字段

所有事件自动携带 `count`、`date_time`、`uuid`、`page_name`。内容事件使用稳定的 `worksheet_id`，而非可变的展示标题；可选字段包括 `worksheet_title`、`mode`、`source`、`category_id`、`export_id`、`duration_ms`、`fail_reason`。

| 事件 | 含义 | 触发时机 |
| --- | --- | --- |
| `page_view` | 页面浏览 | 首页、分类页首次进入 |
| `worksheet_click` | 点击某张练习纸 | 首页或分类列表点击有效内容 |
| `preview_view` | 打开或切换练习纸预览 | 练习纸页面初始化或切换题型 |
| `generate_start` | 开始生成 | 初始随机生成或点击“换一张” |
| `generate_success` / `generate_fail` | 生成结果 | Canvas 绘制结束；包含耗时和失败原因 |
| `export_click` | 点击保存 | 调用相册保存前 |
| `export_success` / `export_fail` | 导出结果 | 仅以相册保存 API 的结果为准 |
| `favorite_add` / `favorite_remove` | 收藏变化 | 云端收藏操作成功后 |
| `share_click` | 发起分享 | 调起小程序分享时 |

## 导出判定

`export_click` 不能作为下载量或转化。只有 `wx.saveImageToPhotosAlbum` 返回成功时才触发 `export_success`，并在同一时机递增本地下载配额、写入下载历史和更新内容下载量。

每次导出会生成 `export_id`。云端以 `userId + exportId` 去重，因此同一次保存的网络重试不会重复写下载历史或重复增加 `worksheets.downloads`。