> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md). # 导入你的推荐项目数据 当您从其他推荐平台切换到 Advocate 时，您不仅是在导入数据——您还在借助强大的追踪、可自定义的体验和专业支持，提升计划的潜力。本文将带您了解： * 为什么迁移很重要 * 战略性迁移计划是什么样的 * 可导入哪些数据 * 如何准备您的文件 * 常见校验错误及其规避方法 #### 为什么要规划战略性迁移？ 迁移您的推荐计划不仅仅是一项技术任务——这也是提升您与客户互动和奖励方式的机会。精心规划的迁移有助于： * 尽量减少对推荐体验的影响 * 保留历史数据并确保奖励连续性 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) * 实现与旧系统的彻底切换 * 以更清晰、更有吸引力的方式重新推出您的推荐计划 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 推荐和奖励迁移取决于您能否从当前系统导出数据。基于您提供的导出数据，您的 Advocate 团队可以告诉您哪些内容是可行的。 您的 Advocate 团队会与您一起审查导出文件，识别可行内容，并制定符合您计划需求和目标的方案。 #### 您需要做什么 * 导出您的计划的 *用户数据*, *推荐数据*，以及 *奖励数据*。您可以联系旧推荐平台上的 CSM 寻求帮助，或使用平台内提供的导出工具。 * 将 3 份数据报告分别下载为独立的 CSV 文件，例如， `user_data.CSV`, `referral_data.CSV`，以及 `reward_data.CSV`. * 请参阅下面的示例，了解每个 .csv 文件的内容可能是什么样子，或查看完整的 Destination 字段参考。 这包括电子邮件、推荐码、分享链接 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media)以及自定义字段。应将联盟伙伴筛选排除，以避免重复发放奖励。 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media) 取决于分享链接的格式以及是否使用自定义子域名。 User Data 文件将包含您计划中每位参与者的详细信息。导出所有参与者的列表，以便通过其分享链接和推荐码保持计划数据最新。 以下字段为 **必填**: * 用户 ID * 账户 ID 将用户的电子邮件用作其 *用户 ID* 和 *账户 ID*。日期应格式化为 [Unix 时间戳以来的毫秒数](https://currentmillis.com/)。下载一个 [必填字段示例](https://res.cloudinary.com/product-enablement/raw/upload/v1750169976/CSVs/Migration_User_Import_examples_-_User_Data.csv) 或使用下面的示例： `.csv` 格式。 ```programlisting id,accountId,email,firstName,lastName,dateCreated,locale,countryCode,segments User1@example.com,User1@example.com,User1@example.com,First,Last,1741051242000,en_US,US, User2@example.com,User2@example.com,User2@example.com,First,Last,,,,"vip,newuser" User3@example.com,User3@example.com,User3@example.com,First,Last,,en_CA,, User4@example.com,User4@example.com,User4@example.com,First,Last,,,,newuser ``` 这包括开始日期和转化日期，以及推荐人/被推荐人关系。它支持映射历史推荐表现。 推荐数据文件会记录您推荐计划中每条推荐关系的状态。 以下字段为 **必填**: * Advocate 用户 ID * Advocate 账户 ID * 被推荐用户 ID * 被推荐账户 ID 将用户的电子邮件用作其 *用户 ID* 和 *账户 ID*。日期应格式化为 [Unix 时间戳以来的毫秒数](https://currentmillis.com/)。下载一个 [必填字段示例](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Referral_Data_-_Referral_Data.csv) 或使用下面的示例： `.csv` 格式。 ```programlisting referrerUser,referrerAccount,referredUser,referredAccount,dateReferralStarted,dateConverted,programId User2@example.com,User2@example.com,User12@example.com,User12@example.com,1740824979000,1740824979000,33435 User1@example.com,User1@example.com,User13@example.com,User13@example.com,1741051242000,1741051242000,33435 User1@example.com,User1@example.com,User17@example.com,User17@example.com,,,33435 User1@example.com,User1@example.com,User18@example.com,User18@example.com,,,33435 ``` 这包括数值、发放/兑换日期、奖励类型和状态。它有助于维护与用户之间的可信度和公平性。 Reward Data 文件会记录参与者的奖励历史，包括通过您的推荐计划生成的奖励数值和已兑换金额。 以下字段为 **必填**: * Advocate 用户 ID * Advocate 账户 ID * 奖励名称 * 奖励单位 * 奖励金额 * 创建日期 * 发放日期 * 兑换日期 * 已兑换金额 将用户的电子邮件用作其 *用户 ID* 和 *账户 ID*。日期应格式化为 [Unix 时间戳以来的毫秒数](https://currentmillis.com/). 奖励值是奖励在其最小计量单位中的数值（例如，现金奖励 $1.00 的值应为 100 美分）。如果奖励单位为现金，则应按以下格式包含货币代码 `/` （例如：Cash/USD）。 {% hint style="warning" %} **重要**：如果 *兑换日期* 和 *已兑换金额* 字段未正确设置——也就是留空或包含错误值（例如，未来日期或不准确的已兑换金额）——奖励可能会再次可供用户兑换。 {% endhint %} 下载一个 [必填字段示例](https://res.cloudinary.com/product-enablement/raw/upload/v1750249453/CSVs/Migration_User_Import_examples_-_Reward_Data_-_Reward_Data.csv) 或使用下面的示例： `.csv` 格式。 ```programlisting User ID,Acccount ID,Referred User ID,Referred Account ID,Reward Name,Reward Unit,Reward Value,Redeemed Amount,Date Created,Date Given,Date Redeemed User1@example.com,User1@example.com,User2@example.com,User2@example.com,Dollars,CASH/USD,1000,1000,1709712158000,1709712158000,1709712158000 User1@example.com,User1@example.com,User3@example.com,User3@example.com,Points,POINT,100,100,1726164909682,1726164909682,1726164909682 User1@example.com,User1@example.com,User4@example.com,User4@example.com,Points,POINT,100,100,1726164887075,1726164887075,1726164887075 User1@example.com,User1@example.com,User5@example.com,User5@example.com,Points,POINT,100,100,1726164875888,1726164875888,1726164875888 User1@example.com,User1@example.com,User6@example.com,User6@example.com,Points,POINT,10,10,1726164828986,1726164828986,1726164828986 User1@example.com,User1@example.com,User7@example.com,User7@example.com,Account Credit,USD,8000,8000,1726164289997,1726164289997,1726164289997 User1@example.com,User1@example.com,,,Gift Card,USD,10000,10000,1726163864871,1726163864871,1726163864871 User1@example.com,User1@example.com,,,Points,POINT,800,800,1726095906392,1726095906392,1726095906392 User1@example.com,User1@example.com,,,Gift Card,USD,30000,30000,1726163769157,1726163769157,1726163769157 User1@example.com,User1@example.com,,,20 Off,%,20,20,1726180309034,1726180309034,1726180309034 ``` {% hint style="warning" %} **重要：** 所有 3 个导出文件都应只包含单个计划的数据。如果文件中包含多个计划的数据，导入后会将其合并到同一个计划中。 {% endhint %}
迁移计划示例 每次迁移都各不相同，但成功的迁移通常遵循类似的结构，在准备、沟通和执行之间取得平衡。下面是一份可确保连续性并为您的团队和 Advocate 提供无缝体验的迁移计划。时间线和阶段可根据您的计划设置灵活调整。 **阶段 1：规划与准备（1–2 周）** 这是打基础的阶段，为顺利过渡奠定基础。 | | | | -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目标 |

• 协调相关利益方。

• 技术设置。

• 确认迁移范围。

• 规划用户沟通。

| | 任务 |

• 获取一组历史数据样本（用户、推荐、奖励），并与 Advocate 团队共享以便审核和字段映射 .

• 在样本验证通过后导出完整数据集。导出数据很可能需要进行调整（例如修改表头、字段名称或文件结构），以满足导入要求。

• 设定上线日期和回滚窗口。

• 以隐藏模式（测试环境或未链接页面）添加 Advocate 小组件。

• 设置必要的集成（例如 Shopify、HubSpot、Segment）。

• 在 Advocate 中完成计划配置（例如奖励设置、计划规则、邮件模板、分群）。

• 端到端测试计划功能——在正式上线前，确认在测试环境中分享、转化和奖励能够正确追踪。

• 起草向 Advocate 通知过渡的文案。

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

| | 提示 |

• 如果您在重叠使用多个平台，请确保只有一个平台在发放奖励。

• 识别可能需要特殊处理的高价值用户（VIP、意见领袖）。

| **阶段 2：切换并上线（1-2 天）** 这是您的过渡时刻。请计划在系统之间的追踪短暂停顿，并尽可能安排在低流量时段。 | | | | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 目标 |

• 无缝从旧平台切换到 Advocate。

• 确保用户能立即访问新的体验。

• 避免丢失推荐数据或奖励。

| | 任务 |

• 从您的网站中移除旧平台脚本/小组件。

• 将 Advocate 小组件正式上线。

• 导入最终的用户、推荐和奖励数据。

• 手动跟踪/标记系统停用与上线之间发生的任何转化。

• 监控 Advocate 仪表板中的活动。

• 向 Advocate 发送上线通知。让用户知道他们的推荐链接已更新，并理想情况下在邮件中直接包含新链接，方便他们立即开始分享。

| | 提示 |

• 如有必要，加入一段简短的奖励静默缓冲期（例如：“5 月 15 日进行的推荐将被审核并在上线后补发。”）。

• 使用面向 Advocate 的沟通来制造期待感（例如：“我们已经升级了您的推荐体验！”）。

| **阶段 3：迁移后与清理（1–2 天）** 现在您已上线，请确保计划按预期运行，并处理所有遗留事项。 | | | | -- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | 目标 |

• 验证数据完整性和奖励追踪。

• 补录任何遗漏的转化。

• 支持并教育用户。

| | 任务 |

• 验证推荐人/被推荐人关系在正式模式下是否正常工作。

• 导入切换期间发生的任何遗漏转化。

• 进行 QA 测试（自己进行推荐，确认追踪和奖励逻辑）。

• 提供内部和外部 FAQ 或帮助文档。

• 监控支持邮箱中与旧用户相关的问题。

| | 提示 |

• 如果您正在停用旧的奖励资金账户，请给予用户一段兑换宽限期。

• 使用电子邮件或应用内提醒，推动新计划中的早期推荐活动。

|
#### 导入您的计划数据 1. 从左侧导航菜单中，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → 报告 → 导入与导出**. 2. 在右上角，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ec3276f07285180fbb2167a40e148d3e43e8681c%2F05aa88f72076df5a744d4620574f19cc187b7154fe1f3bb73ad7a892b7d23002.svg?alt=media) **导入**. 3. 选择 *导入类型* 从可用选项中： | 导入类型 | 说明 | | -------- | ------------------------------------------------------------------------------------------- | | 用户 | 选择此选项可上传新用户或现有用户数据。您也可以选择从其他账户或平台导入此数据。 | | 更新用户奖励余额 | 选择此选项可更新并兑换用户奖励余额。 | | 用户事件 | 选择此选项可上传用户事件数据。 | | 删除用户 |

如果您想批量删除计划中的现有用户，请选择此选项。

您还可以选择删除用户处理方式并选择：

• 保留空账户

• 防止已删除用户再次被创建

| | 奖励历史 | 选择此选项可上传所有奖励信息的记录。您也可以选择从其他账户或平台导入此数据。 | | 推荐历史 | 选择此选项可上传所有推荐关系的记录。您也可以选择从其他账户或平台导入此数据。 | 4. 选择 **选择文件** 或拖放您要导入的文件。 5. 选择 **导入** 以上传您的数据。 * 如果要批量删除现有用户，请选择 **批量删除**. #### 验证错误参考 您可能会遇到 3 种校验错误： 1. **行内错误信息：** 这些错误会显示在预览校验表中，并使错误行以红色高亮： * `无效字段` — 例如， *创建日期* 字段未按以下格式设置 [Unix 时间戳以来的毫秒数](https://currentmillis.com/) . * `缺失字段` — 例如，以下必填字段 *用户 ID* 或 *账户 ID* 缺失。
2. **错误提示：** 这些会以红色警告消息的形式显示，取代预览校验表： * `缺失表头` — 例如，以下必需列标题 *账户 ID* 或 *奖励金额* 缺失。 * `CSV 解析` — 例如，CSV 文件包含格式不正确的特殊字符。 * `文件引用 I/O` — 例如，文件已损坏，无法读取。
3. **列出的错误：** 这些会以错误计数列表的形式显示在 *导入与导出* 页面中的 *报告* 部分中，当导入类型没有预览校验表时显示。行错误和文件错误将一起显示：
#### 支持 您无需独自处理迁移。我们的 Advocate 入门团队可随时为您提供以下帮助： * 字段映射支持 * 数据格式指导 * 奖励迁移策略 * 测试与 QA 联系您的 [Advocate 支持团队](mailto:support-advocate@impact.com). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/import-your-referral-program-data.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.