> 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 时，你做的不只是导入数据——你是在借助强大的追踪、自定义体验和专家支持，升级你的计划潜力。本文将带你了解：

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

#### 为什么要制定战略性迁移计划？

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

* 将对推荐体验的干扰降到最低
* 保留历史数据并确保奖励连续性 ![](/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064)
* 顺利与旧系统彻底切割
* 以热度和清晰度重新推出你的推荐计划

![](/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064) 推荐和奖励迁移取决于你能否从当前系统导出数据。你的 Advocate 团队可以根据你提供的导出数据告诉你哪些是可行的。

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

#### 你需要做什么

* 导出你的计划的 *用户数据*, *推荐数据*，以及 *奖励数据*。你可以联系旧推荐平台上的 CSM 寻求帮助，或者使用平台内提供的导出工具。
* 将这 3 份数据报表分别下载为独立的 CSV 文件，例如： `user_data.CSV`, `referral_data.CSV`，以及 `reward_data.CSV`.
  * 请参阅下面的示例，了解每个 .csv 文件的内容可能是什么样子，或查看完整的目标字段参考。

这包括电子邮件、推荐码、分享链接 ![](/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064)，以及自定义字段。应过滤掉联盟伙伴，以避免重复奖励。

![](/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064) 取决于分享链接格式以及是否使用自定义子域名。

用户数据文件将包含计划中每位参与者的详细信息。导出参与者列表，以便用他们的分享链接和推荐码保持计划最新。

以下字段为 **必填**:

* 用户 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,邮箱,名,姓,创建日期,区域设置,国家代码,分段
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
推荐人用户,推荐人账户,被推荐用户,被推荐账户,推荐开始日期,转化日期,计划ID
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 美分）。如果奖励单位是现金，则应按以下格式包含货币代码 `<单位名称>/<货币>` （例如，现金/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,美元,现金/USD,1000,1000,1709712158000,1709712158000,1709712158000
User1@example.com,User1@example.com,User3@example.com,User3@example.com,积分,积分,100,100,1726164909682,1726164909682,1726164909682
User1@example.com,User1@example.com,User4@example.com,User4@example.com,积分,积分,100,100,1726164887075,1726164887075,1726164887075
User1@example.com,User1@example.com,User5@example.com,User5@example.com,积分,积分,100,100,1726164875888,1726164875888,1726164875888
User1@example.com,User1@example.com,User6@example.com,User6@example.com,积分,积分,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,,,积分,积分,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,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="/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064" alt="">.</p><p>• 在样本验证通过后导出完整数据集。导出的数据很可能需要进行处理（例如调整表头、字段名称或文件结构），以符合导入要求。</p><p>• 设定正式上线日期和回滚窗口。</p><p>• 以隐藏模式添加 Advocate 小组件（测试环境或未关联页面）。</p><p>• 配置必要的集成（例如 Shopify、HubSpot、Segment）。</p><p>• 在 Advocate 中完成计划配置（例如奖励设置、计划规则、电子邮件模板、分群）。</p><p>• 端到端测试计划功能——在上线前确认分享、转化和奖励能在测试环境中正确追踪。</p><p>• 起草消息，向推广者传达切换事宜。</p><p><img src="/files/77e26f076c2ac6eed6221bfb28afb75ed08ea064" 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. 从左侧导航菜单中选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage] → 报告 → 导入与导出**.
2. 在右上角，选择 ![](/files/32ff06d8ca86db17de89cf85fc91d85bffaf0a93) **导入**.
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="/files/d1c27a8441efd10e2373fc9eabca64dc1f65251d" alt="" width="375"><figcaption></figcaption></figure></div>
2. **错误提示：** 这些会以红色警告消息的形式出现在预览验证表的位置：

   * `MISSING_HEADER` ——例如，缺少某个必填列标题，例如 *账户 ID* 或 *奖励金额* 。
   * `CSV_PARSING` ——例如，CSV 文件包含格式不正确的特殊字符。
   * `FILE_REF_IO` ——例如，文件已损坏，无法读取。

   <div data-with-frame="true"><figure><img src="/files/aeca6470ffc35a0968fcc13c6a9388807c1759dd" alt="" width="563"><figcaption></figcaption></figure></div>
3. **列出的错误：** 这些会以错误数量列表的形式显示在 *导入与导出* 页面中的 *报告* 部分中，当导入类型没有预览验证表时显示。行错误和文件错误会同时显示：

   <div data-with-frame="true"><figure><img src="/files/7be67a4111ebb60ac3a8c47e7146381c04206c8d" alt="" width="563"><figcaption></figcaption></figure></div>

#### 支持

你不必独自完成迁移。我们的 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
