> 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 类型这可以是 Credit 或 % 折扣.
Fuel Tank Code这类似于优惠码，例如， 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. 在左侧导航栏中，选择 ![](/files/209022bdb234289211a24a980f6227a8684cc439) **\[Engage] → Reporting**. 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: ``` 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= ``` The question should be specific, self-contained, and written in natural language. 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.