从其他平台迁移
迁移向导可将 Customer.io、Mindbox 和 Retail Rocket 中的数据迁移到 OneTrace.pro:带属性和标识符的档案、同意、分群、事件和消息历史、订单以及邮件模板。迁移可以暂停后从中断处继续,迁移完成后还可以加载新增数据。
在菜单中打开数据 → 数据迁移。“经理”“管理员”和“所有者”角色(拥有“编辑和导入档案”权限)可以使用此板块。
迁移哪些数据
| 平台 | 数据来源 | 迁移内容 |
|---|---|---|
| Customer.io | App API | 档案和属性、同意和订阅主题、分群、最近 30 天的事件、最长 12 个月的消息历史、邮件模板 |
| Mindbox | Mindbox 导出操作 | 带自定义字段、余额和折扣卡的客户、订阅、分群、客户合并、行为、含订单行的订单 |
| Retail Rocket | 从后台导出的文件 | 订阅者库、分群(每个分群一个文件)、事件、订单 |
迁移后的数据形式:
- 档案按邮箱、电话和您的客户标识符合并。平台的原始 ID 会保存为
mindbox:12345形式的匿名 ID,便于在档案板块中查找档案。 - 同意显示在档案卡片的“订阅”模块中,并带有来源,例如“从 Mindbox 迁移”。
- 分群会变为包含当前成员的静态分群,名称为“平台:名称”。分群规则不会迁移,如有需要,请在编辑器中重新构建。
- 事件和订单保留原始时间。订单以带商品的
order_completed事件形式导入。 - 消息历史会转换为发送、打开、点击和退订事件。
- 邮件模板会进入“模板”板块。如果平台变量无法转换,模板名称会加上“需要检查”标记。
如何启动迁移
- 点击新建迁移。
- 平台步骤:选择 Customer.io、Mindbox 或 Retail Rocket。
- 连接步骤:填写名称和访问参数。
- Customer.io:账户区域、App API 密钥和消息历史的时间范围。
- Mindbox:API 域名、Endpoint ID、私密密钥、外部客户标识符(将成为档案的 User ID)、“历史起始日期”,以及客户、合并、行为和订单导出操作的名称。
- Retail Rocket:点击保存,然后在“文件内容”字段中选择导出类型并点击上传文件。支持 CSV、JSON 和 JSON Lines,单个文件不超过 500 MB,最多 50 个文件。
- 点击测试连接:系统会检查密钥和区域,但不导入数据。然后点击下一步。
- 数据与启动步骤:在“迁移内容”模块中勾选所需的数据类型。估算数据量按钮会显示平台提供的记录数量。
- 阅读“还需向平台申请的内容”模块,其中列出了需要在平台一侧准备或单独迁移的内容。
- 点击开始导入。

每一步都会保存草稿:您可以关闭向导,之后通过迁移卡片上的继续设置按钮返回。
迁移进度
迁移卡片显示状态以及每种数据类型的计数:已读取、已导入、已跳过和出错的记录数。迁移进行期间页面会自动刷新。

| 状态 | 含义 |
|---|---|
| 草稿 | 设置尚未完成 |
| 排队中、运行中 | 正在迁移数据 |
| 等待平台 | Mindbox 正在准备导出,一分钟后会再次检查 |
| 已完成 | 所有选定的数据均已迁移 |
| 失败 | 迁移中断,错误信息显示在卡片上 |
| 已停止 | 您停止了迁移 |
单条记录的错误(例如“该记录没有档案标识符”)不会中止迁移:可以在“记录错误”模块中展开查看前 20 条。
停止、继续和增量加载
- 停止:在当前这批记录处理完后中断迁移。
- 继续:出错或停止后,从最后保存的位置继续迁移,而不是从头开始。重复读取的记录不会产生重复数据。
- 加载新数据:在已完成的迁移上显示。迁移会获取自上次运行以来平台上新增的数据:起始时间显示在“下次运行将加载此时间之后的变更”一行中。这样可以分阶段迁移:提前迁移历史数据,在切换当天再加载最新的变更。
- 设置:修改连接和数据范围。迁移进行期间无法修改设置:请先停止迁移。
- 删除:删除迁移及已上传的文件。已迁移的数据仍保留在项目中。
注意事项
- **Customer.io 只提供最近 30 天的事件。**更早的历史请从源系统导出,或通过 Data Warehouse sync 获取。对象和关系以及被屏蔽地址列表(suppressions)不会迁移。
- **Mindbox:**请提前在 Mindbox 中创建 JSON 格式的导出操作,并包含所有需要的字段。邮箱和电话需要以未哈希的形式导出。Mindbox 不导出商品目录和优惠码:请通过数据源接入同一个商品源。
- **Retail Rocket:**文件列按俄语和英语列名识别,订阅者库中的其他列将成为档案属性。邮件模板和商品目录需要手动迁移。
- 迁移的事件计入套餐的每月事件限额。如果限额用尽,迁移会因错误而停止:提高限额后,请点击继续。
- 大量数据的迁移需要较长时间,Mindbox 尤其如此:每次导出都由平台自行准备。您可以关闭页面,迁移会继续进行。