> For the complete documentation index, see [llms.txt](https://arkdocs.analysys.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arkdocs.analysys.cn/features/project-manegement/data-integration/import-profile.md).

# 用户数据导入

## 使用方法

### **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）；否则影响分析功能中的预置“用户群“

##

####