1. 需求基本信息

字段	说明
需求名称	移动端 NAS 客户端埋点需求
需求编号	BD-2026-002
所属项目	NAS 客户端
提出部门	产品部
负责人	Jerry
创建日期	2026-03-27
上线日期	[待确认]
优先级	P 0
状态	待评审

---

2. 需求背景

项目	说明
业务场景	移动端NAS客户端全链路用户行为数据采集，覆盖从开屏、登录、使用到设置的完整用户旅程
数据用途	用户行为分析、功能效果评估、业务决策支持、产品优化迭代、运营活动监控、转化率分析
预期收益	1. 了解移动端用户使用习惯，优化产品路径 2. 监控核心功能转化率，识别产品瓶颈 3. 支撑精细化运营策略制定 4. 提升用户留存和活跃度

---

3. 埋点事件列表

3.1 事件总览

事件编码	事件名称	触发场景	触发时机	优先级
mob_splash_page_view	开屏页访问	用户打开APP进入开屏页	页面加载完成	P 0
mob_splash_skip_click	开屏页跳过点击	用户点击跳过开屏广告/引导	点击时	P 1
mob_initializing_page_view	初始化页访问	开屏后进入初始化加载页	页面加载完成	P 0
mob_login_page_view	登录页访问	用户进入账号密码登录页	页面加载完成	P 0
mob_login_submit_click	登录按钮点击	用户点击账号密码登录按钮	点击时	P 0
mob_login_result	登录结果返回	登录接口返回结果	接口返回时	P 0
mob_login_qrcode_tab_switch	扫码登录标签切换	用户切换到扫码登录标签	点击切换时	P 0
mob_login_qrcode_scan_click	扫码登录扫一扫点击	用户点击扫一扫按钮扫描登录二维码	点击时	P 0
mob_login_history_click	历史账号点击	用户点击登录历史账号	点击时	P 1
mob_login_history_delete_click	历史账号删除点击	用户删除登录历史账号	点击时	P 1
mob_home_page_view	首页访问	用户登录后进入首页	页面加载完成时	P 0
mob_home_drawer_open_click	侧边栏打开点击	用户点击打开侧边导航抽屉	点击时	P 1
mob_home_drawer_menu_click	侧边栏菜单点击	用户点击侧边栏菜单项	点击时	P 0
mob_home_app_click	首页应用点击	用户点击首页常用应用	点击时	P 0
mob_home_edit_click	首页编辑点击	用户点击编辑首页按钮	点击时	P 1
mob_all_apps_page_view	全部应用页访问	用户进入全部应用列表页	页面加载完成	P 0
mob_all_apps_card_click	应用卡片点击	用户点击应用卡片打开应用	点击时	P 0
mob_all_apps_search_input	应用搜索	用户在应用列表搜索应用	触发搜索时	P 1
mob_all_apps_category_switch	应用分类切换	用户切换应用分类标签	点击切换时	P 1
mob_manage_apps_page_view	应用管理页访问	用户进入应用管理页	页面加载完成	P 1
mob_manage_apps_uninstall_click	应用卸载点击	用户点击卸载应用	点击时	P 0
mob_manage_apps_update_click	应用更新点击	用户点击更新应用	点击时	P 1
mob_settings_page_view	设置页访问	用户进入个人设置页	页面加载完成	P 0
mob_settings_item_click	设置项点击	用户点击设置页各个功能项	点击时	P 0
mob_change_password_submit_click	修改密码提交	用户提交修改密码请求	点击提交时	P 0
mob_basic_info_save_click	基本信息保存	用户保存个人基本信息修改	点击保存时	P 1
mob_switch_account_click	切换账号点击	用户点击切换账号	点击时	P 0
mob_logout_confirm_click	登出确认点击	用户确认登出账号	点击确认时	P 0
mob_user_agreement_view	用户协议查看	用户查看用户协议/隐私政策	页面加载完成	P 1
mob_contact_us_view	联系我们页面访问	用户进入联系我们页	页面加载完成	P 1
mob_wizard_start_page_view	初始化引导开始页访问	用户首次启动APP进入引导流程	页面加载完成	P0
mob_wizard_storage_pool_page_view	存储池创建页访问	用户进入创建存储池引导页	页面加载完成	P0
mob_wizard_storage_pool_submit	存储池创建提交	用户提交存储池创建请求	点击提交时	P0
mob_wizard_admin_account_page_view	管理员账号创建页访问	用户进入创建管理员账号引导页	页面加载完成	P0
mob_wizard_admin_account_submit	管理员账号创建提交	用户提交管理员账号创建	点击提交时	P0
mob_wizard_remote_service_page_view	远程服务设置页访问	用户进入远程服务设置引导页	页面加载完成	P0
mob_remote_service_toggle	远程服务开关切换	用户开启/关闭远程访问服务	点击开关时	P0
mob_wizard_finish_page_view	引导完成页访问	所有初始化引导完成进入完成页	页面加载完成	P0
mob_home_edit_click	首页编辑点击	用户点击编辑首页按钮	点击时	P1
mob_home_widget_add_click	首页组件添加点击	用户在首页编辑页添加组件	点击添加时	P1
mob_home_widget_remove_click	首页组件移除点击	用户在首页编辑页移除组件	点击移除时	P1
mob_home_widget_sort_complete	首页组件排序完成	用户拖拽排序首页组件完成	拖拽结束时	P1
mob_home_edit_save_click	首页编辑保存点击	用户保存首页编辑修改	点击保存时	P1
mob_basic_info_page_view	基本信息页访问	用户进入系统基本信息详情页	页面加载完成	P1
mob_search_loading_show	搜索加载状态展示	用户搜索时出现加载中状态	加载状态出现时	P1
mob_qrcode_scan_page_view	扫码页访问	用户进入二维码扫描页	页面加载完成	P1
mob_qrcode_scan_result	扫码结果返回	扫描二维码完成	扫描成功时	P1
mob_search_input	全局搜索	用户在全局搜索框输入搜索	触发搜索时	P1
mob_login_device_page_view	登录设备列表页访问	用户进入登录设备管理页	页面加载完成	P1
mob_login_device_delete_click	登录设备删除点击	用户删除登录设备	点击删除时	P0
mob_popup_show	弹窗展示	任意弹窗展示时	弹窗出现时	P1
mob_popup_button_click	弹窗按钮点击	用户点击弹窗上的按钮	点击时	P1

3.2 事件详情

开屏&初始化事件

事件：mob_splash_page_view

字段	值
事件编码	mob_splash_page_view
事件名称	开屏页访问
触发场景	用户冷启动APP或从后台唤醒进入开屏页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	开屏页组件生命周期onShow
上报频率	每次冷启动/唤醒上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
splash_type	开屏类型	string	是	welcome/advertisement/guide	"welcome"
duration	开屏时长	number	否	开屏页展示时长（秒）	3

事件：mob_splash_skip_click

字段	值
事件编码	mob_splash_skip_click
事件名称	开屏页跳过点击
触发场景	用户点击跳过开屏页按钮
触发时机	点击时
上报时机	立即上报
埋点位置	跳过按钮click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
stay_duration	停留时长	number	是	用户在开屏页停留时长（秒）	1.5

事件：mob_initializing_page_view

字段	值
事件编码	mob_initializing_page_view
事件名称	初始化页访问
触发场景	开屏结束后进入系统初始化加载页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	初始化页组件onShow
上报频率	每次启动上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
init_duration	初始化时长	number	否	系统初始化总时长（秒）	5.2
init_success	是否初始化成功	boolean	是	true/false	true

---

登录页事件

事件：mob_login_page_view

字段	值
事件编码	mob_login_page_view
事件名称	登录页访问
触发场景	用户进入账号密码登录页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	登录页组件onShow
上报频率	每次进入上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
referrer	来源页面	string	否	跳转来源页面标识	"initializing"
has_history	是否有登录历史	boolean	是	true/false	true
history_count	历史账号数量	number	否	登录历史账号个数	2

事件：mob_login_submit_click

字段	值
事件编码	mob_login_submit_click
事件名称	登录按钮点击
触发场景	用户填写完账号密码点击登录
触发时机	点击登录按钮时
上报时机	立即上报
埋点位置	登录按钮click事件
上报频率	每次点击都上报，3秒内重复点击去重

属性编码	属性名称	类型	必填	取值说明	示例值
has_account	是否输入账号	boolean	是	true/false	true
has_password	是否输入密码	boolean	是	true/false	true
remember_pw_checked	是否勾选记住密码	boolean	是	true/false	false
login_type	登录方式	string	是	account_password/history_account	"account_password"

事件：mob_login_result

字段	值
事件编码	mob_login_result
事件名称	登录结果返回
触发场景	登录接口返回结果
触发时机	接口请求完成时
上报时机	立即上报
埋点位置	登录接口回调函数
上报频率	每次请求完成上报

属性编码	属性名称	类型	必填	取值说明	示例值
success	是否登录成功	boolean	是	true/false	false
error_code	错误码	string	否	登录失败时返回错误码	"ACCOUNT_NOT_EXIST"
error_msg	错误信息	string	否	失败时返回的错误描述	"账号不存在"
login_method	登录方式	string	是	password/qrcode	"password"

事件：mob_login_qrcode_tab_switch

字段	值
事件编码	mob_login_qrcode_tab_switch
事件名称	扫码登录标签切换
触发场景	用户从账号密码登录切换到扫码登录
触发时机	点击标签时
上报时机	立即上报
埋点位置	标签切换click事件
上报频率	每次切换上报

属性编码	属性名称	类型	必填	取值说明	示例值
from_tab	原标签	string	是	password/qrcode	"password"
to_tab	目标标签	string	是	password/qrcode	"qrcode"

事件：mob_login_qrcode_scan_click

字段	值
事件编码	mob_login_qrcode_scan_click
事件名称	扫码登录扫一扫点击
触发场景	用户点击扫码登录页的扫一扫按钮
触发时机	点击按钮时
上报时机	立即上报
埋点位置	扫一扫按钮click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
permission_granted	是否授权相机权限	boolean	是	true/false	true

事件：mob_login_history_click

字段	值
事件编码	mob_login_history_click
事件名称	历史账号点击
触发场景	用户点击登录历史中的账号快速填充
触发时机	点击账号时
上报时机	立即上报
埋点位置	历史账号item click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
account	账号	string	是	脱敏后的账号	"138****1234"
last_login_days	上次登录天数	number	否	距离上次登录的天数	7

---

首页事件

事件：mob_home_page_view

字段	值
事件编码	mob_home_page_view
事件名称	首页访问
触发场景	用户登录成功进入首页，或从其他页面返回首页
触发时机	页面加载完成/onShow
上报时机	立即上报
埋点位置	首页组件onShow生命周期
上报频率	每次进入上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
referrer	来源页面	string	否	跳转来源页面	"login"
app_count	首页应用数量	number	是	首页展示的常用应用个数	8
storage_usage	存储使用率	number	是	存储池已使用百分比	65

事件：mob_home_drawer_open_click

字段	值
事件编码	mob_home_drawer_open_click
事件名称	侧边栏打开点击
触发场景	用户点击左上角头像或右滑打开侧边导航抽屉
触发时机	侧边栏完全展开时
上报时机	立即上报
埋点位置	侧边栏展开回调
上报频率	每次打开上报

属性编码	属性名称	类型	必填	取值说明	示例值
open_method	打开方式	string	是	click_avatar/swipe	"click_avatar"

事件：mob_home_drawer_menu_click

字段	值
事件编码	mob_home_drawer_menu_click
事件名称	侧边栏菜单点击
触发场景	用户点击侧边栏中的菜单项
触发时机	点击时
上报时机	立即上报
埋点位置	菜单项click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
menu_name	菜单名称	string	是	home/all_apps/manage_apps/settings/storage_manager/help_center/about	"settings"

事件：mob_home_app_click

字段	值
事件编码	mob_home_app_click
事件名称	首页应用点击
触发场景	用户点击首页的常用应用卡片
触发时机	点击时
上报时机	立即上报
埋点位置	应用卡片click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
app_id	应用ID	string	是	应用唯一标识	"com.cloud.drive"
app_name	应用名称	string	是	应用中文名称	"云盘"
position	位置	number	是	应用在首页的位置序号，从1开始	3

---

应用相关事件

事件：mob_all_apps_page_view

字段	值
事件编码	mob_all_apps_page_view
事件名称	全部应用页访问
触发场景	用户进入全部应用列表页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	全部应用页onShow
上报频率	每次进入上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
default_category	默认分类	string	是	all/installed/recommend/system	"installed"
app_count	应用总数	number	是	当前分类下应用数量	12

事件：mob_all_apps_card_click

字段	值
事件编码	mob_all_apps_card_click
事件名称	应用卡片点击
触发场景	用户点击全部应用列表中的应用卡片
触发时机	点击时
上报时机	立即上报
埋点位置	应用卡片click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
app_id	应用ID	string	是	应用唯一标识	"com.cloud.drive"
app_name	应用名称	string	是	应用中文名称	"云盘"
category	当前分类	string	是	all/installed/recommend/system	"installed"
position	位置	number	是	应用在列表中的位置序号	5

事件：mob_manage_apps_page_view

字段	值
事件编码	mob_manage_apps_page_view
事件名称	应用管理页访问
触发场景	用户进入应用管理页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	应用管理页onShow
上报频率	每次进入上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
installed_count	已安装应用数	number	是	当前已安装应用数量	15
updatable_count	可更新应用数	number	是	有可用更新的应用数量	3

---

设置相关事件

事件：mob_settings_page_view

字段	值
事件编码	mob_settings_page_view
事件名称	设置页访问
触发场景	用户进入个人设置页
触发时机	页面加载完成
上报时机	立即上报
埋点位置	设置页onShow
上报频率	每次进入上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
referrer	来源页面	string	否	跳转来源页面	"home_drawer"

事件：mob_settings_item_click

字段	值
事件编码	mob_settings_item_click
事件名称	设置项点击
触发场景	用户点击设置页的功能项
触发时机	点击时
上报时机	立即上报
埋点位置	设置项click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
item_name	设置项名称	string	是	basic_info/change_password/security/remote_access/storage/notification/about/contact_us/user_agreement/switch_account/logout	"change_password"

事件：mob_logout_confirm_click

字段	值
事件编码	mob_logout_confirm_click
事件名称	登出确认点击
触发场景	用户在登出确认弹窗中点击确认
触发时机	点击确认时
上报时机	立即上报
埋点位置	登出确认按钮click事件
上报频率	每次点击上报

属性编码	属性名称	类型	必填	取值说明	示例值
session_duration	会话时长	number	是	本次登录会话时长（分钟）	45.5

---

初始化引导流程事件

事件：mob_wizard_start_page_view

字段	值
事件编码	mob_wizard_start_page_view
事件名称	初始化引导开始页访问
触发场景	用户首次启动APP进入引导流程
触发时机	页面加载完成
上报时机	立即上报
埋点位置	引导开始页组件onShow
上报频率	每台设备仅上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
device_model	设备型号	string	是	手机型号	"iPhone 15 Pro"
os_version	系统版本	string	是	移动操作系统版本	"iOS 17.4"

事件：mob_wizard_storage_pool_submit

字段	值
事件编码	mob_wizard_storage_pool_submit
事件名称	存储池创建提交
触发场景	用户提交存储池创建配置
触发时机	点击提交按钮时
上报时机	立即上报
埋点位置	提交按钮click事件
上报频率	每次提交上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
raid_type	RAID类型	string	是	single/jbod/raid0/raid1/raid5	"raid1"
selected_disk_count	选择磁盘数	number	是	用户选择的磁盘数量	2
pool_capacity	存储池容量	number	是	创建的存储池容量（GB）	4096
success	是否提交成功	boolean	是	true/false	true

事件：mob_wizard_admin_account_submit

字段	值
事件编码	mob_wizard_admin_account_submit
事件名称	管理员账号创建提交
触发场景	用户提交管理员账号信息
触发时机	点击提交按钮时
上报时机	立即上报
埋点位置	提交按钮click事件
上报频率	每次提交上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
has_email	是否填写邮箱	boolean	是	true/false	true
password_strength	密码强度	string	是	weak/medium/strong	"strong"
success	是否创建成功	boolean	是	true/false	true

事件：mob_remote_service_toggle

字段	值
事件编码	mob_remote_service_toggle
事件名称	远程服务开关切换
触发场景	用户开启/关闭远程访问服务
触发时机	点击开关按钮时
上报时机	立即上报
埋点位置	开关组件change事件
上报频率	每次切换上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
action	操作类型	string	是	enable/disable	"enable"
success	是否操作成功	boolean	是	true/false	true

---

首页编辑事件

事件：mob_home_edit_click

字段	值
事件编码	mob_home_edit_click
事件名称	首页编辑点击
触发场景	用户点击编辑首页按钮
触发时机	点击按钮时
上报时机	立即上报
埋点位置	编辑按钮click事件
上报频率	每次点击上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
current_widget_count	当前组件数量	number	是	编辑前首页组件数量	6

事件：mob_home_widget_add_click

字段	值
事件编码	mob_home_widget_add_click
事件名称	首页组件添加点击
触发场景	用户在首页编辑页添加组件
触发时机	点击添加按钮时
上报时机	立即上报
埋点位置	添加组件按钮click事件
上报频率	每次添加上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
widget_type	组件类型	string	是	weather/calendar/storage_monitor/recent_files/quick_app	"storage_monitor"
success	是否添加成功	boolean	是	true/false	true

事件：mob_home_edit_save_click

字段	值
事件编码	mob_home_edit_save_click
事件名称	首页编辑保存点击
触发场景	用户保存首页编辑修改
触发时机	点击保存按钮时
上报时机	立即上报
埋点位置	保存按钮click事件
上报频率	每次保存上报1次

属性编码	属性名称	类型	必填	取值说明	示例值
modified_count	修改数量	number	是	本次编辑修改的组件数量	3
after_widget_count	保存后组件数量	number	是	保存后首页组件总数	7

---

4. 公共属性

属性编码	属性名称	类型	说明
user_id	用户ID	string	当前登录用户的唯一标识
device_id	设备ID	string	移动设备唯一标识
platform	平台	string	iOS/Android
app_version	应用版本号	string	移动端APP版本号
os_version	系统版本	string	移动操作系统版本
device_model	设备型号	string	手机型号
network_type	网络类型	string	wifi/4g/5g/offline
screen_resolution	屏幕分辨率	string	移动端屏幕宽高

---

5. 数据需求

项目	说明
用户范围	所有移动端用户
时间范围	上线后永久采集
环境范围	生产/测试/灰度环境
预计日 PV/UV	PV:10万/天，UV:2万/天
预计日事件数	50万/天
数据保留期限	180天，聚合数据永久保留

---

6. 技术实施要求

项目	说明
iOS SDK	[版本号]
Android SDK	[版本号]
特殊要求	1. 离线缓存：无网络时缓存数据，网络恢复后补发 2. 数据加密：传输过程加密，本地存储加密 3. 隐私合规：符合《个人信息保护法》要求
兼容性要求	iOS 13+，Android 10+

---

7. 测试验收标准

检查项	功能测试	数据验证	性能要求
事件触发时机正确	☐
事件属性值准确	☐
公共属性正确携带	☐
异常场景处理正常	☐
数据上报成功率 ≥ 99%		☐
数据准确性验证通过		☐
数据完整性验证通过		☐
无重复上报		☐
上报延迟 < 300 ms			☐
对APP性能无明显影响			☐
离线缓存功能正常	☐

---

8. 隐私合规

检查项	说明	状态
用户授权	是否已获取用户数据采集授权	☐ 已通过
隐私政策	是否已在隐私政策中说明数据采集范围和用途	☐ 已通过
数据脱敏	敏感数据（手机号、密码等）是否已脱敏处理	☐ 已通过
权限申请	相机、存储等权限是否按最小必要原则申请	☐ 已通过

---

9. 变更记录

版本	日期	变更人	变更内容
v 1.0	2026-03-27	Claudian	初始版本，完成移动端10+页面共42个埋点事件需求整理，覆盖全用户旅程
v1.1	2026-03-27	Claudian	新增初始化引导流程、首页编辑、基本信息等模块，共新增12个埋点事件，完全覆盖全部UI设计稿所有场景

---

10. 附录

相关文档

• [[我的笔记/NAS需求文档/Launcher/移动端产品需求文档.md]]
• [[我的笔记/NAS需求文档/埋点管理/埋点数据字典.md]]
• 视觉稿文件夹

相关人员

角色	姓名	联系方式
产品经理	Jerry
数据分析师
iOS开发
Android开发
测试工程师

---

注意事项：

1. 事件编码采用小写字母+下划线，前缀统一为mob_
2. 属性编码同样采用小写字母+下划线
3. 所有枚举值需在"取值说明"中详细列出
4. 涉及用户隐私的数据必须脱敏处理，禁止采集明文手机号、密码等敏感信息
5. 埋点实现需遵循隐私合规要求，未获得用户授权前禁止采集任何数据