> 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, ACTIONED).
审核日期推荐开始日期，格式为 自 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. **行内错误消息：** 这些会显示在预览验证表中，并使错误行以红色高亮显示： * `INVALID_FIELD` — 例如， *创建日期* 字段未按以下格式编写： [自 Unix 纪元起的毫秒数](https://currentmillis.com/) . * `MISSING_FIELD` — 例如，必填字段，例如 *用户 ID* 或 *账户 ID* 缺失。
2. **错误提示：** 这些会在预览验证表的位置显示为红色警告消息： * `MISSING_HEADER` — 例如，必需的列标题，例如 *账户 ID* 或 *奖励金额* 缺失。 * `CSV_PARSING` — 例如，CSV 文件包含格式不正确的特殊字符。 * `FILE_REF_IO` — 例如，文件已损坏，无法读取。
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 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.