拥护者计划报告说明

参加 PXA 课程

Advocate 为您的计划和参与者数据提供各种可下载的报告。所有报告都具有筛选选项，让您更好地控制下载的数据。每个报告都可以作为 .CSV 或 Excel 文件下载。

本文说明了不同报告以及每种报告包含的数据类型。请参阅 运行 Advocate 计划报告 以获取生成报告的说明。

用户详细信息报告

该 用户详细信息 报告包含有关您所有计划中每个参与者的详细信息。导出所有参与者的列表以使用 Advocate 共享链接和推荐代码保持记录最新。

报告详细信息

默认情况下，报告将包括参与者信息，例如：

• 名称

• 用户和账户 ID

• 电子邮件地址

• 自定义字段

• 分段

• 推荐信息（如适用）

生成报告时，您也可以选择包括：

• 用户统计，包括有关参与者的分析信息，例如流量、收入等。

• 推荐分享链接和代码，如适用。此信息在将每位参与者的 Advocate 分享链接和代码包含到您的 CMS 或电子邮件系统的联系人记录更新中可能很有帮助。

完整字段列表可在 下载我们的示例 CSV 用户详细信息报告时找到。

报告列参考

列	说明
用户信息
ID	参与者在 Advocate 系统中的唯一标识符。
账户 ID	参与者帐户的唯一标识符（如适用，可在多个计划中使用）。
电子邮件	参与者的电子邮件地址。
名	参与者的名字。
姓	参与者的姓氏。
电子邮件哈希	参与者电子邮件的哈希（加密）版本，有助于与其他系统进行符合隐私的匹配。
推荐与分享信息
推荐代码	与参与者相关的唯一代码，用于跟踪他们产生的推荐。
分享链接	与参与者关联的唯一推荐链接。
Facebook 分享链接	用于在 Facebook 上分享推荐的预生成链接。
Twitter 分享链接	用于在 Twitter 上分享推荐的预生成链接。
电子邮件分享链接	用于通过电子邮件分享推荐的预生成链接。
LinkedIn 分享链接	用于在 LinkedIn 上分享推荐的预生成链接。
清洁分享链接	不带跟踪参数的推荐链接版本；在某些平台或用例中更中性。
地理位置与区域设置
首次出现 IP	记录到参与者的首次 IP 地址。
最近出现 IP	为该参与者记录的最新 IP 地址。
区域设置	参与者的首选语言和区域设置（例如，en-US）。
国家代码	基于区域设置或 IP 地址的参与者国家（例如 ZA、US）。
时间戳
创建日期	参与者帐户在 Advocate 中创建的日期和时间。
美国税表提交日期	（如适用）用于合规或奖励处理的美国税表提交日期。
用户统计（如果包含在导出中）
stats.date Modified	参与者统计最后更新的日期。
stats.traffic	参与者推荐活动所带来的总访问次数。
stats.referrals	参与者所产生的成功推荐总数。
stats.conversions	由这些推荐产生的转换（例如购买、注册）总数。
stats.goals	与参与者推荐活动相关的特定目标完成次数（在计划中自定义定义）。
stats.rewards	参与者获得的奖励总数。
stats.widget Loads	该参与者加载推荐小部件或分享界面的次数。
stats.revenue	由该参与者推荐的用户所产生的总收入。
stats.generated Revenue	与 stats.revenue 同义；某些报告可能会区分收入是否来自多个来源。
stats.referred Revenue	特定归因于通过该参与者的推荐链接注册或购买的参与者所产生的收入。
自定义数据
custom Fields.example	由您的计划定义的任何自定义字段的占位符（例如， 忠诚度 ID, 内部备注, 地区标签）。每个字段将作为其自己的列出现，前缀为 custom Fields。
其他
推荐来源	将参与者引导到您计划的原始来源或渠道（例如， 自然流量, 高级组件允许您包含基于参与者的条件内容，例如, 合作伙伴站点).

用户事件导出

该 用户事件导出 报告提供我们从您的组织为您的 Advocate 计划收到的所有用户事件的记录。您可以应用筛选器以缩小时间范围、事件键、用户 ID 等。

报告详细信息

默认情况下，报告包含：

• 事件 ID

• 事件键

• 用户和账户 ID

• 触发日期

• 接收日期

• 处理日期

报告列参考

列	说明
事件和用户信息
事件 ID	为每个接收的事件生成的唯一 ID。用于跟踪、调试或审计事件提交。
事件键	事件的类型或标签，例如 purchase, 注册，或您系统发送的任何自定义定义键。
用户 ID	事件关联的 Advocate 中参与者的唯一标识符。
账户 ID	与用户相关的帐户 ID，尤其在用户可能属于不同帐户结构的计划中相关。
事件时间戳
事件触发日期 – YYYY-MM-DD	事件实际发生的日期（由您的系统报告）。例如发生购买或注册的日期。
事件接收日期 – YYYY-MM-DD	Advocate 从您的系统接收该事件的日期。由于批处理或系统延迟，可能与触发日期不同。
事件处理日期 – YYYY-MM-DD	事件在 Advocate 中成功处理并存储的日期。标志着该事件可用于跟踪、奖励或报告的时间。
事件数据字段（如果包含在您的事件有效负载中）
fields.coupon	在事件数据中发送时应用的任何优惠券或折扣代码。用于跟踪激励使用或特定促销触发器。
fields.revenue	与事件相关的收入金额。通常用于购买事件以计算绩效、奖励或投资回报率。
fields.currency	与收入金额相关的货币代码（例如， 美元（USD）, 南非兰特（ZAR）, 欧元（EUR））。在跨区域报告或计算汇率调整后的奖励时很重要。
fields.lead Created Date	如果作为事件的一部分提交，表示线索（用户）在您系统中创建的原始日期。帮助将用户事件与原始获取日期或 CRM 记录关联起来。

奖励历史

该 奖励历史 报告提供每个奖励及其与参与者和推荐关系的详细记录。此信息可用于创建资产负债表，以及获取某一时间点所有奖励的状态。

报告详细信息

默认情况下，报告将包括 奖励字段 等信息：

• 奖励 ID

• 奖励类型

• 奖励数值

完整的包含字段列表可在 下载我们的示例 CSV, 示例 Excel 或 示例 JSONL 奖励详情报告中找到。

生成报告时，您也可以选择包括：

• 参与者详情 如名称、用户和账户 ID、电子邮件地址、自定义字段、细分和推荐信息（如适用）。

• 推荐字段 如推荐 ID、客户倡导者字段、被推荐好友字段等更多信息。

报告列参考

列	说明
奖励信息
ID	奖励实例的唯一 ID（由 Advocate 生成）。
类型	奖励类别或类型（例如， 现金, 礼品卡, 优惠券, 自定义).
值	奖励的数值（例如 10、100 等）。
单位	与数值相关的单位（例如， 美元（USD）, 积分, 南非兰特（ZAR）, %).
名称	奖励的显示名称（在 奖励配置).
中定义）。	奖励来源 推荐, 描述触发奖励的原因（例如，, 目标, API).
Fuel Tank 类型	手动 所使用的奖励资金类型（如果使用 FuelTank 集成）。例如，, 礼品卡.
预付	Fuel Tank 代码
项目 ID	与外部履行相关的代码（例如凭证或礼品卡代码）。
发放奖励的 Advocate 计划的 ID。	计划奖励键
用于计划内特定奖励配置的内部标识符。	全局奖励键
在全局级别配置的奖励的跨计划标识符（如适用）。
创建日期	奖励时间戳
奖励记录在系统中创建的时间。	计划发放日期
给出日期	奖励实际计划发放的时间（例如，在延迟或等待期后）。
奖励实际发放给参与者的时间。	到期日期
奖励的到期日期（如适用）。	取消日期
兑换日期	奖励被作废或取消的日期。
参与者兑换奖励的日期（如适用）。	修改日期
对奖励记录进行最近更新的日期。
信用与价值跟踪	分配的信用
分配给此奖励的信用金额（在某些模型中可能与价值不同）。	已兑换的信用
已从奖励中兑换的信用金额。	可用价值
奖励剩余的未使用或未兑换部分。
奖励状态与信息	状态 待处理, 已安排, 奖励的当前状态（例如，, 已到期, 已发放).
已取消	meta.status
技术或系统级状态（用于诊断或错误处理）。	meta.message
与奖励发放相关的信息（例如，“奖励已成功发放”）。	meta.internal Message
仅供管理员内部使用的备注（例如失败说明或标记）。	meta.date Modified
最后一次更新与奖励相关的元数据的时间。	meta.customMeta.testMeta
您的计划发送的任何自定义元数据字段的占位符（在此示例中，testMeta 是一个示例）。
参与者（用户）信息	user.id
接收奖励的用户 ID。	user.account Id
用户在 Advocate 中关联的账户 ID。 user.first Name user.last Name	user.email
用于参考或 CRM 匹配的基本参与者信息。
推荐上下文（如果奖励基于推荐）	referral.id
触发此奖励的推荐 ID。	referral.date Referral Started
推荐行为开始的时间（例如点击或分享事件）。	referral.date Modified
推荐记录上次更新的时间。	referral.referral Code Used
被推荐用户用于加入或采取行动的代码。
被推荐用户信息（好友）	referral.referred User.id
被推荐者（“好友”）的 ID。	referral.referred User.account Id
被推荐者的唯一账户 ID。 referral.referred User.first Name referral.referred User.last Name	referral.referred User.email
被推荐者的基本联系信息。
推荐者信息（Advocate）	referral.referrer User.id
提出推荐者（“倡导者”）的 ID。	referral.referred User.account Id
referral.referrer User.account Id referral.referrer User.first Name referral.referrer User.last Name	referral.referred User.email
referral.referrer User.email	referral.date Converted

推荐正式转换的日期（例如完成注册或购买），从而触发奖励。

该 推荐正式转换的日期（例如完成注册或购买），从而触发奖励。 推荐历史

报告详细信息

默认情况下，报告包含：

• 报告记录了在您的推荐计划中创建的每个推荐连接的状态。当检查您的计划成功程度并跟踪计划带来的新客户数量时，此信息很有用。

• 被推荐好友的详细信息，如姓名、用户和账户 ID、电子邮件地址等

• 客户倡导者的详细信息，如姓名、用户和账户 ID、电子邮件地址等

• 推荐状态

• 审核状态

完整字段列表可在 下载我们的示例 CSV 奖励 ID

报告列参考

列	说明
推荐活动报告。
ID	推荐元数据
参与者兑换奖励的日期（如适用）。	Advocate 中推荐记录的唯一标识符。
推荐记录的任何部分上次更新的时间。	推荐开始日期
推荐首次发起的时间（例如，被推荐用户点击推荐链接时）。	转换日期
推荐转换的时间，通常指被推荐用户完成所需操作（如注册或购买）的时间。	用户修改日期
项目 ID	与此推荐相关的用户数据（推荐者或被推荐者）上次更新的时间。
计划名称	此推荐所属的 Advocate 推荐计划的 ID。
推荐计划的名称，在管理多个计划时很有用。
被推荐好友（新客户）信息 被推荐用户电子邮件 被推荐用户名	被推荐用户姓
被推荐用户的基本身份信息。	被推荐用户推荐代码
分配给被推荐用户的推荐代码（以防他们以后也能推荐他人）。 被推荐用户首次出现 IP	被推荐用户最近出现 IP
记录被推荐用户首次和最近活动时的 IP 地址。	被推荐用户图片 URL
如果捕获或分配给被推荐用户，则为图像或头像 URL。	被推荐用户区域设置 语言/区域设置（例如，, en-USfr-FR
）的被推荐用户。	被推荐用户创建日期
被推荐用户帐户在 Advocate 中创建的日期。	被推荐用户
被推荐用户在 Advocate 系统中的内部 ID。	被推荐账户
与被推荐用户关联的内部账户 ID（用于多账户计划）。
推荐者（客户倡导者）信息 推荐者用户电子邮件 推荐者用户名	推荐者用户姓
推荐参与者的基本身份信息。	推荐者用户推荐代码
属于推荐者的推荐代码，即被推荐用户很可能使用的代码。 推荐者用户首次出现 IP	推荐者用户最近出现 IP
记录推荐者首次和最近活动时的 IP 地址。	推荐者用户图片 URL
推荐者的图像或头像的 URL。	推荐者用户区域设置
推荐者的区域设置。	推荐者用户创建日期
推荐者首次加入或在系统中记录的时间。	推荐者用户
推荐者在 Advocate 中的内部 ID。	推荐者账户
与推荐者关联的账户 ID。
审核与状态	审核状态 已批准, 已拒绝, 待处理.)
推荐的整体审核状态。（例如，	审核日期
做出审核决定（批准/拒绝）的日期。	推荐付款日期
与推荐相关的任何奖励何时发放。	推荐结束日期
何时正式关闭推荐记录（例如因到期或完成）。	被推荐者审核状态
特定于被推荐用户在推荐中部分的审核状态。	推荐者审核状态
特定于推荐者在推荐中部分的审核状态。
奖励引用	被推荐奖励
发放给被推荐用户的奖励 ID 或引用（如适用）。	推荐者奖励

发放给推荐者的奖励 ID 或引用（如适用）。

该 发放给推荐者的奖励 ID 或引用（如适用）。 按用户的奖励余额

报告详细信息

默认情况下，报告包含：

• 报告提供未结奖励的记录，包括通过您的推荐计划生成的价值和预定接收人。此报告通常用于手动履行奖励，或作为向诸如 Tango Card 之类系统批量处理的一部分。它也可用于跟踪推荐计划在给定时期内支付了多少。

• 参与者详细信息，如姓名、用户和账户 ID、电子邮件地址等

• 奖励类型

• 奖励单位

完整字段列表可在 下载我们的示例 CSV 奖励金额

报告列参考

列	说明
奖励余额报告。
用户 ID	参与者信息
账户 ID	参与者在 Advocate 中的唯一标识符。用于将奖励余额与个人用户关联。
电子邮件	与参与者关联的内部账户 ID。尤其在用户属于组织或分段账户组时相关。
名 姓	参与者的电子邮件地址。常用于手动奖励履行或与外部系统同步。
推荐代码	参与者的名和姓。用于个性化或在奖励处理期间进行筛选。
奖励信息
类型	分配给参与者的推荐代码。这是他们用来推荐他人并跟踪奖励资格的代码。 现金, 礼品卡, 积分, 自定义奖励的类别或方式（例如，
单位	）。有助于确定奖励应如何履行或分组。 美元（USD）, 南非兰特（ZAR）, 积分, %奖励数值的单位（例如，
金额	）。对计算余额和处理区域性支付很重要。
此用户未结奖励的总可用余额。这是在准备支付或导出时使用的核心数字。	已分配总信用
已分配给该用户的总信用金额（无论是否已兑换）。反映分配给该参与者的整体计划成本。	已兑换总信用
该参与者已兑换的奖励总额。用于审计实际成本与负债。	已过期总信用
分配给用户但在兑换前过期的奖励总额。帮助追踪未认领奖励或失去的履行机会。
用户元数据	图片 URL
首次出现 IP	参与者的个人资料图片或头像 URL（如果收集）。主要用于视觉或在面向用户的仪表板中使用（如适用）。
最近出现 IP	参与者首次被添加或变为活跃时记录的第一个 IP 地址。用于合规、位置标记或欺诈分析。
创建日期	与参与者关联的最新 IP 地址。帮助判断用户是否仍然活跃或参与度如何。
推荐来源	参与者帐户在 Advocate 中创建的日期。用于队列分析或随时间的奖励行为分析。 高级组件允许您包含基于参与者的条件内容，例如, 自然流量, 合作伙伴参与者被获取的原始来源或渠道（例如，
区域设置	）。有助于评估按渠道划分的推荐计划覆盖范围和有效性。 语言/区域设置（例如，, en-US参与者的语言和区域设置（例如，

按用户列出的可用奖励余额

该 按用户列出的可用奖励余额 ）。对个性化通信或区域性奖励选项很重要。 报告提供未兑换奖励的列表。此报告类型旨在作为通过 批量奖励兑换

报告详细信息

默认情况下，报告包含：

• 报告提供未结奖励的记录，包括通过您的推荐计划生成的价值和预定接收人。此报告通常用于手动履行奖励，或作为向诸如 Tango Card 之类系统批量处理的一部分。它也可用于跟踪推荐计划在给定时期内支付了多少。

• 奖励类型

• 流程履行奖励的一部分使用。

• 奖励货币

完整字段列表可在 下载我们的示例 CSV 可用金额

注意在可用奖励余额报告中。 发放给推荐者的奖励 ID 或引用（如适用）。 ：此报告不包含有关百分比折扣、Fuel Tank 或礼品卡奖励的详细信息。有关这些类型奖励的更多详细信息，请使用

报告列参考

列	说明
奖励余额报告。
名	报告。
姓	参与者的姓氏。
电子邮件	参与者的名，用于在奖励处理期间识别或个性化。
用户 ID	参与者的电子邮件地址，用于发送奖励或与 CRM 或奖励提供商等外部系统匹配。
账户 ID	分配给参与者的唯一标识符（在 Advocate 中）。
分段	与参与者关联的内部账户 ID。 用于 （例如， 按区域对参与者进行分组, 生命周期阶段, 客户类型）。有助于筛选或应用不同的履行规则。
奖励状态与时机
阻止日期	用户被阻止接收奖励的日期（如适用）。被阻止状态可能会阻止兑换；此字段指示应用阻止的时间。
奖励数据
单位名称	奖励单位的标签或显示名称（例如， 推荐现金, 商店积分）。这有助于区分计划可能提供的多种奖励类型。
货币	奖励价值的货币代码（例如， 美元（USD）, 南非兰特（ZAR）, 欧元（EUR））。在履行奖励时需要，特别是跨国或支付系统。
已从奖励中兑换的信用金额。	当前该参与者可以使用的未兑换奖励金额。这是在确定支付金额时使用的核心价值。
待兑换价值	当前排队待兑换的价值（例如，在批量履行中待处理或待处理）。有助于防止重复兑换或确保兑换不重叠。
已兑换总价值	该参与者已兑换的奖励总价值。提供对过去兑换的洞察，并可用于奖励上限跟踪
单位	奖励单位的内部或系统代码（例如， 美元（USD）, 积分，等）。可能在 API 调用或履行期间的内部逻辑中使用。

美国 W-9 税务报告

美国 W-9 税务报告显示参与者的美国 W-9 税务状态以及按年度计算的已赚取或待定奖励。

报告详细信息

默认情况下，报告包含：

• 报告提供未结奖励的记录，包括通过您的推荐计划生成的价值和预定接收人。此报告通常用于手动履行奖励，或作为向诸如 Tango Card 之类系统批量处理的一部分。它也可用于跟踪推荐计划在给定时期内支付了多少。

• 参与者的 W-9 表格被标记为已收集的日期

• 每个税年的参与者已赚取的美国应税奖励价值

• 每位参与者在税年中获得的奖励总次数

报告列参考

列	说明
奖励余额报告。
用户 ID	参与者在 Advocate 中的唯一标识符。
账户 ID	与参与者关联的内部账户 ID。
电子邮件	参与者的电子邮件地址。
名	参与者的名字。
姓	参与者的姓氏。
W-9 税务信息
美国税表提交日期 YYYY-MM-DD	在 Advocate 中将参与者的 W-9 表格标记为已提交并已收集的日期。对于 IRS 合规性和验证税务文件状态非常重要。
税年汇总
发生度量的日历年第几周。基于日历年或品牌设置的自定义报告日历。	参与者获得奖励的税年。用于按日历年对收入进行分组以处理 1099。
以分为单位的美国应税价值	指定税年内该参与者获得的美国应税奖励总额，以分为单位表示（例如 2500 = $25.00）。有助于需要精确度的原始计算或集成。
以美元为单位的美国应税价值	与上述相同，但以标准美元格式显示（例如 25.00）。便于审查或纳入官方摘要。
奖励计数	该参与者在指定税年获得的单个奖励实例的总数。用于审计记录或了解奖励频率和计划参与度。

付款与税务

该 付款与税务 报告显示参与者的税务状态以及按年度计算的已赚取或待定奖励。

如果您的计划向参与者提供现金支付，则与参与者税表状态相关的某些字段将变为可用。

报告详细信息

默认情况下，报告包含：

• 报告提供未结奖励的记录，包括通过您的推荐计划生成的价值和预定接收人。此报告通常用于手动履行奖励，或作为向诸如 Tango Card 之类系统批量处理的一部分。它也可用于跟踪推荐计划在给定时期内支付了多少。

• 参与者的税表（如 W-8 或 W-9）被标记为已提交的日期

• 每个税年的参与者已赚取的美国应税奖励价值

• 每位参与者在税年中获得的奖励总次数

• 税表状态，例如 有效, 暂停支付，或 动作数量总计。。支付暂停的原因也包含在报告中

报告列参考

列	说明
奖励余额报告。
用户 ID	参与者在 Advocate 中的唯一标识符。
账户 ID	参与者的账户 ID，用于分组或组织报告。
电子邮件	参与者的电子邮件地址。
名	参与者的名字。
姓	参与者的姓氏。
W-9 税务信息
美国税表提交日期 YYYY-MM-DD	参与者提交其 W-9（或相关美国税务）表格的日期。对于在发放现金支付之前核实税务资格很重要。
支付年度汇总
发生度量的日历年第几周。基于日历年或品牌设置的自定义报告日历。	参与者获得奖励的日历年。
值	该参与者在该年获得或待处理的以小单位（例如分）计的支付总额。例如，1750 = $17.50。
美元金额	相同数值，以标准货币格式显示以便于查看（例如，17.50）。
数量	指定年份内参与者的单个支付奖励实例的总数。用于了解参与者获得支付的频率。
支付资格与状态
支付暂停	指示参与者的支付当前是否处于暂停状态（是或否）。支付可能因缺少税表或未完成设置而被暂停。
支付暂停原因	解释参与者为什么被暂停支付（如适用）。示例原因： 缺少税务表格, 未提供银行信息, 合规审核.
支付货币	参与者的支付正在或将以其处理的货币（例如， 美元（USD）, 欧元（EUR）, 南非兰特（ZAR））。这对于全球支付系统和会计很重要。
已开始设置支付	指示参与者是否已开始设置其支付方式（例如，通过支付供应商集成）。有助于跟踪入职进度或对待处理支付的后续需求。