Advocate 项目报告说明

参加 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。对跟踪、调试或审计事件提交很有用。
事件键	事件的类型或标签，例如 购买, 注册，或您系统发送的任何自定义键。
用户 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	被推荐人的基本联系详情。
推荐者信息（倡导者）
referral.referrer User.id	提出推荐的人的 ID（“倡导者”）。
referral.referrer User.account Id	被推荐人的唯一帐户 ID。
referral.referrer User.first Name referral.referrer User.last Name referral.referrer User.email	被推荐人的基本联系详情。
referral.date Converted	推荐正式转化的日期（例如完成注册或购买），从而触发奖励。

推荐历史

该 推荐历史 报告提供了您推荐项目中每个推荐连接状态的记录。在检查项目成功情况和跟踪项目带来的新客户数量时，这些信息很有用。

报告详细信息

默认情况下，报告包含：

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

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

• 推荐状态

• 审核状态

• 奖励 ID

完整字段列表可在 下载我们的示例 CSV 推荐活动报告。

报告列参考

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

按用户的奖励余额

该 按用户的奖励余额 报告记录通过您的推荐项目生成的未结奖励，包括价值和预期接收人。此报告通常用于手动兑现奖励，或作为向像 Tango Card 之类系统批量处理的一部分。它也有助于跟踪推荐项目在特定时间段支付了多少。

报告详细信息

默认情况下，报告包含：

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

• 奖励类型

• 奖励单位

• 奖励金额

完整字段列表可在 下载我们的示例 CSV 奖励余额报告。

报告列参考

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

按用户的可用奖励余额

该 按用户的可用奖励余额 报告提供了未兑换奖励的列表。此类报告用于通过 批量奖励兑换 流程兑现奖励。

报告详细信息

默认情况下，报告包含：

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

• 奖励单位

• 奖励货币

• 可用金额

完整字段列表可在 下载我们的示例 CSV 在可用奖励余额报告中。

注意: 此报告不包括有关百分比折扣、Fuel Tank 或礼品卡奖励的详细信息。有关这些类型奖励的更多详细信息，请使用 按用户的奖励余额 报告。

报告列参考

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

美国 W-9 税务报告

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

报告详细信息

默认情况下，报告包含：

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

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

• 按税年计算的参与者所赚取奖励的美国应税价值

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

报告列参考

列	说明
参与者信息
用户 ID	Advocate 中参与者的唯一标识符。
帐户 ID	与参与者关联的内部账户 ID。
电子邮件	参与者的电子邮件地址。
名字	参与者的名字。
姓氏	参与者的姓氏。
W-9 税务信息
提交美国税表的日期 YYYY-MM-DD	参与者的 W-9 表格在 Advocate 中被标记为已提交并已收集的日期。对于符合美国国税局（IRS）要求并核实税务文件状态很重要。
税年汇总
年份	参与者赚取奖励的税务年度。用于按日历年对收益进行分组以便 1099 处理。
以分为单位的美国应税价值	在指定税年中该参与者所赚取的美国应税奖励总额，以分为单位表示（例如，2500 = $25.00）。有助于进行精确计算或与需要高精度的集成对接。
以美元为单位的美国应税价值	与上面相同，但以标准美元格式显示（例如，25.00）。便于审阅或包含在官方摘要中。
奖励计数	参与者在指定税年中获得的单个奖励实例的总数。对于审计记录或理解奖励频率与计划参与度很有用。

支付与税务

该 支付与税务 报告显示参与者的税务状态以及按年份的已赚取或待处理奖励。

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

报告详细信息

默认情况下，报告包含：

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

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

• 按税年计算的参与者所赚取奖励的美国应税价值

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

• 税表状态，例如， 有效, 暂停，或 待处理。报告中还包含支付暂停的原因

报告列参考

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