# 用户数据导入

## 使用方法

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

##

####


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://arkdocs.analysys.cn/features/project-manegement/data-integration/import-profile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.