--- description: 上传Excel文件,灵活导入用户数据 --- # 用户数据导入 ## 使用方法 ### **step1:开通功能权限(项目角色成员的功能权限)** > 数据一旦导入,不可回滚,请您注意严格控制管理该功能的权限范围 ### **step2:添加用户属性到埋点计划中** > 否则会由于用户属性不在埋点计划中而导致数据无法入库 ### **step3:准备数据文件** > 数据文件须满足一定格式规范: > > 1. 文件格式:支持.xlsx 和 .xls 格式的Excel文件 > 2. 文件大小:10M以内 > 3. 内容格式规范: > > (1)表头必须包含 xwho 列,用户属性必须先加入埋点计划 > > (2)建议将单元格的“数字“格式调整为“文本”型 > > ![](https://tilnr9qbmn.feishu.cn/space/api/box/stream/download/asynccode/?code=ZTU4YjRhYjMzMDJjYTNiMzcxM2VmNjQ4MzdmYjNkNzVfTGpZSXp6UDg5VFVJRnFWUG5tTUw5YTk0dXdnZmpyQkFfVG9rZW46Ym94Y25RV2p3d2pwdlFIZTA5UVhreWswS1hlXzE2Mjk3ODEzNTg6MTYyOTc4NDk1OF9WNA) > > 由于Excel文件单元格会自带“格式“,仅当相应类型的数据单元格格式为下述情况时 ,导入数据才可被方舟系统正确识别处理,否则可能导致数据错误 > > 字符串型:文本、数值 > > 数值型:文本、数值 > > 布尔型:文本、数值 > > 日期型:文本、日期 > > 集合型:文本、数值 > > ### **step4:上传文件** > **文件上传成功,数据开始排队入库,到入库完成,有一定的时间间隔,具体时间与系统当时正在进行的各项任务有关** ### **step5:入库完成** > 入库处理完成后,会通过“消息中心“通知处理结果 ## **适用场景** **更适于:在埋点上报的基础上,进行数据增补,追加用户属性** * [ ] 主要用于增补用户属性 * [ ] 同时也支持追加“新“用户的数据(用户表中不存在的新增用户) ## 数据更新逻辑 **总体上,遵循覆盖更新逻辑,支持下述场景更新** * 追加列(新增用户属性) * 覆盖已有列(更新用户属性取值) * 追加行(新增用户:用户表中不存在的“新“用户) :warning: 注意,追加“新“用户数据时,请注意自行补充上报部分系统预置的用户属性(主要包括: $first_visit_time,、$sign_up_time、$is_login);否则影响分析功能中的预置“用户群“ ## ####