编辑
2026-08-19
undefined
00
请注意,本文编写于 59 天前,最后修改于 59 天前,其中某些信息可能已经过时。

目录

统一约定
结果事件补充说明
落地备注

统一约定

公共参数默认注入: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. 如需进一步落地,可继续拆成“事件字典 + 参数枚举 + 触发位置 + 验收口径”四列表。

本文作者:oyph

本文链接:

版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!