导入您的推荐项目数据
当您从其他推荐平台切换到 Advocate 时，您不仅仅是在导入数据——您还在借助强大的跟踪、自定义体验和专家支持，提升项目的潜力。本文将带您了解：
为什么迁移很重要
战略性迁移计划是什么样的
可以导入哪些数据
如何准备您的文件
常见的验证错误以及如何避免它们
为什么要规划战略性迁移？
迁移您的推荐项目不仅是一项技术任务——它也是提升您与客户互动和奖励方式的机会。精心规划的迁移有助于：
尽量减少对推荐体验的干扰
保留历史数据并确保奖励连续性
顺利脱离旧系统
以更清晰、更有吸引力的方式重新推出您的推荐项目
推荐和奖励迁移取决于您能否从当前系统导出数据。您的 Advocate 团队可以根据您提供的导出数据，告知您哪些内容可以实现。
您的 Advocate 团队将与您一起审核导出文件，确认可行内容，并制定符合您项目需求和目标的计划。
您需要做什么
导出您项目的 用户数据, 推荐数据，以及 奖励数据。您可以联系旧推荐平台上的 CSM 寻求帮助，或者在平台提供导出工具的情况下直接使用。
请将 3 份数据报表分别下载为独立的 CSV 文件，例如：
user_data.CSV,referral_data.CSV，以及reward_data.CSV.请参阅下面的示例，了解每个 .csv 文件的内容可能是什么样子，或查看完整的 Destination 字段参考。
这包括邮箱、推荐码、分享链接 以及自定义字段。应筛除联盟成员，以避免重复奖励。
取决于分享链接格式以及是否使用自定义子域。
用户数据文件将包含您项目中每位参与者的详细信息。导出所有参与者的列表，以使项目中的分享链接和推荐码保持最新。
以下字段为 必填:
用户 ID
账户 ID
请使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数。下载 必填字段示例 ，或使用下面的 .csv 格式示例。
这包括开始和转化日期，以及推荐人与被推荐人之间的关系。它支持映射历史推荐表现。
推荐数据文件会记录您推荐项目中每条推荐关联的状态。
以下字段为 必填:
Advocate 用户 ID
Advocate 账户 ID
被推荐用户 ID
被推荐账户 ID
请使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数。下载 必填字段示例 ，或使用下面的 .csv 格式示例。
这包括数值、赠送/兑换日期、奖励类型和状态。它有助于维护用户的信任和公平性。
奖励数据文件会记录参与者的奖励历史，包括通过您的推荐项目产生的奖励价值和已兑换金额。
以下字段为 必填:
Advocate 用户 ID
Advocate 账户 ID
奖励名称
奖励单位
奖励值
创建日期
发放日期
兑换日期
已兑换金额
请使用用户的邮箱作为其 用户 ID 和 账户 ID。日期应格式化为 自 Unix 纪元以来的毫秒数.
奖励值是奖励在其最小计量单位中的数值（例如，1.00 美元现金奖励，其值应为 100 美分）。如果奖励单位为现金，则应按以下格式包含货币代码 <unitName>/<Currency> （例如，Cash/USD）。
重要：如果 兑换日期 和 已兑换金额 字段未正确设置——也就是说它们要么为空，要么包含错误值（例如，未来日期或不准确的已兑换金额）——该奖励可能会再次对用户可兑换。
下载一个 必填字段示例 ，或使用下面的 .csv 格式示例。
重要： 这 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 或帮助文档。
• 监控支持邮箱中与旧系统用户相关的问题。
提示
• 如果您正在停用旧的奖励资金账户，请给用户一段宽限期进行兑换。
• 使用电子邮件或应用内提醒，推动新项目中的早期推荐活动。
导入您项目的数据
从左侧导航菜单中，选择
[Engage] → 报表 → 导入与导出.在右上角，选择
导入.选择 导入类型 从可用选项中：
导入类型描述用户
选择此选项以上传新用户或现有用户数据。您也可以选择从其他账户或平台导入此数据。
更新用户奖励余额
选择此选项以更新并兑换用户奖励余额。
用户事件
选择此选项以上传用户事件数据。
删除用户
如果您想批量删除项目中的现有用户，请选择此选项。
您还可以选择删除用户处理方式，并选择：
• 保留空账户
• 防止已删除用户再次被创建
奖励历史
选择此选项以上传所有奖励信息的记录。您也可以选择从其他账户或平台导入此数据。
推荐历史
选择此选项以上传所有推荐关联的记录。您也可以选择从其他账户或平台导入此数据。
选择 选择文件 或者将您想要导入的文件拖放到此处。
选择 导入 以上传您的数据。
如果批量删除现有用户，请选择 批量删除.
验证错误参考
您可能会遇到 3 种类型的验证错误：
行内错误消息： 这些会显示在预览验证表中，并使错误行以红色高亮显示：
INVALID_FIELD——例如， 创建日期 字段没有按 自 Unix 纪元以来的毫秒数 .MISSING_FIELD——例如，某个必填字段，如 用户 ID 或 账户 ID 缺失。
错误提示： 这些会以红色警告消息的形式显示在预览验证表的位置：
MISSING_HEADER——例如，某个必需的列标题，如 账户 ID 或 奖励值 缺失。CSV_PARSING——例如，CSV 文件包含格式不正确的特殊字符。FILE_REF_IO——例如，文件已损坏且无法读取。
列出错误： 这些会以错误计数列表的形式显示在 导入与导出 界面上，位于 报表 部分中，当导入类型没有预览验证表时。行错误和文件错误将一起显示：
支持
您无需独自处理迁移。我们的 Advocate 入门团队随时准备提供以下帮助：
字段映射支持
数据格式指南
奖励迁移策略
测试与 QA
联系您的 Advocate 支持团队.
最后更新于
这有帮助吗？