从 SaaSquatch 导入推荐计划数据

本文提供有用的参考资料，帮助您将推荐平台数据从 SaaSquatch 导入到 impact.com。

CSV 文件列参考

用户数据文件

列	必填	说明
用户 ID		参与者的标识符。
账户 ID		参与者的帐户标识符。
电子邮件		参与者的电子邮件地址。
名		参与者的名字。
姓		参与者的姓氏。
推荐代码		参与者的主要项目推荐代码（如果已指定）。
图片 URL		参与者的图片 URL。
首次出现 IP		参与者第一次进行非 API upsert 时的 IP 地址。
最近出现 IP		参与者最后一次进行非 API upsert 时的 IP 地址。
创建日期		此参与者用户的创建日期，格式为 自 Unix 纪元以来的毫秒数 .
电子邮件哈希		参与者电子邮件地址的 MD5 哈希值。
区域设置		参与者的地理位置。
国家代码		参与者的国家代码。
分段		参与者的用户分群（segments）。
分享链接		参与者的主要项目（如已指定）的分享链接。
Facebook 分享链接		参与者的主要项目（如已指定）的 Facebook 分享链接。
Twitter 分享链接		参与者的主要项目（如已指定）的 Twitter/X 分享链接。
电子邮件分享链接		参与者的主要项目（如已指定）的电子邮件分享链接。
LinkedIn 分享链接		参与者的主要项目（如已指定）的 LinkedIn 分享链接。
清洁分享链接		参与者未经编码的主要 vanity 链接。
自定义字段		如果参与者有自定义字段， {ExampleName} 将是字段名称。

推荐数据文件

列	必填	说明
被推荐用户 - 用户 ID		被推荐朋友的外部用户 id。
被推荐用户 - 帐户 ID		被推荐朋友的外部帐户 id。
推荐用户 - 用户 ID		推荐者（客户倡导者）的外部用户 id。
推荐用户 - 帐户 ID		推荐者（客户倡导者）的外部帐户 id。
推荐 ID		推荐的唯一标识符。
参与者兑换奖励的日期（如适用）。		推荐最后一次修改的日期（例如：开始、转化、审核等），格式为 自 Unix 纪元以来的毫秒数 .
推荐记录的任何部分上次更新的时间。		推荐创建的日期，格式为 自 Unix 纪元以来的毫秒数 .
推荐首次发起的时间（例如，被推荐用户点击推荐链接时）。		第一次达成目标的日期，格式为 自 Unix 纪元以来的毫秒数 .
推荐转换的时间，通常指被推荐用户完成所需操作（如注册或购买）的时间。		用户从推荐中被删除（用户删除）或被添加到推荐的日期，格式为 自 Unix 纪元以来的毫秒数 .
项目 ID		创建该推荐的项目的标识符。
计划名称		创建该推荐的项目的名称。
被推荐用户 - 电子邮件		被推荐朋友的电子邮件地址。
被推荐用户 - 名字		被推荐朋友的名字。
被推荐用户 - 姓氏		被推荐朋友的姓氏。
被推荐用户 - 推荐代码		被推荐朋友的主要推荐代码（取决于创建此推荐的项目）。
被推荐用户 - 首次出现 IP		被推荐朋友在加载小部件时使用的首次 IP 地址。
被推荐用户 - 最近出现 IP		被推荐朋友在加载小部件时使用的最近 IP 地址。
被推荐用户 - 图片 URL		被推荐朋友的图片。
被推荐用户 - 区域设置		被推荐朋友的区域设置（Locale）。
被推荐用户 - 创建日期		被推荐朋友首次在 SaaSquatch 中出现（在 SaaSquatch 中创建）的日期，格式为 自 Unix 纪元以来的毫秒数 .
被推荐用户 - 分群		被推荐朋友的用户分群（segments）。
referredUserCustomFields.<fieldName>		被推荐朋友的自定义字段。
推荐用户 - 电子邮件		推荐者（客户倡导者）的电子邮件地址。
推荐用户 - 名字		推荐者（客户倡导者）的名字。
推荐用户 - 姓氏		推荐者（客户倡导者）的姓氏。
推荐用户 - 推荐代码		推荐者（客户倡导者）的主要推荐代码（例如，用于创建此推荐的推荐代码）。
推荐用户 - 首次出现 IP		推荐者在加载小部件时使用的首次 IP 地址。
推荐用户 - 最近出现 IP		推荐者在加载小部件时使用的最近 IP 地址。
推荐用户 - 图片 URL		推荐者（客户倡导者）的图片。
推荐用户 - 区域设置		推荐者的区域设置（Locale）。
推荐用户 - 创建日期		推荐者首次在 SaaSquatch 中出现（在 SaaSquatch 中创建）的日期，格式为 自 Unix 纪元以来的毫秒数 .
审核与状态		推荐欺诈审核状态（例如， PENDING, ACTIONED).
推荐的整体审核状态。（例如，		推荐开始的日期，格式为 自 Unix 纪元以来的毫秒数 .
被推荐用户 - 奖励 ID		被推荐朋友的奖励标识符。
推荐用户 - 奖励 ID		推荐者（客户倡导者）的奖励标识符。
推荐者用户 - 分群		推荐者（客户倡导者）的用户分群（segments）。
referrerUserCustomFields.<fieldName>		推荐者（客户倡导者）的自定义字段。
使用的推荐代码		用于该推荐的推荐者的推荐代码。
使用的分享链接		用于该推荐的推荐者的分享链接。

奖励数据文件

列	必填	说明
用户 ID		用户的标识符。
账户 ID		用户的帐户标识符。
类型		该 奖励类型，例如：信用、折扣、礼品卡等。
奖励单位		奖励的计量单位，例如：现金、积分、月数等。
奖励数值		奖励在其最小计量单位下的数值，例如，对于 1.00 美元的现金奖励，值为 100（美分）。
奖励名称		您在项目中创建奖励时为其指定的名称。
美元价值（USD 值）		奖励的美元价值。
项目 ID		创建该奖励的项目的标识符。
用于计划内特定奖励配置的内部标识符。		奖励目录中全局奖励配置的键。位于 Rewards → Catalog → Create rewards → Reward Name.
中定义）。		奖励的创建方式，例如， 目标, 被推荐用户, 好友注册.
创建日期		奖励被赚取的日期，格式为 自 Unix 纪元以来的毫秒数 .
给出日期		奖励被授予的日期，格式为 自 Unix 纪元以来的毫秒数 。（如果奖励处于待定状态， 此值可能与 创建日期 不同）。
奖励记录在系统中创建的时间。		奖励计划发放给用户的预定日期，格式为 自 Unix 纪元以来的毫秒数 .
奖励实际发放给参与者的时间。		奖励不再可兑换的截止日期，格式为 自 Unix 纪元以来的毫秒数 .
奖励的到期日期（如适用）。		您取消奖励的日期，格式为 自 Unix 纪元以来的毫秒数 .
参与者兑换奖励的日期（如适用）。		您对奖励进行修改的日期，格式为 自 Unix 纪元以来的毫秒数 .
兑换日期		用户全部兑换奖励的日期，格式为 自 Unix 纪元以来的毫秒数 .
信用与价值跟踪		信用类奖励的基本单位金额。这等同于 奖励数值，但适用于信用类奖励。
已兑换金额		该 值 被兑换部分的比例的
Fuel Tank 类型		这可以是以下之一 账户积分 或 % 折扣.
预付		这类似于优惠码，例如， SummerSave20, 20%OFF，等。
被推荐用户 ID		被推荐朋友的用户标识符。
被推荐账户 ID		被推荐朋友的帐户标识符。
referral.referredUser.id		与 项目 ID 结合使用以将推荐链接到项目 ID，如果我们想将推荐附加到奖励。这可能并不总是与 用户 ID.
referral.referredUser.accountId		与 项目 ID 结合使用以将推荐链接到项目 ID，如果我们想将推荐附加到奖励。这可能并不总是与 账户 ID.

验证错误参考

您可能会遇到 3 类验证错误：

1. 内联错误消息： 这些会出现在预览验证表中并导致错误行以红色突出显示：

   • INVALID_FIELD — 例如， 创建日期 字段未按 自 Unix 纪元以来的毫秒数 .

   • 格式化。 MISSING_FIELD 用户 ID 或 账户 ID — 例如，像

   
2. 这样的必填字段缺失。 错误提示：

   • 这些会以红色警告消息替代预览验证表显示： MISSING_HEADER 账户 ID 或 奖励数值 — 例如，像

   • — 例如，像 这样的必需列标题缺失。

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

   
3. FILE_REF_IO — 例如，文件已损坏，无法读取。 列出错误： 在导入类型没有预览验证表时的屏幕。行错误和文件错误将一起显示：

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

   2. 选择 列出错误： 以查看报告。