# 导入您的推荐计划数据

从另一个推荐平台切换到 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 团队将与您一起审查导出文件，识别可行内容，并制定符合您计划需求和目标的计划。

#### 您需要执行的操作

* 导出您计划的 *用户数据*, *推荐数据*，和 *奖励数据*。要么联系您旧推荐平台的客户成功经理寻求帮助，要么使用平台内提供的导出工具（如果有）。
* 将这 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) 取决于分享链接格式和自定义子域的使用情况。

用户数据文件将包含有关您计划中每位参与者的详细信息。导出所有参与者的列表以使您的计划保持与其分享链接和推荐代码的最新状态。

以下字段是 **必填的**:

* 用户 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
```

这包括数值、给予/兑换日期、奖励类型和状态。它有助于保持与用户的可信度和公平性。

奖励数据文件记录了参与者通过您的推荐计划生成的奖励历史，包括其价值和已兑换金额。

以下字段是 **必填的**:

* Advocate 用户 ID
* Advocate 账户 ID
* 奖励名称
* 奖励单位
* 奖励数值
* 创建日期
* 给出日期
* 兑换日期
* 已兑换金额

使用用户的电子邮件作为他们的 *用户 ID* 和 *账户 ID*。日期应采用 [自 Unix 纪元以来的毫秒数](https://currentmillis.com/).

奖励数值是以其最小计量单位表示的数值（例如，现金奖励 $1.00 的数值为 100 分）。如果奖励单位是现金，应包含以下格式的货币代码 `<unitName>/<Currency>` （例如，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
用户 ID,账户 ID,被推荐用户 ID,被推荐账户 ID,奖励名称,奖励单位,奖励数值,已兑换金额,创建日期,给出日期,兑换日期
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,账户余额,USD,8000,8000,1726164289997,1726164289997,1726164289997
User1@example.com,User1@example.com,,,礼品卡,USD,10000,10000,1726163864871,1726163864871,1726163864871
User1@example.com,User1@example.com,,,积分,POINT,800,800,1726095906392,1726095906392,1726095906392
User1@example.com,User1@example.com,,,礼品卡,USD,30000,30000,1726163769157,1726163769157,1726163769157
User1@example.com,User1@example.com,,,20 折扣,%,20,20,1726180309034,1726180309034,1726180309034
```

{% hint style="warning" %}
**重要：** 这 3 个导出文件应仅包含来自同一计划的数据。如果文件包含来自多个计划的数据，导入时会将其合并到单一计划中。
{% endhint %}

<details>

<summary>示例迁移计划</summary>

每次迁移都是独特的，但成功的迁移遵循类似结构，平衡准备、沟通和执行。以下是一个迁移计划，可确保为您的团队和您的推荐者提供连续性和无缝体验。时间表和阶段可根据您的计划设置灵活调整。

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

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

|    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目标 | <p>• 使利益相关者达成一致。</p><p>• 技术设置。</p><p>• 确认迁移范围。</p><p>• 规划用户沟通。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 任务 | <p>• 获取一组示例历史数据（用户、推荐、奖励）并与 Advocate 团队共享以便审查和字段映射 <img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt="">.</p><p>• 在示例验证后导出完整数据集。导出数据很可能需要调整（例如，修改表头、字段名或文件结构）以匹配导入要求。</p><p>• 设定上线日期和回退窗口。</p><p>• 在隐藏模式下添加 Advocate 小部件（测试环境或未链接页面）。</p><p>• 设置必要的集成（例如，Shopify、HubSpot、Segment）。</p><p>• 在 Advocate 中完成项目配置（例如，奖励设置、项目规则、电子邮件模板、分段）。</p><p>• 在上线前在测试环境中进行端到端的程序功能测试——确认分享、转化和奖励在测试环境中正确跟踪。</p><p>• 起草用于向推荐者传达迁移的信息。</p><p><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c11b6248bd7b0ef1b687330c8c79fba510517058%2Ff18ad34bbbcaa64fb7feb774bf5d7e154b2a259f3a75f2c3b60ec0ed3ed2371d.svg?alt=media" alt=""> 推荐和奖励的迁移取决于您能否从当前系统导出数据。您的 Advocate 团队可以根据您提供的导出数据告知可行性。</p> |
| 提示 | <p>• 如果您在平台之间有重叠，请确保只有一个平台在发放奖励。</p><p>• 识别可能需要特殊处理的重要用户（VIP、意见领袖）。</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

**第 2 阶段：切换与上线（1–2 天）**

这是您的过渡时刻。计划在系统间短暂停止跟踪，并尽量安排在低流量时段执行。

|    |                                                                                                                                                                                                                 |
| -- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目标 | <p>• 无缝地从旧平台切换到 Advocate。</p><p>• 确保用户能够立即访问新的体验。</p><p>• 避免丢失推荐数据或奖励。</p>                                                                                                                                      |
| 任务 | <p>• 从您的站点移除旧平台的脚本/小部件。</p><p>• 将 Advocate 小部件推送到线上。</p><p>• 导入最终的用户、推荐和奖励数据。</p><p>• 在系统关闭与上线之间手动跟踪/标记任何转化。</p><p>• 监控 Advocate 仪表板的活动情况。</p><p>• 向您的推荐者发送上线通知。让用户知道他们的推荐链接已更新，最好在邮件中直接包含新链接，以便他们可以立即开始分享。</p> |
| 提示 | <p>• 如有必要，包含一个短期的奖励黑名单缓冲期（例如，“5 月 15 日发生的推荐将在上线后审核并添加。”）。</p><p>• 使用面向推荐者的沟通来制造兴奋感（例如，“我们已升级您的推荐体验！”）。</p>                                                                                                      |

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

上线后，确保您的计划按预期运行并处理任何遗留问题。

|    |                                                                                                                                                    |
| -- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 目标 | <p>• 验证数据完整性和奖励跟踪。</p><p>• 捕捉任何遗漏的转化。</p><p>• 支持并教育用户。</p>                                                                                         |
| 任务 | <p>• 验证推荐人/被推荐人关系在实时模式下是否正常工作。</p><p>• 导入切换期间发生的任何遗漏转化。</p><p>• 进行 QA 测试（自我推荐，确认跟踪和奖励逻辑）。</p><p>• 提供内部和外部的常见问题或帮助文档。</p><p>• 监控支持邮箱中与旧用户相关的问题。</p> |
| 提示 | <p>• 如果您正在停用旧的奖励资金账户，给用户一个宽限期来兑换。</p><p>• 使用电子邮件或应用内提醒来推动新计划中的早期推荐活动。</p>                                                                          |

</details>

#### 从可用选项中导入您计划的数据

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. 选择 *导入类型* ：

   | 导入类型     | 说明                                                                                       |
   | -------- | ---------------------------------------------------------------------------------------- |
   | 用户       | 选择此选项以上传新用户或现有用户数据。您也可以选择从不同账户或平台导入此数据。                                                  |
   | 更新用户奖励余额 | 选择此选项以更新并兑换用户奖励余额。                                                                       |
   | 用户事件     | 选择此选项以上传用户事件数据。                                                                          |
   | 删除用户     | <p>如果您想批量删除项目中的现有用户，请选择此选项。</p><p>您还可以删除用户处理并选择：</p><p>• 保留空账户</p><p>• 防止被删除的用户再次被创建</p> |
   | 奖励历史     | 选择此选项以上传所有奖励信息的记录。您也可以选择从不同账户或平台导入此数据。                                                   |
   | 推荐历史     | 选择此选项以上传所有推荐连接的记录。您也可以选择从不同账户或平台导入此数据。                                                   |
4. 选择 **选择文件** 或将您想要导入的文件拖放到此处。
5. 选择 **导入** 以上传您的数据。
   * 如果要批量删除现有用户，请选择 **批量删除**.

#### 验证错误参考

您可能会遇到 3 类验证错误：

1. **内联错误消息：** 这些会出现在预览验证表中并导致错误行以红色突出显示：

   * `INVALID_FIELD` — 例如， *创建日期* 字段未按 [自 Unix 纪元以来的毫秒数](https://currentmillis.com/) .
   * `格式化。` MISSING\_FIELD *用户 ID* 或 *账户 ID* — 例如，像

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-eb521fbbc452c243d6b3763ebcb90053b4e9e4dc%2Ff969fa535707c24f4913282d07287a546b348f2448bdb4ca2eef0a30c871fbb6.png?alt=media" alt=""><figcaption></figcaption></figure></div>
2. **这样的必填字段缺失。** 错误提示：

   * `这些会以红色警告消息替代预览验证表显示：` MISSING\_HEADER *账户 ID* 或 *奖励数值* — 例如，像
   * `— 例如，像` 这样的必需列标题缺失。
   * `CSV_PARSING` — 例如，CSV 文件包含格式不正确的特殊字符。

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9afd5a59441e6c97e033920161875e7cee1fd2e7%2Fc864941cfd589a88e11ae387f25173e7a9543504b234f8340a71b59c01ae2533.png?alt=media" alt=""><figcaption></figcaption></figure></div>
3. **FILE\_REF\_IO** — 例如，文件已损坏，无法读取。 *列出错误：* 这些会作为错误计数列表显示在 *报告* 导入与导出

   <div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a2c99edcc8f6f7080232fb391e6b8b5be6aa4226%2Fc8da480b7e5374d0d1b0fab59bda48e561fd813c46d91598b9d8f259d825b92c.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

#### 支持

屏幕的

* 部分中，当导入类型没有预览验证表时。行错误和文件错误将一起显示：
* 您不必独自应对迁移。我们的 Advocate 入职团队随时准备提供帮助，内容包括：
* 字段映射支持
* 数据格式化指导

奖励迁移策略 [测试与质量保证（QA）支持，或测试与 QA（保持原意）都可接受，保持简洁。](mailto:support-advocate@impact.com).
