导入您的推荐计划数据

当从其他推荐平台切换到 Advocate 时，你不仅是在导入数据——你还在借助强大的追踪、可自定义的体验和专家支持，提升你项目的潜力。本文将带你了解：

• 为什么迁移很重要
• 战略性迁移计划是什么样的
• 可以导入哪些数据
• 如何准备你的文件
• 常见验证错误及其避免方法

为什么要规划战略性迁移？

迁移你的推荐项目不仅是一个技术任务——这也是一次提升你与客户互动和奖励方式的机会。精心规划的迁移有助于：

• 最大限度减少对推荐体验的影响
• 保留历史数据并确保奖励连续性
• 顺利脱离旧系统
• 以更清晰、更令人期待的方式重新推出你的推荐项目

推荐和奖励迁移取决于你能否从当前系统导出数据。你的 Advocate 团队可以根据你提供的导出数据，告诉你哪些是可行的。

你的 Advocate 团队会与你一起审查导出文件，识别可行方案，并制定符合你项目需求和目标的计划。

你需要做什么

• 导出你项目的 用户数据, 推荐数据，以及 奖励数据。你可以联系旧推荐平台上的 CSM 寻求帮助，或使用平台内提供的导出工具（如果有）。
• 将 3 份数据报告分别下载为单独的 CSV 文件，例如： user_data.CSV, referral_data.CSV，以及 reward_data.CSV.

  • 以下示例展示了每个 .csv 文件的内容可能是什么样子，或查看完整的 Destination 字段参考。

这包括邮箱、推荐码、分享链接 以及自定义字段。应筛除联盟成员，以避免重复奖励。

取决于分享链接格式以及是否使用自定义子域名。

用户数据文件将包含你项目中每位参与者的详细信息。导出所有参与者的名单，以便让项目中的分享链接和推荐码保持最新。

以下字段是 必需的:

• 用户 ID
• 账户 ID

使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数。下载一个 所需字段示例 ，或使用下方的示例： .csv 格式。

id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments
[e-mail],[e-mail],[e-mail],First,Last,1741051242000,en_US,US,
[e-mail],[e-mail],[e-mail],First,Last,,,,"vip,newuser"
[e-mail],[e-mail],[e-mail],First,Last,,en_CA,,
[e-mail],[e-mail],[e-mail],First,Last,,,,newuser

这包括开始日期和转化日期，以及推荐人/被推荐人的关系。它支持映射历史推荐表现。

推荐数据文件会记录你推荐项目中每一条推荐关系的状态。

以下字段是 必需的:

• Advocate 用户 ID
• Advocate 账户 ID
• 被推荐用户 ID
• 被推荐账户 ID

使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数。下载一个 所需字段示例 ，或使用下方的示例： .csv 格式。

referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId
[e-mail],[e-mail],[e-mail],[e-mail],1740824979000,1740824979000,33435
[e-mail],[e-mail],[e-mail],[e-mail],1741051242000,1741051242000,33435
[e-mail],[e-mail],[e-mail],[e-mail],,,33435
[e-mail],[e-mail],[e-mail],[e-mail],,,33435

这包括金额、发放/兑换日期、奖励类型和状态。它有助于保持用户的信任和公平性。

奖励数据文件会记录参与者的奖励历史，包括通过你的推荐项目生成的奖励金额和已兑换金额。

以下字段是 必需的:

• Advocate 用户 ID
• Advocate 账户 ID
• 奖励名称
• 奖励单位
• 奖励金额
• 创建日期
• 发放日期
• 兑换日期
• 已兑换金额

使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数.

奖励价值是指奖励在最小计量单位中的数值（例如，现金奖励 1.00 美元，其数值应为 100 美分）。如果奖励单位为现金，则应按以下格式包含货币代码 <unitName>/<Currency> （例如，Cash/USD）。

重要：如果 兑换日期 和 已兑换金额 这些字段未正确设置——即留空或包含错误值（例如未来日期或不准确的已兑换金额）——该奖励可能会再次可供用户兑换。

下载一个 所需字段示例 ，或使用下方的示例： .csv 格式。

User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed
[e-mail],[e-mail],[e-mail],[e-mail],Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164909682,1726164909682,1726164909682
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164887075,1726164887075,1726164887075
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,100,100,1726164875888,1726164875888,1726164875888
[e-mail],[e-mail],[e-mail],[e-mail],Points,POINT,10,10,1726164828986,1726164828986,1726164828986
[e-mail],[e-mail],[e-mail],[e-mail],Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997
[e-mail],[e-mail],,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871
[e-mail],[e-mail],,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392
[e-mail],[e-mail],,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157
[e-mail],[e-mail],,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034

重要： 这 3 个导出文件都应只包含单一项目的数据。如果文件包含多个项目的数据，导入时会将它们合并为一个项目。

迁移计划示例

每次迁移都是独一无二的，但成功的迁移通常遵循类似的结构，在准备、沟通和执行之间取得平衡。以下迁移计划可确保连续性，并为你的团队和倡导者提供无缝体验。时间表和阶段可根据你的项目设置灵活调整。

第 1 阶段：规划与准备（1–2 周）

这是打基础的阶段，为顺利过渡奠定基础。

目标	• 统一相关方。 • 技术设置。 • 确认迁移范围。 • 规划用户沟通。
任务	• 获取一份历史数据样本（用户、推荐、奖励）并与 Advocate 团队共享，以便审查和字段映射 . • 样本验证通过后，导出完整数据集。导出数据很可能需要进行处理（例如调整表头、字段名或文件结构）以符合导入要求。 • 设定正式上线日期和回滚窗口。 • 以隐藏模式添加 Advocate 组件（测试环境或未关联页面）。 • 配置必要的集成（例如 Shopify、HubSpot、Segment）。 • 在 Advocate 中完成项目配置（例如奖励设置、项目规则、邮件模板、细分）。 • 端到端测试项目功能——在正式上线前，确认分享、转化和奖励在测试环境中能正确追踪。 • 起草沟通文案，向倡导者说明过渡情况。 推荐和奖励迁移取决于你能否从当前系统导出数据。你的 Advocate 团队可以根据你提供的导出数据，告诉你哪些是可行的。
提示	• 如果你同时运行多个平台，请确保只有一个平台在发放奖励。 • 识别可能需要特殊处理的重度用户（VIP、影响者）。

第 2 阶段：切换并正式上线（1-2 天）

这是你的过渡时刻。请计划在两个系统之间短暂停止追踪，并尽可能安排在低流量时段。

目标	• 从旧平台无缝切换到 Advocate。 • 确保用户可以立即访问新的体验。 • 避免推荐数据或奖励的丢失。
任务	• 从你的网站移除旧平台脚本/组件。 • 将 Advocate 组件上线。 • 导入最终的用户、推荐和奖励数据。 • 手动追踪/标记系统停机与上线之间发生的任何转化。 • 监控 Advocate 仪表板中的活动。 • 向倡导者发送上线通知。让用户知道他们的推荐链接已更新，并最好在邮件中直接附上新链接，让他们能够立即开始分享。
提示	• 如有必要，可设置一段简短的奖励冻结缓冲期（例如：“5 月 15 日发生的推荐将会在上线后审核并补录。”）。 • 使用面向倡导者的沟通方式营造兴奋感（例如：“我们已升级你的推荐体验！”）。

第 3 阶段：迁移后与清理（1–2 天）

现在你已经上线，请确保项目按预期运行，并处理所有未完成事项。

目标	• 验证数据完整性和奖励追踪。 • 补录任何遗漏的转化。 • 支持并教育用户。
任务	• 验证推荐人/被推荐人的关系在正式环境中正常工作。 • 导入在切换期间遗漏的任何转化。 • 进行 QA 测试（推荐自己，确认追踪和奖励逻辑）。 • 提供内部和外部 FAQ 或帮助文档。 • 监控支持收件箱，处理与旧用户相关的问题。
提示	• 如果你正在停用旧的奖励资金账户，请给予用户一段宽限期来兑换奖励。 • 通过邮件或应用内提醒，推动新项目中的早期推荐活动。

导入你项目的数据

1. 从左侧导航菜单中，选择 [Engage] → 报告 → 导入与导出.
2. 在右上角，选择 导入.
3. 选择 导入类型 从可用选项中：

   导入类型	说明
   用户	选择此选项可上传新用户或现有用户数据。你也可以选择从其他账户或平台导入这些数据。
   更新用户奖励余额	选择此选项可更新和兑换用户奖励余额。
   用户事件	选择此选项可上传用户事件数据。
   删除用户	如果你想批量删除项目中的现有用户，请选择此选项。 你还可以选择删除用户处理并： • 保留空账户 • 防止已删除的用户再次被创建
   奖励历史	选择此选项可上传所有奖励信息的记录。你也可以选择从其他账户或平台导入这些数据。
   推荐历史	选择此选项可上传所有推荐关系的记录。你也可以选择从其他账户或平台导入这些数据。

4. 选择 选择文件 或者将你想导入的文件拖放到此处。
5. 选择 导入 以上传你的数据。

   • 如果要批量删除现有用户，请选择 批量删除.

验证错误参考

你可能会遇到 3 种验证错误：

1. 行内错误消息： 这些会显示在预览验证表中，并使出错行以红色高亮显示：

   • INVALID_FIELD ——例如， 创建日期 字段未按 自 Unix 纪元以来的毫秒数 .
   • MISSING_FIELD ——例如，像 用户 ID 或 账户 ID 这样的必填字段缺失。

   
2. 错误提示： 这些会以红色警告消息的形式显示在预览验证表的位置：

   • MISSING_HEADER ——例如，像 账户 ID 或 奖励金额 这样的必填字段缺失。
   • CSV_PARSING ——例如，CSV 文件包含格式不正确的特殊字符。
   • FILE_REF_IO ——例如，文件已损坏且无法读取。

   
3. 列出的错误： 这些会以错误计数列表的形式显示在 导入与导出 屏幕中的 报告 部分内，当导入类型没有预览验证表时。行错误和文件错误会同时显示：

   

支持

你不必独自应对迁移。我们的 Advocate 入职团队随时准备协助：

• 字段映射支持
• 数据格式指导
• 奖励迁移策略
• 测试与 QA

联系你的 Advocate 支持团队.