埋点需求_PC端

埋点需求_移动端

## 4.埋点事件（场景：点击、页面曝光（停留时长）、滚动列表）

### **eventName：****埋点****事件名称**

事件名称规范：事件名（做什么）+场景（在哪）+行为（怎么做）

例如：首页曝光；首页-PLAYNOW 按钮-点击，

建议用英文，例如：home_exposure、home_playnow_click

统一事件命名规范，避免埋点混乱，提升数据可分析性

  

### **params：业务参数**

公共参数：自动注入

业务参数：调用方传入

业务参数规范：建议统一前缀，例如：video_id、file_name、nas_ip

隐私数据不要收集（用户本地数据的标识）

**duration：页面停留时长**

  

/// 埋点方法实现

static func tracking(eventName: String, params: [String: Any] = [:], duration: Double = 0) {

var properties = params

  

if duration > 0 {

   properties["duration"] = duration

}

  

**// 公共参数**

if let userId = AWUserManager.shared.userID {

properties["user_id"] = String(userId)

}

properties["platform"] = "tvOS"

properties["app_version"] = AWTool.appVersion()

  

**// 业务参数**

var firebaseParams: [String: Any] = [:]

for (key, value) in properties {

firebaseParams[key] = validString(value)

}

**// firebase 上报**

**Analytics.logEvent(eventName, parameters: firebaseParams)**

}

  

**// 使用**

AWAnalyticsManager.tracking(eventName: "首页曝光", params: ["event_type": "view"], duration: duration)

埋点技术文档

## 统一约定

> 公共参数默认注入：`device_id`、`platform`、`app_version`、`os_version`、`device_model`、`network_type`、`session_id`、`user_id`（未登录场景可为空）。
>
> 页面曝光类事件统一支持可选参数：`duration`（页面停留时长，单位秒）。
>
> 侧边栏功能入口统一复用事件：`mob_home_drawer_menu_click`，通过 `menu_name` 区分具体入口。
>
> 涉及账号、设备序列号等敏感信息时，统一使用脱敏字段，如：`current_account_masked`、`device_sn_masked`。

| 事件名称          | 事件编码                                | 触发场景                  | 业务参数                                                                                                           | 公共参数   |
| ------------- | ----------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------- | ------ |
| 登录页曝光         | mob_login_page_view                 | 用户进入账号密码登录页，页面首屏完成渲染  | `referrer`、`has_history`、`history_count`、`duration`                                                            | 默认公共参数 |
| 登录按钮点击        | mob_login_submit_click              | 用户点击登录按钮发起账号密码鉴权      | `login_type`、`has_account`、`has_password`、`remember_pw_checked`                                                | 默认公共参数 |
| 登录鉴权状态        | mob_login_result                    | 登录接口返回成功/失败结果         | `success`、`error_code`、`error_msg`、`login_method`、`request_duration`                                           | 默认公共参数 |
| 设备查找页         | mob_login_device_page_view          | 用户在登录前进入设备查找/设备列表页    | `discovery_source`、`device_count`、`has_bound_device`、`last_selected_device`、`duration`                         | 默认公共参数 |
| 设备初始化页面曝光     | mob_wizard_start_page_view          | 用户首次绑定设备后进入初始化引导开始页   | `entry_source`、`is_first_init`、`device_model_code`、`duration`                                                  | 默认公共参数 |
| 设备初始化-配置远程访问  | mob_wizard_remote_service_page_view | 用户进入远程访问配置步骤页         | `default_status`、`support_remote_service`、`device_sn_masked`、`duration`                                        | 默认公共参数 |
| 设备初始化_配置存储池   | mob_wizard_storage_pool_page_view   | 用户进入存储池配置步骤页          | `disk_count`、`total_capacity`、`recommended_raid_type`、`duration`                                               | 默认公共参数 |
| 客户端首页_首页访问    | mob_home_page_view                  | 用户登录成功进入首页，或从其他页面返回首页 | `referrer`、`app_count`、`storage_usage`、`has_new_message`、`duration`                                            | 默认公共参数 |
| 客户端首页_用户头像点击  | mob_home_drawer_open_click          | 用户点击首页头像打开侧边栏         | `open_method=click_avatar`、`from_page=home`                                                                    | 默认公共参数 |
| 客户端首页_侧边栏曝光   | mob_home_drawer_view                | 侧边栏完全展开并完成渲染          | `open_method`、`menu_count`、`user_status`、`duration`                                                            | 默认公共参数 |
| 侧边栏_扫一扫按钮点击   | mob_home_drawer_menu_click          | 用户点击侧边栏“扫一扫”入口        | `menu_name=scan`、`from_page=drawer`                                                                            | 默认公共参数 |
| 扫一扫页面曝光       | mob_qrcode_scan_page_view           | 用户进入扫一扫页面             | `entry_source`、`camera_permission_status`、`duration`                                                           | 默认公共参数 |
| 侧边栏_个人设置点击    | mob_home_drawer_menu_click          | 用户点击“个人设置”入口          | `menu_name=settings`、`from_page=drawer`                                                                        | 默认公共参数 |
| 侧边栏_检查客户端更新点击 | mob_home_drawer_menu_click          | 用户点击“检查客户端更新”入口       | `menu_name=check_update`、`from_page=drawer`、`current_version`                                                  | 默认公共参数 |
| 侧边栏_检查客户端更新结果 | mob_check_update_result             | 客户端完成版本检查并返回结果        | `success`、`has_new_version`、`latest_version`、`current_version`、`error_code`、`request_duration`                 | 默认公共参数 |
| 侧边栏_清除缓存点击    | mob_home_drawer_menu_click          | 用户点击“清除缓存”入口          | `menu_name=clear_cache`、`from_page=drawer`、`cache_size_mb`                                                     | 默认公共参数 |
| 侧边栏_清除缓存结果    | mob_clear_cache_result              | 缓存清理动作执行完成并返回结果       | `success`、`before_cache_size_mb`、`cleared_cache_size_mb`、`after_cache_size_mb`、`error_code`、`request_duration` | 默认公共参数 |
| 侧边栏_日志导出点击    | mob_home_drawer_menu_click          | 用户点击“日志导出”入口          | `menu_name=export_log`、`from_page=drawer`、`log_range`                                                          | 默认公共参数 |
| 侧边栏_日志导出结果    | mob_log_export_result               | 日志导出完成，生成文件或导出失败      | `success`、`log_range`、`export_target`、`file_size_mb`、`error_code`、`request_duration`                           | 默认公共参数 |
| 侧边栏_用户隐私点击    | mob_home_drawer_menu_click          | 用户点击“用户隐私/隐私政策”入口     | `menu_name=privacy_policy`、`from_page=drawer`                                                                  | 默认公共参数 |
| 侧边栏_帮助中心点击    | mob_home_drawer_menu_click          | 用户点击“帮助中心”入口          | `menu_name=help_center`、`from_page=drawer`                                                                     | 默认公共参数 |
| 侧边栏_联系我们点击    | mob_home_drawer_menu_click          | 用户点击“联系我们”入口          | `menu_name=contact_us`、`from_page=drawer`                                                                      | 默认公共参数 |
| 侧边栏_切换账号点击    | mob_switch_account_click            | 用户点击切换账号并进入账号选择/登录流程  | `from_page=drawer`、`account_count`、`current_account_masked`                                                    | 默认公共参数 |
| 侧边栏_退出登录点击    | mob_home_drawer_menu_click          | 用户点击“退出登录”入口，拉起确认弹窗   | `menu_name=logout`、`from_page=drawer`、`need_confirm=true`                                                      | 默认公共参数 |
| 侧边栏_退出登录结果    | mob_logout_result                   | 用户确认退出登录后，退出流程完成并返回结果 | `success`、`logout_type`、`session_duration`、`error_code`、`request_duration`                                     | 默认公共参数 |

## 结果事件补充说明

| 事件编码                      | 建议触发时机            | 说明                      |
| ------------------------- | ----------------- | ----------------------- |
| `mob_check_update_result` | 版本检查接口返回后         | 用于统计检查更新成功率、新版本命中率、接口耗时 |
| `mob_clear_cache_result`  | 清缓存动作完成后          | 用于统计缓存清理成功率、人均清理容量      |
| `mob_log_export_result`   | 导出成功生成文件或失败回调时    | 用于统计日志导出成功率、导出目标偏好      |
| `mob_logout_result`       | 退出登录接口返回/本地态清理完成后 | 用于统计退出成功率、会话时长          |

## 落地备注

1. 若当前埋点 SDK 不支持自动采集 `duration`，建议在页面 `onShow/onHide` 或 `viewDidAppear/viewDidDisappear` 中自行计算。
2. `request_duration` 建议统一单位为毫秒，`duration` 统一单位为秒，避免混淆。
3. `error_code` 仅记录系统定义错误码，不记录包含隐私信息的服务端原始报文。
4. 如需进一步落地，可继续拆成“事件字典 + 参数枚举 + 触发位置 + 验收口径”四列表。


移动端埋点

## 统一约定

> 公共参数默认注入：`device_id`、`platform`、`app_version`、`os_version`、`os_type`、`device_model`、`network_type`、`screen_resolution`、`session_id`、`user_id`（未登录场景可为空）。
>
> 页面曝光类事件统一支持可选参数：`duration`（页面停留时长，单位秒）。
>
> 任务栏功能入口统一复用事件：`pc_taskbar_item_click`，通过 `item_name` 区分具体入口。
>
> 桌面菜单点击统一复用事件：`pc_desktop_menu_click`，通过 `menu_name` 区分具体入口。
>
> 桌面信息卡片点击统一复用事件：`pc_desktop_card_click`，通过 `card_name` 区分卡片类型。
>
> 涉及账号、设备序列号等敏感信息时，统一使用脱敏字段，如：`current_account_masked`、`device_sn_masked`。

| 事件名称 | 事件编码 | 触发场景 | 业务参数 | 公共参数 |
|---|---|---|---|---|
| 登录页曝光 | pc_login_page_view | 用户打开客户端或会话过期进入登录页，页面首屏完成渲染 | `referrer`、`has_history_account`、`default_login_type`、`duration` | 默认公共参数 |
| 登录按钮点击 | pc_login_submit_click | 用户填写完账号密码点击登录 | `has_account`、`has_password`、`remember_pw_checked`、`auto_login_checked` | 默认公共参数 |
| 登录鉴权状态 | pc_login_result | 登录接口返回成功/失败结果 | `success`、`error_code`、`error_msg`、`login_method`、`request_duration` | 默认公共参数 |
| 设备查找页 | pc_login_device_page_view | 用户在登录前进入设备查找/设备列表页 | `discovery_source`、`device_count`、`has_bound_device`、`last_selected_device`、`duration` | 默认公共参数 |
| 设备初始化页面曝光 | pc_wizard_start_page_view | 用户首次绑定设备后进入初始化引导开始页 | `entry_source`、`is_first_init`、`device_model_code`、`duration` | 默认公共参数 |
| 设备初始化-配置远程访问 | pc_wizard_remote_service_page_view | 用户进入远程访问配置步骤页 | `default_status`、`support_remote_service`、`device_sn_masked`、`duration` | 默认公共参数 |
| 设备初始化_配置存储池 | pc_wizard_storage_pool_page_view | 用户进入存储池配置步骤页 | `disk_count`、`total_capacity`、`recommended_raid_type`、`duration` | 默认公共参数 |
| 桌面首页访问 | pc_desktop_page_view | 用户登录成功进入桌面首页，或从其他页面返回桌面 | `referrer`、`widget_count`、`wallpaper_type`、`desktop_mode`、`duration` | 默认公共参数 |
| 任务栏_回到桌面按钮点击 | pc_taskbar_item_click | 用户点击任务栏“回到桌面”按钮 | `item_name=show_desktop`、`from_page`、`window_count` | 默认公共参数 |
| 任务栏_应用抽屉按钮点击 | pc_taskbar_item_click | 用户点击任务栏“应用抽屉”按钮 | `item_name=apps_drawer`、`from_page` | 默认公共参数 |
| 任务栏_文件管理按钮点击 | pc_taskbar_item_click | 用户点击任务栏“文件管理”按钮 | `item_name=file_manager`、`from_page` | 默认公共参数 |
| 任务栏_资源管理按钮点击 | pc_taskbar_item_click | 用户点击任务栏“资源管理”按钮 | `item_name=resource_manager`、`from_page` | 默认公共参数 |
| 任务栏_用户头像点击 | pc_taskbar_item_click | 用户点击任务栏用户头像/账户入口 | `item_name=user_avatar`、`from_page`、`current_account_masked` | 默认公共参数 |
| 任务栏_关闭窗口按钮点击 | pc_taskbar_item_click | 用户点击当前窗口关闭按钮 | `item_name=close_window`、`window_type`、`window_count` | 默认公共参数 |
| 任务栏_最小化窗口按钮点击 | pc_taskbar_item_click | 用户点击当前窗口最小化按钮 | `item_name=minimize_window`、`window_type`、`window_count` | 默认公共参数 |
| 任务栏_最大化窗口按钮点击 | pc_taskbar_item_click | 用户点击当前窗口最大化按钮 | `item_name=maximize_window`、`window_type`、`window_count` | 默认公共参数 |
| 桌面首页_设备信息卡片点击 | pc_desktop_card_click | 用户点击桌面首页设备信息卡片 | `card_name=device_info`、`position`、`device_status` | 默认公共参数 |
| 桌面首页_资源监控信息卡片点击 | pc_desktop_card_click | 用户点击桌面首页资源监控卡片 | `card_name=resource_monitor`、`position`、`resource_type` | 默认公共参数 |
| 桌面首页_存储卡片点击 | pc_desktop_card_click | 用户点击桌面首页存储卡片 | `card_name=storage`、`position`、`storage_usage` | 默认公共参数 |
| 桌面首页_影视卡片点击 | pc_desktop_card_click | 用户点击桌面首页影视卡片 | `card_name=media`、`position`、`content_count` | 默认公共参数 |
| 桌面首页_相册卡片点击 | pc_desktop_card_click | 用户点击桌面首页相册卡片 | `card_name=album`、`position`、`photo_count` | 默认公共参数 |
| 桌面首页_常用应用卡片内应用点击 | pc_desktop_app_click | 用户点击桌面首页常用应用卡片中的应用 | `source_card=favorite_apps`、`app_id`、`app_name`、`position` | 默认公共参数 |
| 桌面首页_编辑常用应用按钮点击 | pc_desktop_common_apps_edit_click | 用户点击编辑常用应用按钮 | `current_app_count`、`from_page=desktop_home` | 默认公共参数 |
| 桌面首页_编辑常用应用弹窗曝光 | pc_desktop_common_apps_edit_popup_view | 用户打开编辑常用应用弹窗 | `current_app_count`、`recommended_app_count`、`duration` | 默认公共参数 |
| 桌面首页_常用最近安装应用卡片内应用点击 | pc_desktop_app_click | 用户点击最近安装应用卡片中的应用 | `source_card=recent_installed_apps`、`app_id`、`app_name`、`position` | 默认公共参数 |
| 桌面首页_桌面菜单曝光 | pc_desktop_context_menu_view | 用户在桌面空白区右键打开桌面菜单 | `menu_count`、`entry_method=right_click`、`duration` | 默认公共参数 |
| 桌面菜单_编辑桌面按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“编辑桌面” | `menu_name=edit_desktop`、`from_page=desktop_menu` | 默认公共参数 |
| 桌面菜单_个性化按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“个性化” | `menu_name=personalization`、`from_page=desktop_menu` | 默认公共参数 |
| 桌面菜单_客户端设置按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“客户端设置” | `menu_name=settings`、`from_page=desktop_menu` | 默认公共参数 |
| 桌面菜单_设备重启按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“设备重启”并拉起确认流程 | `menu_name=reboot_device`、`from_page=desktop_menu`、`need_confirm=true` | 默认公共参数 |
| 桌面菜单_设备重启结果 | pc_device_power_action_result | 设备重启请求返回结果 | `action=reboot`、`success`、`error_code`、`request_duration` | 默认公共参数 |
| 桌面菜单_设备关机按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“设备关机”并拉起确认流程 | `menu_name=shutdown_device`、`from_page=desktop_menu`、`need_confirm=true` | 默认公共参数 |
| 桌面菜单_设备关机结果 | pc_device_power_action_result | 设备关机请求返回结果 | `action=shutdown`、`success`、`error_code`、`request_duration` | 默认公共参数 |
| 桌面菜单_退出登录按钮点击 | pc_desktop_menu_click | 用户点击桌面菜单“退出登录”并拉起确认流程 | `menu_name=logout`、`from_page=desktop_menu`、`need_confirm=true` | 默认公共参数 |
| 桌面菜单_退出登录结果 | pc_logout_result | 用户确认退出登录后，退出流程完成并返回结果 | `success`、`logout_type`、`session_duration`、`error_code`、`request_duration` | 默认公共参数 |
| 应用抽屉页曝光 | pc_apps_page_view | 用户进入所有应用页面（桌面应用抽屉） | `default_category`、`app_count`、`entry_source`、`duration` | 默认公共参数 |
| 桌面编辑态页面曝光 | pc_desktop_edit_page_view | 用户进入桌面编辑态页面 | `widget_count`、`editable_widget_count`、`duration` | 默认公共参数 |
| 客户端设置页曝光 | pc_settings_page_view | 用户进入客户端设置页 | `default_tab`、`entry_source`、`duration` | 默认公共参数 |
| 客户端设置保存结果 | pc_settings_save_result | 用户保存客户端设置后返回结果 | `success`、`modified_count`、`modified_tabs`、`error_code`、`request_duration` | 默认公共参数 |
| 桌面组件添加点击 | pc_desktop_widget_add_click | 用户点击添加桌面组件 | `widget_type`、`entry_source`、`current_widget_count` | 默认公共参数 |
| 桌面组件拖拽完成 | pc_desktop_widget_drag_complete | 用户拖拽调整桌面组件位置完成 | `widget_type`、`from_position`、`to_position`、`layout_mode` | 默认公共参数 |

## 结果事件补充说明

| 事件编码 | 建议触发时机 | 说明 |
|---|---|---|
| `pc_device_power_action_result` | 设备重启/关机接口返回后 | 用于统计高风险操作成功率、失败原因、接口耗时 |
| `pc_logout_result` | 退出登录接口返回/本地态清理完成后 | 用于统计退出成功率、会话时长 |
| `pc_settings_save_result` | 设置保存接口返回/本地配置写入完成后 | 用于统计设置保存成功率、失败率和耗时 |

## 落地备注

1. 若当前埋点 SDK 不支持自动采集 `duration`，建议在页面 `show/hide` 或 `focus/blur` 生命周期中自行计算。
2. `request_duration` 建议统一单位为毫秒，`duration` 统一单位为秒，避免混淆。
3. `error_code` 仅记录系统定义错误码，不记录包含隐私信息的服务端原始报文。
4. `position` 建议统一约定：卡片类用序号，桌面组件类用网格坐标，如 `2,1`。
5. 如后续补充任务栏更多能力，建议继续复用 `pc_taskbar_item_click`，仅扩展 `item_name` 枚举值即可。


1. 需求基本信息

1. 需求基本信息

4.埋点事件（场景：点击、页面曝光（停留时长）、滚动列表）

**eventName：

统一约定

统一约定