> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).

# Advocate 计划报告详解

<a href="https://pxa.impact.com/student/activity/1687872?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=&#x26;utm_campaign=help-center" class="button primary">参加 PXA 课程</a>

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

本文将说明不同的报告以及每种报告包含的数据类型。请参阅 [生成 Advocate 计划报告](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/run-an-advocate-program-report.md) 以了解生成报告的说明。

#### 用户详情报告

该 *用户详情* 报告包含您所有计划中每位参与者的详细信息。导出所有参与者列表，可让您的记录与 Advocate 分享链接和推荐码保持最新。

<details>

<summary>报告详情</summary>

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

* 名称
* 用户和账户 ID
* 电子邮件地址
* 自定义字段
* 分群
* 推荐信息（如适用）

生成报告时，您还可以选择包含：

* **用户统计**，其中包括参与者的分析信息，如流量、收入等。
* **推荐分享链接和代码**，如适用。此信息有助于更新您 CMS 或电子邮件系统中的联系人记录，以包含每位参与者的 Advocate 分享链接和代码。

字段完整列表可在以下位置找到： [下载我们的示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7Am85AH6wmNdArmjRNW3vr/95f52c5d79311509d795a0be4c94166f/User_Details_Report_Sample.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 用户详情报告。

**报告列参考**

| 列                  | 说明                                                                                        |
| ------------------ | ----------------------------------------------------------------------------------------- |
| **用户信息**           |                                                                                           |
| ID                 | 参与者在 Advocate 系统中的唯一标识符。                                                                  |
| 账户 ID              | 参与者账户的唯一标识符（如适用，可在多个计划中通用）。                                                               |
| 电子邮件               | 参与者的电子邮件地址。                                                                               |
| 名字                 | 参与者的名字。                                                                                   |
| 姓氏                 | 参与者的姓氏。                                                                                   |
| 电子邮件哈希值            | 参与者电子邮件的哈希（加密）版本，适用于与其他系统进行符合隐私要求的匹配。                                                     |
| **推荐与分享信息**        |                                                                                           |
| 推荐码                | 与参与者关联的唯一代码，用于跟踪其发起的推荐。                                                                   |
| 分享链接               | 与该参与者关联的唯一推荐链接。                                                                           |
| Facebook 分享链接      | 用于在 Facebook 上分享推荐的预生成链接。                                                                 |
| Twitter 分享链接       | 用于在 Twitter 上分享推荐的预生成链接。                                                                  |
| 电子邮件分享链接           | 用于通过电子邮件分享推荐的预生成链接。                                                                       |
| LinkedIn 分享链接      | 用于在 LinkedIn 上分享推荐的预生成链接。                                                                 |
| 无跟踪参数分享链接          | 不含跟踪参数的推荐链接版本；对于某些平台或使用场景更为中性。                                                            |
| **地理位置与区域设置**      |                                                                                           |
| 首次记录的 IP           | 首次记录该参与者时所使用的 IP 地址。                                                                      |
| 最近记录的 IP           | 该参与者最近一次记录到的 IP 地址。                                                                       |
| 区域设置               | 参与者偏好的语言和区域设置（例如 en-US）。                                                                  |
| 国家代码               | 根据区域设置或 IP 地址确定的参与者所在国家（例如 ZA、US）。                                                        |
| **时间戳**            |                                                                                           |
| 创建日期               | 参与者账户在 Advocate 中创建的日期和时间。                                                                |
| 美国税务表提交日期          | （如适用）提交美国税务表以用于合规或奖励处理的日期。                                                                |
| **用户统计（如导出中包含）**   |                                                                                           |
| stats.date 修改日期    | 参与者统计数据最近一次更新的日期。                                                                         |
| stats.traffic      | 由参与者推荐活动带来的总访问次数。                                                                         |
| stats.referrals    | 参与者成功推荐的总次数。                                                                              |
| stats.conversions  | 由这些推荐带来的转化总数（例如购买、注册）。                                                                    |
| stats.goals        | 与参与者推荐活动相关的特定目标完成次数（在计划中自定义定义）。                                                           |
| stats.rewards      | 参与者获得的奖励总数。                                                                               |
| stats.widget 加载次数  | 该参与者加载推荐组件或分享界面的次数。                                                                       |
| stats.revenue      | 由该参与者推荐的用户产生的总收入。                                                                         |
| stats.generated 收入 | 与 stats.revenue 同义；如果收入来自多个来源，某些报告可能会区分。                                                  |
| stats.referred 收入  | 专门归因于通过该参与者的推荐链接注册或购买的用户所产生的收入。                                                           |
| **自定义数据**          |                                                                                           |
| custom Fields.示例   | 用于表示您的计划中定义的任何自定义字段的占位符（例如 *会员 ID*, *内部备注*, *区域标签*）。每个字段都会作为单独的列显示，并以 custom Fields. 为前缀。 |
| **其他**             |                                                                                           |
| 推荐来源               | 将参与者带入您的计划的原始来源或渠道（例如 *自然流量*, *电子邮件*, *合作伙伴网站*).                                          |

</details>

#### 用户事件导出

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

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 事件 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 记录关联起来。 |

</details>

#### 奖励历史

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

<details>

<summary>报告详情</summary>

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

* 奖励 ID
* 奖励类型
* 奖励金额

包含字段的完整列表可在以下位置找到： [下载我们的示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7E5DNWKrh7iQMNGYQBWRiS/3ae6c7a9109542215763a07a18cb0494/Reward_Details_Example_Report_CSV.csv), [示例 Excel](https://assets.ctfassets.net/s68ib1kj8k5n/2MQjc4XjXGPNhsv10tHal6/dc40679812b99d0aef4ace46a780e1ee/Reward_Details_Example_Report_XLSX.xlsx) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 或 [示例 JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/5BeuDmYM1WFAySjqntGeji/f321cf59a96d45061645d971e06fb569/Reward_Details_Example_Report_JSONL.jsonl) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 奖励详情报告。

生成报告时，您还可以选择包含：

* **参与者详情** 例如姓名、用户和账户 ID、电子邮件地址、自定义字段、分群以及推荐信息（如适用）。
* **推荐字段** 例如推荐 ID、客户推荐人字段、被推荐好友字段等。

**报告列参考**

| 列                                                                                                                  | 说明                                                                                                                          |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **奖励信息**                                                                                                           |                                                                                                                             |
| ID                                                                                                                 | 奖励实例的唯一 ID（由 Advocate 生成）。                                                                                                  |
| 类型                                                                                                                 | 奖励类别或类型（例如 *现金*, *礼品卡*, *优惠券*, *自定义*).                                                                                      |
| 值                                                                                                                  | 奖励的数值（例如 10、100 等）。                                                                                                         |
| 单位                                                                                                                 | 与该数值相关联的单位（例如 *USD*, *积分*, *ZAR*, *%*).                                                                                     |
| 名称                                                                                                                 | 奖励的显示名称（按以下内容定义 [奖励配置](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/create-a-reward.md)). |
| 奖励来源                                                                                                               | 描述触发该奖励的原因（例如 *推荐*, *目标*, *手动*, *API*).                                                                                     |
| Fuel Tank 类型                                                                                                       | 所使用的奖励资金类型（如果使用 FuelTank 集成）。例如 *预付*, *礼品卡*.                                                                                |
| Fuel Tank 代码                                                                                                       | 与外部履约相关联的代码（例如代金券或礼品卡代码）。                                                                                                   |
| 计划 ID                                                                                                              | 发放该奖励的 Advocate 计划 ID。                                                                                                      |
| 计划奖励键                                                                                                              | 计划内使用的特定奖励配置的内部标识符。                                                                                                         |
| 全局奖励键                                                                                                              | 在全局级别配置的奖励的跨计划标识符（如适用）。                                                                                                     |
| **奖励时间戳**                                                                                                          |                                                                                                                             |
| 创建日期                                                                                                               | 奖励记录在系统中创建的时间。                                                                                                              |
| 计划发放日期                                                                                                             | 奖励计划发放的时间（例如，延迟或等待期之后）。                                                                                                     |
| 发放日期                                                                                                               | 奖励实际发放给参与者的时间。                                                                                                              |
| 到期日期                                                                                                               | 奖励的到期日期（如适用）。                                                                                                               |
| 取消日期                                                                                                               | 奖励作废或取消的日期。                                                                                                                 |
| 兑换日期                                                                                                               | 参与者兑换该奖励的日期（如适用）。                                                                                                           |
| 修改日期                                                                                                               | 奖励记录最近一次更新的日期。                                                                                                              |
| **积分与价值跟踪**                                                                                                        |                                                                                                                             |
| 分配的积分                                                                                                              | 分配给该奖励的积分数量（在某些模型中可能与价值不同）。                                                                                                 |
| 已兑换积分                                                                                                              | 已从该奖励中兑换的积分数量。                                                                                                              |
| 可用价值                                                                                                               | 奖励剩余未使用或未兑换的部分。                                                                                                             |
| **奖励状态与消息**                                                                                                        |                                                                                                                             |
| 状态                                                                                                                 | 奖励的当前状态（例如 *待处理*, *已计划*, *已发放*, *已过期*, *已取消*).                                                                              |
| meta.status                                                                                                        | 技术或系统级状态（有助于诊断或错误处理）。                                                                                                       |
| meta.message                                                                                                       | 与奖励发放相关的消息（例如“奖励已成功发放”）。                                                                                                    |
| meta.internal Message                                                                                              | 仅供管理员查看的内部备注（例如失败原因或标记）。                                                                                                    |
| meta.date 修改日期                                                                                                     | 与该奖励相关的元数据最近一次更新的时间。                                                                                                        |
| meta.customMeta.testMeta                                                                                           | 用于表示您的计划发送的任何自定义元数据字段的占位符（此处 testMeta 为示例）。                                                                                 |
| **参与者（用户）信息**                                                                                                      |                                                                                                                             |
| user.id                                                                                                            | 接收该奖励的用户 ID。                                                                                                                |
| user.account Id                                                                                                    | 用户在 Advocate 中关联的账户 ID。                                                                                                     |
| <p>user.first Name</p><p>user.last Name</p><p>user.email</p>                                                       | 用于参考或 CRM 匹配的基本参与者信息。                                                                                                       |
| **推荐上下文（如果奖励基于推荐）**                                                                                                |                                                                                                                             |
| referral.id                                                                                                        | 触发该奖励的推荐 ID。                                                                                                                |
| referral.date 推荐开始日期                                                                                               | 推荐动作开始的时间（例如点击或分享事件）。                                                                                                       |
| referral.date 修改日期                                                                                                 | 推荐记录最近一次更新的时间。                                                                                                              |
| referral.referral Code Used                                                                                        | 被推荐用户用于加入或执行操作的代码。                                                                                                          |
| **被推荐用户信息（好友）**                                                                                                    |                                                                                                                             |
| referral.referred User.id                                                                                          | 被推荐的人的 ID（“好友”）。                                                                                                            |
| referral.referred User.account Id                                                                                  | 推荐人的唯一账户 ID。                                                                                                                |
| <p>referral.referred User.first Name</p><p>referral.referred User.last Name</p><p>referral.referred User.email</p> | 推荐人的基本联系信息。                                                                                                                 |
| **推荐人信息（Advocate）**                                                                                                |                                                                                                                             |
| referral.referrer User.id                                                                                          | 发起推荐的人的 ID（“推荐人”）。                                                                                                          |
| referral.referrer User.account Id                                                                                  | 推荐人的唯一账户 ID。                                                                                                                |
| <p>referral.referrer User.first Name</p><p>referral.referrer User.last Name</p><p>referral.referrer User.email</p> | 推荐人的基本联系信息。                                                                                                                 |
| referral.date 转化日期                                                                                                 | 推荐正式转化的日期（例如完成注册或购买），并触发奖励。                                                                                                 |

</details>

#### 推荐历史

该 *推荐历史* 报告提供了您推荐计划中每一条推荐关联状态的记录。此信息可用于检查计划成效并跟踪计划带来的新客户数量。

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 被推荐好友的详细信息，如姓名、用户和账户 ID、电子邮件地址等
* 客户推荐人的详细信息，如姓名、用户和账户 ID、电子邮件地址等
* 推荐状态
* 审核状态
* 奖励 ID

字段完整列表可在以下位置找到： [下载我们的示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7B4pBHawfu9GtzE5mL1yo2/4fd194ee3080c5190639abab70b35e47/Referral_Activity_Report.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 推荐活动报告。

**报告列参考**

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

</details>

#### 按用户划分的奖励余额

该 *按用户划分的奖励余额* 报告提供了通过您的推荐计划生成的未发放奖励记录，包括金额和预期收件人。此报告通常用于手动发放奖励，或作为批量处理的一部分，发送到类似 Tango Card 的系统。它也可用于跟踪您的推荐计划在给定时间段内的支付金额。

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 参与者信息，如姓名、用户和账户 ID、电子邮件地址等
* 奖励类型
* 奖励单位
* 奖励金额

字段完整列表可在以下位置找到： [下载我们的示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/5iv0ByBQquLwShSyRjawck/e04b55a4e5afe24c01d5192c10682aab/Reward_Balances_by_User.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 奖励余额报告。

**报告列参考**

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

</details>

#### 按用户显示的可用奖励余额

该 *按用户显示的可用奖励余额* 报告提供了一份未兑换奖励列表。此报告类型旨在作为通过 [批量奖励兑换](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/redeem-rewards-in-bulk.md) 流程发放奖励的一部分。

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 参与者信息，如姓名、用户和账户 ID、电子邮件地址等
* 奖励单位
* 奖励货币
* 可用金额

字段完整列表可在以下位置找到： [下载我们的示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/7CggBzV2U5EoJqp1HFF5SA/f3b417f460c0d960f8429b26824a225b/Available_Reward_Balances_by_User.csv) ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-06e12321258e7eb7ac63ef7e73640b29fcf2baad%2Fcff634f1183ca82d3b56ab55dd636140372687d8dbc6520872cdbe5010347326.svg?alt=media) 在可用奖励余额报告中。

{% hint style="info" %}
**注意**：此报告不包含百分比折扣、Fuel Tank 或礼品卡奖励的详细信息。有关这些类型奖励的更多详情，请使用 *按用户划分的奖励余额* 报告。
{% endhint %}

**报告列参考**

| 列           | 说明                                                                                                                                                                                     |
| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **参与者信息**   |                                                                                                                                                                                        |
| 名字          | 参与者的名字，用于奖励处理过程中的识别或个性化。                                                                                                                                                               |
| 姓氏          | 参与者的姓氏。                                                                                                                                                                                |
| 电子邮件        | 参与者的电子邮件地址，用于发送奖励或与 CRM 或奖励提供商等外部系统匹配。                                                                                                                                                 |
| 用户 ID       | 分配给参与者在 Advocate 中的唯一标识符。                                                                                                                                                              |
| 账户 ID       | 与参与者关联的内部账户 ID。                                                                                                                                                                        |
| 分群          | 用于 [分组参与者](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md) （例如， *按地区*, *生命周期阶段*, *客户类型*）。有助于筛选或应用不同的发放规则。 |
| **奖励状态与时间** |                                                                                                                                                                                        |
| 阻止日期        | 用户被禁止接收奖励的日期（如适用）。阻止状态可能会阻止兑换；此字段表示该阻止何时生效。                                                                                                                                            |
| **奖励数据**    |                                                                                                                                                                                        |
| 单位名称        | 奖励单位的标签或显示名称（例如， *推荐现金*, *商店积分*）。这有助于区分项目可能提供的多种奖励类型。                                                                                                                                  |
| 货币          | 奖励金额的货币代码（例如， *USD*, *ZAR*, *EUR*）。在发放奖励时需要，尤其是在跨国家或不同支付系统之间。                                                                                                                          |
| 可用价值        | 当前该参与者可用的未兑换奖励金额。这是确定应支付多少时使用的核心数值。                                                                                                                                                    |
| 待兑换金额       | 当前排队等待兑换的金额（例如，在批量发放中待处理或等待处理）。有助于防止重复兑换或确保兑换之间没有重叠。                                                                                                                                   |
| 已兑换总金额      | 该参与者已兑换的奖励总价值总和。可提供对历史兑换的洞察，并有助于跟踪奖励上限                                                                                                                                                 |
| 单位          | 奖励单位的内部或系统代码（例如， *USD*, *积分*，等等）。在发放过程中可能用于 API 调用或内部逻辑。                                                                                                                               |

</details>

#### 美国 W-9 税务报告

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

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 参与者信息，如姓名、用户和账户 ID、电子邮件地址等
* 参与者的 W-9 表格被标记为已收集的日期
* 按税务年度获得奖励的美国应税价值
* 每位参与者在税务年度内获得的奖励总数

**报告列参考**

| 列                                | 说明                                                                   |
| -------------------------------- | -------------------------------------------------------------------- |
| **参与者信息**                        |                                                                      |
| 用户 ID                            | Advocate 中参与者的唯一标识符。                                                 |
| 账户 ID                            | 与参与者关联的内部账户 ID。                                                      |
| 电子邮件                             | 参与者的电子邮件地址。                                                          |
| 名字                               | 参与者的名字。                                                              |
| 姓氏                               | 参与者的姓氏。                                                              |
| **W-9 税务信息**                     |                                                                      |
| <p>美国税表提交日期</p><p>YYYY-MM-DD</p> | 参与者的 W-9 表格在 Advocate 中被标记为已提交和已收集的日期。对于 IRS 合规和验证税务文档状态很重要。         |
| **税务年度摘要**                       |                                                                      |
| 年份                               | 参与者获得奖励的税务年度。用于按日历年分组收入以便进行 1099 处理。                                 |
| 美国应税价值（美分）                       | 该参与者在指定税务年度内获得的美国应税奖励总价值，以美分表示（例如，2500 = 25.00 美元）。有助于需要精确度的原始计算或集成。 |
| 美国应税价值（美元）                       | 同上，但以标准美元格式显示（例如，25.00）。更便于查看或纳入正式摘要。                                |
| 奖励数量                             | 参与者在指定税务年度内获得的单个奖励实例总数。适用于审计追踪或了解奖励频率和项目参与度。                         |

</details>

#### 支付与税务

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

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

<details>

<summary>报告详情</summary>

默认情况下，报告包含：

* 参与者信息，如姓名、用户和账户 ID、电子邮件地址等
* 参与者的税表（如 W-8 或 W-9）被标记为已提交的日期
* 按税务年度获得奖励的美国应税价值
* 每位参与者在税务年度内获得的奖励总数
* 税表状态，例如， *有效*, *暂停*，或 *待处理*。报告中也包含支付暂停原因

**报告列参考**

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
