> 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-referral-program-data-from-saasquatch.md). # 从 SaaSquatch 导入推荐项目数据本文提供了有用的参考资料，帮助你将推荐平台数据从 SaaSquatch 导入到 impact.com。 #### CSV 文件列参考

用户数据文件

列	必填	说明
用户 ID		参与者的标识符。
账户 ID		参与者的账户标识符。
电子邮件		参与者的电子邮件地址。
名字		参与者的名字。
姓氏		参与者的姓氏。
推荐代码		参与者的主计划推荐码（如果已指定）。
图片 URL		参与者的图片 URL。
首次记录 IP		参与者第一次执行非 API upsert 时的 IP 地址。
最近记录 IP		参与者最后一次执行非 API upsert 时的 IP 地址。
创建日期		该参与者用户的创建日期，格式为自 Unix 纪元以来的毫秒数 .
电子邮件哈希		参与者电子邮件地址的 MD5 哈希值。
区域设置		参与者的地理位置。
国家代码		参与者的国家/地区代码。
细分		参与者的用户细分。
分享链接		参与者的主计划（如果已指定）的分享链接。
Facebook 分享链接		参与者的主计划（如果已指定）的 Facebook 分享链接。
Twitter 分享链接		参与者的主计划（如果已指定）的 Twitter/X 分享链接。
电子邮件分享链接		参与者的主计划（如果已指定）的电子邮件分享链接。
LinkedIn 分享链接		参与者的主计划（如果已指定）的 LinkedIn 分享链接。
干净分享链接		参与者的主个性化链接，不含编码。
自定义字段		如果参与者有自定义字段， `{ExampleName}` 将作为字段名。

推荐数据文件

列	必填	说明
被推荐用户 - 用户 ID		被推荐好友的外部用户 ID。
被推荐用户 - 账户 ID		被推荐好友的外部账户 ID。
推荐人 - 用户 ID		推荐人的外部用户 ID。
推荐人 - 账户 ID		推荐人的外部账户 ID。
推荐 ID		该推荐的唯一标识符。
修改日期		推荐最后修改日期（即开始、转化、审核等），格式为自 Unix 纪元以来的毫秒数 .
推荐开始日期		推荐创建日期，格式为自 Unix 纪元以来的毫秒数 .
转化日期		首次达成第一个目标的日期，格式为自 Unix 纪元以来的毫秒数 .
用户修改日期		用户从推荐中删除（用户删除）或被添加到推荐中的日期，格式为自 Unix 纪元以来的毫秒数 .
项目 ID		创建该推荐所对应计划的标识符。
项目名称		创建该推荐所对应计划的名称。
被推荐用户 - 电子邮件		被推荐好友的电子邮件地址。
被推荐用户 - 名字		被推荐好友的名字。
被推荐用户 - 姓氏		被推荐好友的姓氏。
被推荐用户 - 推荐码		被推荐好友的主推荐码（取决于创建此推荐时所使用的计划。
被推荐用户 - 首次看到的 IP		被推荐好友加载组件时使用的第一个 IP 地址。
被推荐用户 - 最后看到的 IP		被推荐好友加载组件时使用的最新 IP 地址。
被推荐用户 - 图片 URL		被推荐好友的图片。
被推荐用户 - 区域设置		被推荐好友的区域设置。
被推荐用户 - 创建日期		被推荐好友首次被 SaaSquatch 看到（在 SaaSquatch 中创建）的日期，格式为自 Unix 纪元以来的毫秒数 .
被推荐用户 - 细分		被推荐好友的用户细分。
referredUserCustomFields.<fieldName>		被推荐好友的自定义字段。
推荐人 - 电子邮件		推荐人的电子邮件地址。
推荐人 - 名字		推荐人的名字。
推荐人 - 姓氏		推荐人的姓氏。
推荐人 - 推荐码		推荐人的主推荐码（例如，用于创建此推荐的推荐码）。
推荐人 - 首次看到的 IP		推荐人加载组件时使用的第一个 IP 地址。
推荐人 - 最后看到的 IP		推荐人加载组件时使用的最新 IP 地址。
推荐人 - 图片 URL		推荐人的图片。
推荐人 - 区域设置		推荐人的区域设置。
推荐人 - 创建日期		推荐人首次被 SaaSquatch 看到（在 SaaSquatch 中创建）的日期，格式为自 Unix 纪元以来的毫秒数 .
审核状态		推荐欺诈审核状态（例如， `待处理`, `已处理`).
审核日期		推荐开始日期，格式为自 Unix 纪元以来的毫秒数 .
被推荐用户 - 奖励 ID		被推荐好友的奖励标识符。
推荐人 - 奖励 ID		推荐人的奖励标识符。
推荐人用户 - 细分		推荐人的用户细分。
referrerUserCustomFields.<fieldName>		推荐人的自定义字段。
使用的推荐码		该推荐中使用的推荐人的推荐码。
使用的分享链接		该推荐中使用的推荐人的分享链接。

奖励数据文件

列	必填	说明
用户 ID		用户的标识符。
账户 ID		用户的账户标识符。
类型		该奖励类型例如，积分、折扣、礼品卡等。
奖励单位		奖励获得的单位，例如现金、积分、月数等。
奖励金额		奖励在最小计量单位中的数值，例如，现金奖励 1.00 美元时，其值为 100（美分）。
奖励名称		你在计划中创建该奖励时为其指定的名称。
美元价值		奖励的美元价值。
项目 ID		创建该奖励所对应计划的标识符。
全局奖励键		奖励目录中全局奖励配置的键。位于奖励 → 目录 → 创建奖励 → 奖励名称.
奖励来源		奖励是如何创建的，例如，手动, 被推荐用户, 好友注册.
创建日期		奖励获得日期，格式为自 Unix 纪元以来的毫秒数 .
发放日期		奖励发放日期，格式为自 Unix 纪元以来的毫秒数。（此值可能与创建日期如果奖励处于待处理状态）。
计划发放日期		奖励计划发放给用户的日期，格式为自 Unix 纪元以来的毫秒数 .
到期日期		奖励在该日期之后将无法再兑换，格式为自 Unix 纪元以来的毫秒数 .
取消日期		你取消奖励的日期，格式为自 Unix 纪元以来的毫秒数 .
修改日期		你修改奖励的日期，格式为自 Unix 纪元以来的毫秒数 .
兑换日期		用户兑换全部奖励的日期，格式为自 Unix 纪元以来的毫秒数 .
已分配积分		Credit 奖励的基础单位金额。这相当于奖励金额，但适用于 Credit 奖励。
已兑换金额		该数值已兑换奖励部分的
Fuel Tank 类型		这可以是积分或 % 折扣.
Fuel Tank 代码		这类似于优惠码，例如， SummerSave20, 20%OFF等。
被推荐用户 ID		被推荐好友的用户标识符。
被推荐账户 ID		被推荐好友的账户标识符。
referral.referredUser.id		与项目 ID 结合使用，以将推荐关联到 Program ID，如果我们想把推荐附加到奖励上。这不一定总是与用户 ID.
referral.referredUser.accountId		与项目 ID 结合使用，以将推荐关联到 Program ID，如果我们想把推荐附加到奖励上。这不一定总是与账户 ID.

#### 验证错误参考你会遇到 3 种类型的验证错误： 1. **行内错误消息：** 这些会显示在预览验证表中，并使错误行以红色高亮显示： * `无效字段` ——例如， *创建日期* 字段的格式不符合 [自 Unix 纪元以来的毫秒数](https://currentmillis.com/) . * `缺失字段` ——例如，诸如 *用户 ID* 或 *账户 ID* 之类的必填字段缺失。

2. **错误提示：** 这些会以红色警告消息的形式显示在预览验证表的位置： * `缺失表头` ——例如，诸如 *账户 ID* 或 *奖励金额* 之类的必填字段缺失。 * `CSV 解析` ——例如，CSV 文件包含格式不正确的特殊字符。 * `文件引用 I/O` ——例如，文件已损坏且无法读取。

3. **列出的错误：** 这些会在 *导入与导出* 界面上显示为错误计数列表，当导入类型没有预览验证表时。行错误和文件错误会同时显示： 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. 选择 **导入与导出** 以查看报告。 --- # 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-referral-program-data-from-saasquatch.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.