从 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 纪元以来的毫秒数 .

   • MISSING_FIELD ——例如，某个必填字段，如 用户 ID 或 账户 ID 缺失。

   
2. 错误提示： 这些会以红色警告消息的形式显示在预览验证表的位置：

   • MISSING_HEADER ——例如，某个必需的列标题，如 账户 ID 或 奖励值 缺失。

   • CSV_PARSING ——例如，CSV 文件包含格式不正确的特殊字符。

   • FILE_REF_IO ——例如，文件已损坏且无法读取。
3. 列出错误： 这些会以错误计数列表的形式显示在 导入与导出 在导入类型没有预览验证表时的屏幕。行错误和文件错误会同时显示：

   1. 在左侧导航栏中，选择 [Engage] → Reporting.

   2. 选择 导入与导出 查看报告。