> 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 纪元以来的毫秒数 .
审核状态		推荐欺诈审核状态（例如， `PENDING`, `已处理`).
审核日期		推荐开始日期，格式为自 Unix 纪元以来的毫秒数 .
被推荐用户 - 奖励 ID		被推荐好友的奖励标识符。
推荐人 - 奖励 ID		客户倡导者的奖励标识符。
推荐人 - 分群		客户倡导者的用户分群。
referrerUserCustomFields.<fieldName>		客户倡导者的自定义字段。
使用的推荐码		用于该推荐的客户倡导者推荐码。
使用的分享链接		用于该推荐的客户倡导者分享链接。

奖励数据文件

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

#### 验证错误参考你可能会遇到 3 种验证错误： 1. **行内错误消息：** 这些会出现在预览验证表中，并导致错误行以红色高亮显示： * `INVALID_FIELD` ——例如， *创建日期* 字段未按以下格式设置 [自 Unix 纪元以来的毫秒数](https://currentmillis.com/) . * `MISSING_FIELD` ——例如，缺少某个必填字段，例如 *用户 ID* 或 *账户 ID* 。

2. **错误提示：** 这些会以红色警告消息的形式出现在预览验证表的位置： * `MISSING_HEADER` ——例如，缺少某个必填列标题，例如 *账户 ID* 或 *奖励金额* 。 * `CSV_PARSING` ——例如，CSV 文件包含格式不正确的特殊字符。 * `FILE_REF_IO` ——例如，文件已损坏，无法读取。

3. **列出的错误：** 这些会以错误数量列表的形式显示在 *导入与导出* 当导入类型没有预览验证表时的界面。行错误和文件错误将一起显示： 1. 在左侧导航栏中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[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 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-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 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.