从 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 纪元起的毫秒数 .
   • MISSING_FIELD — 例如，必填字段，例如 用户 ID 或 账户 ID 缺失。

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

   • MISSING_HEADER — 例如，必需的列标题，例如 账户 ID 或 奖励金额 缺失。
   • CSV_PARSING — 例如，CSV 文件包含格式不正确的特殊字符。
   • FILE_REF_IO — 例如，文件已损坏，无法读取。

   
3. 列出的错误： 这些会以错误计数列表的形式显示在 导入与导出 屏幕上，当导入类型没有预览验证表时。行错误和文件错误会同时显示：

   1. 在左侧导航栏中，选择 [Engage] → 报告.
   2. 选择 导入与导出 以查看报告。