用 CSV 文件导入联系人
上传 CSV、对应字段、说明营销订阅同意的来源,并看懂导入结果,包括无效、重复和已退订的行会怎么处理。
更新于 2026年10月22日
如果你的客户或订阅者名单在表格里、在其他邮件平台里,或者是店铺导出的文件,都可以用 CSV 导入 EterMail。你可以决定每一列对应什么字段,也可以决定这些人只作为联系人保存,还是同时订阅营销邮件。
这个选择很重要:只有已订阅的联系人才会收到营销活动和自动化邮件。所以 EterMail 会请你说明这些人的同意从哪里来,并把这段说明作为证据保存。
1. 打开导入页面
在左侧导航打开订阅联系人,点击导入 CSV。

文件需要满足:
- UTF-8 编码(多数表格软件另存为时可以选「CSV UTF-8」)
- 第一行是表头
- 最大 20 MB、20 万行
2. 上传文件并对应字段
把文件拖到 CSV 文件区域,或点击选择文件。EterMail 会读取前几行,显示字段对应表:每个 CSV 列、它的对应字段,以及该列数据的预览。

「Email」「First Name」「User ID」「邮箱」这类常见表头会自动对应。每一列可以选择:
| 对应字段 | 用途 |
|---|---|
| 邮箱、用户 ID | 识别是谁,至少要有其中一个 |
| 名、姓 | 邮件个性化,例如 {{ contact.first_name }} |
| 标签 | 一个单元格里放多个标签,用逗号、分号或竖线分隔 |
| 自定义属性 | 其他信息(城市、套餐、生日月份等),以列名作为属性名保存 |
| 不导入 | 不需要的列 |
系统不认识的列默认作为自定义属性导入,不需要的列请改成不导入。自定义属性可以在分群里使用。
3. 选择订阅状态
在订阅状态下二选一:
- 只导入为联系人,不订阅营销邮件。 这些人会被保存,但不会收到营销邮件。适合没有营销同意的名单,比如从未勾选订阅的老买家。
- 这些联系人已同意接收营销邮件。 文件里的人都会订阅营销邮件。选这一项必须对应邮箱列。
选择订阅时,请填写同意来源说明:这些人何时、通过什么方式同意的,例如「店铺结账页订阅勾选框,2025–2026」。至少写 10 个字符,否则开始导入按钮不可点。这段说明会作为同意证据,和每个联系人一起保存。
4. 开始导入并查看结果
点击开始导入。导入在后台运行,会出现在导入记录里,显示状态(排队中、处理中、已完成或失败)和已处理的行数。

结果中各项的含义:
| 数字 | 含义 |
|---|---|
| 新建 | 新增的联系人 |
| 更新 | 已有联系人,按文件内容更新了资料 |
| 订阅 | 本次新订阅营销邮件的人 |
| 拦截 | 曾退订或在抑制名单里,因此没有订阅 |
| 失败 | 无法导入的行 |
展开错误样例,可以按行号查看最多 20 条失败的行。
导入完成后,上传的文件会被删除,导入记录里只保留统计数字。
特殊情况怎么处理
- 邮箱格式无效: 该行失败,会出现在错误样例里。
- 既没有邮箱也没有用户 ID: 该行失败。
- 同一个邮箱在文件里出现两次: 两行都会更新同一个联系人,以后面那行为准。
- 已经是联系人: 只更新资料,不会重复创建。原来已订阅的保持订阅。
- 曾退订或在抑制名单里的人(退信或投诉之后):资料照常保存,但导入永远不会让他们重新订阅,计入拦截。只有本人重新主动订阅(比如通过订阅表单并确认)才能恢复。
每封邮件发出前都会再检查一次订阅状态,所以导入之后才退订的人会被自动跳过。
通过 Etta 或 AI 应用导入
你也可以让 Etta,或通过 MCP、API 连接的 AI 应用,根据 CSV 文本准备一次导入(每次最多 1 MB)。在你批准之前,什么都不会导入。审批页会列出有效、重复、已在账户里、已退订和在抑制名单里的人数,以及应用填写的同意说明。请亲自核对说明,再勾选确认(订阅类导入是「我确认文件里的每个人都按上面的说明同意接收我们的营销邮件」),然后批准。发件方是你的工作区,这个确认由你负责。
常见问题
可以只导入、不订阅吗?
可以。选择只导入为联系人,不订阅营销邮件。这些人在联系人列表里显示为未订阅,在他们主动订阅之前不会收到营销邮件。
重复导入会产生重复联系人吗?
不会。联系人按邮箱(或用户 ID)匹配,再次导入只会更新同一批人。
为什么有些人没有订阅成功?
他们之前退订过,或者在抑制名单里,所以计入拦截。EterMail 不会通过文件让他们重新订阅。
可以手动添加单个联系人吗?
可以。在联系人页面点击添加联系人。只有对方明确同意过,才勾选「此人已同意接收我们的营销邮件」。
导入之后做什么?
没找到想要的? 全部指南 →