OneTrace.pro 帮助中心

从其他平台迁移

迁移向导可将 Customer.io、Mindbox 和 Retail Rocket 中的数据迁移到 OneTrace.pro:带属性和标识符的档案、同意、分群、事件和消息历史、订单以及邮件模板。迁移可以暂停后从中断处继续,迁移完成后还可以加载新增数据。

在菜单中打开数据 → 数据迁移。“经理”“管理员”和“所有者”角色(拥有“编辑和导入档案”权限)可以使用此板块。

迁移哪些数据

平台 数据来源 迁移内容
Customer.io App API 档案和属性、同意和订阅主题、分群、最近 30 天的事件、最长 12 个月的消息历史、邮件模板
Mindbox Mindbox 导出操作 带自定义字段、余额和折扣卡的客户、订阅、分群、客户合并、行为、含订单行的订单
Retail Rocket 从后台导出的文件 订阅者库、分群(每个分群一个文件)、事件、订单

迁移后的数据形式:

  • 档案按邮箱、电话和您的客户标识符合并。平台的原始 ID 会保存为 mindbox:12345 形式的匿名 ID,便于在档案板块中查找档案。
  • 同意显示在档案卡片的“订阅”模块中,并带有来源,例如“从 Mindbox 迁移”。
  • 分群会变为包含当前成员的静态分群,名称为“平台:名称”。分群规则不会迁移,如有需要,请在编辑器中重新构建。
  • 事件和订单保留原始时间。订单以带商品的 order_completed 事件形式导入。
  • 消息历史会转换为发送、打开、点击和退订事件。
  • 邮件模板会进入“模板”板块。如果平台变量无法转换,模板名称会加上“需要检查”标记。

如何启动迁移

  1. 点击新建迁移。
  2. 平台步骤:选择 Customer.io、Mindbox 或 Retail Rocket。
  3. 连接步骤:填写名称和访问参数。
    • Customer.io:账户区域、App API 密钥和消息历史的时间范围。
    • Mindbox:API 域名、Endpoint ID、私密密钥、外部客户标识符(将成为档案的 User ID)、“历史起始日期”,以及客户、合并、行为和订单导出操作的名称。
    • Retail Rocket:点击保存,然后在“文件内容”字段中选择导出类型并点击上传文件。支持 CSV、JSON 和 JSON Lines,单个文件不超过 500 MB,最多 50 个文件。
  4. 点击测试连接:系统会检查密钥和区域,但不导入数据。然后点击下一步。
  5. 数据与启动步骤:在“迁移内容”模块中勾选所需的数据类型。估算数据量按钮会显示平台提供的记录数量。
  6. 阅读“还需向平台申请的内容”模块,其中列出了需要在平台一侧准备或单独迁移的内容。
  7. 点击开始导入。

迁移向导中的数据选择步骤

每一步都会保存草稿:您可以关闭向导,之后通过迁移卡片上的继续设置按钮返回。

迁移进度

迁移卡片显示状态以及每种数据类型的计数:已读取、已导入、已跳过和出错的记录数。迁移进行期间页面会自动刷新。

显示进度的迁移卡片

状态 含义
草稿 设置尚未完成
排队中、运行中 正在迁移数据
等待平台 Mindbox 正在准备导出,一分钟后会再次检查
已完成 所有选定的数据均已迁移
失败 迁移中断,错误信息显示在卡片上
已停止 您停止了迁移

单条记录的错误(例如“该记录没有档案标识符”)不会中止迁移:可以在“记录错误”模块中展开查看前 20 条。

停止、继续和增量加载

  • 停止:在当前这批记录处理完后中断迁移。
  • 继续:出错或停止后,从最后保存的位置继续迁移,而不是从头开始。重复读取的记录不会产生重复数据。
  • 加载新数据:在已完成的迁移上显示。迁移会获取自上次运行以来平台上新增的数据:起始时间显示在“下次运行将加载此时间之后的变更”一行中。这样可以分阶段迁移:提前迁移历史数据,在切换当天再加载最新的变更。
  • 设置:修改连接和数据范围。迁移进行期间无法修改设置:请先停止迁移。
  • 删除:删除迁移及已上传的文件。已迁移的数据仍保留在项目中。

注意事项

  • **Customer.io 只提供最近 30 天的事件。**更早的历史请从源系统导出,或通过 Data Warehouse sync 获取。对象和关系以及被屏蔽地址列表(suppressions)不会迁移。
  • **Mindbox:**请提前在 Mindbox 中创建 JSON 格式的导出操作,并包含所有需要的字段。邮箱和电话需要以未哈希的形式导出。Mindbox 不导出商品目录和优惠码:请通过数据源接入同一个商品源。
  • **Retail Rocket:**文件列按俄语和英语列名识别,订阅者库中的其他列将成为档案属性。邮件模板和商品目录需要手动迁移。
  • 迁移的事件计入套餐的每月事件限额。如果限额用尽,迁移会因错误而停止:提高限额后,请点击继续。
  • 大量数据的迁移需要较长时间,Mindbox 尤其如此:每次导出都由平台自行准备。您可以关闭页面,迁移会继续进行。