> 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/manage-advocate-participant-experiences/leaderboards-explained.md).

# 排行榜说明

[游戏化](https://www.techtarget.com/searchhrsoftware/definition/gamification) 在非游戏场景中使用排行榜和奖励等游戏元素来激励参与者行为。在推荐营销中，使用排行榜将您的项目参与者与其他人一起排名，可以让完成项目目标更有趣，并鼓励争夺更高名次。向表现最佳者提供礼品卡或免费产品等奖励，可激励参与者在您的项目中带来更出色的结果。

在 impact.com 上，您可以通过多种方式配置排行榜，以最符合您的 Advocate 计划目标。有关操作指导，请参见 [设置排行榜](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/set-up-a-leaderboard.md).

#### 排行榜类型

impact.com 的 Advocate 计划提供 3 种排行榜类型，每种类型通过不同的评分系统对参与者进行排名。

<details>

<summary>发起推荐最多者</summary>

此类排行榜按参与者发起的推荐数量进行排名。推荐者的分数将对应其发起的推荐数量。

{% hint style="info" %}
**示例：** 如果 Dinah 推荐了她的 5 位关注者，那么她的分数将是 5。
{% endhint %}

</details>

<details>

<summary>转化推荐最多者</summary>

此类排行榜按参与者已转化的推荐数量进行排名。当被推荐好友达成某个项目目标，例如完成您定义金额的购买后，该推荐即视为已转化。客户倡导者的分数将对应已转化的推荐数量。

{% hint style="info" %}
**示例：** 如果 Dinah 推荐了她的 5 位关注者，其中有 2 位在您的项目规则定义下继续完成并成为已转化推荐，那么她的分数将是 2。
{% endhint %}

</details>

<details>

<summary>积分获取最多者</summary>

此类排行榜按参与者获得的总积分数量进行排名。只要奖励单元积分未处于待处理或已取消状态，都会计入。此排行榜类型也仅适用于 *Point* 奖励类型。

{% hint style="info" %}
**示例：** 如果 Dinah 通过促使一位关注者在您的应用中注册免费试用获得 5 分，通过促使一位关注者购买一个月会员获得 10 分，又通过促使另一位关注者注册免费试用获得 5 分，但最后一项任务的积分仍处于待处理状态，那么她的分数将是 15。
{% endhint %}

</details>

这些排行榜类型中的任何一种都可以转换为 ***匿名排行榜***，它会显示参与者的分数和排名，但不包含他们的姓名。

<details>

<summary>匿名排行榜</summary>

一个 *匿名排行榜* 在不显示任何参与者姓名的情况下显示排名和分数，从而提供更高程度的隐私保护。您可以选择是否要一个 *发起推荐最多者*, *转化推荐最多者*，或 *积分获取最多者* 位于 **排行榜类型** 组件编辑菜单中的下拉列表。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FIMvRRWGMAVDLkgA9Cv1Z%2FScreenshot%202026-05-20%20at%2010.11.04.png?alt=media&amp;token=4882c013-8cf1-4abe-9474-6be60b4b092a" alt="" width="563"><figcaption></figcaption></figure></div>

与其他排行榜类型一样，参与者的排名会在表格中高亮显示，帮助他们识别自己在排名中的位置。

</details>

#### 排行榜筛选

您可以设置排行榜以不同方式筛选参与者。您可以在任何时候同时运行多个排行榜。

<details>

<summary>项目</summary>

您可以通过按特定 Advocate 计划筛选排行榜，或将筛选范围保持在全局级别，来限定排行榜中显示哪些参与者。

如果按计划限定范围，排行榜将显示参与者在某个指定计划中的排名。

如果按全局范围限定，排行榜将显示参与者在所有 Advocate 计划中的排名。

</details>

<details>

<summary>时间区间</summary>

您可以通过按特定时间区间筛选排行榜来限定其显示的活动。

按时间区间限定时，排行榜将仅显示参与者在指定时间范围内的排名，超出该范围的任何活动都不会反映在内。

</details>

#### 排名类型

排行榜按分数从高到低对参与者进行排名，这意味着分数最高者排名第 1，第二高者排名第 2，依此类推。不过，当两个或更多参与者分数相同时，您可以选择一种排名类型来决定排行榜上如何显示并列分数。

<details>

<summary>行号</summary>

* 使用此排名选项时，如果两个参与者分数相同，其中一位将被降至下一名。
* 并列参与者的排序是随机的。

{% hint style="info" %}
**示例：** 如果 Oliver、Dinah 和 Hazel 的分数分别为 10、15 和 10，那么排行榜会以以下任一方式对他们进行排名：
{% endhint %}

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Dinah  | 15 |
| 2  | Oliver | 10 |
| 3  | Hazel  | 10 |

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Dinah  | 15 |
| 2  | Hazel  | 10 |
| 3  | Oliver | 10 |

</details>

<details>

<summary>排名</summary>

* 使用此排名选项时，如果两个参与者分数相同，他们将共享当前可用的最高名次，而下一位参与者将跳过一个名次。
* 排行榜中会缺少某些名次。

{% hint style="info" %}
**示例：** 如果 Oliver、Dinah 和 Hazel 的分数分别为 20、15 和 20，那么排行榜会以以下任一方式对他们进行排名：
{% endhint %}

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Oliver | 20 |
| 1  | Hazel  | 20 |
| 3  | Dinah  | 15 |

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Hazel  | 20 |
| 1  | Oliver | 20 |
| 3  | Dinah  | 15 |

</details>

<details>

<summary>密集排名</summary>

* 使用此排名选项时，如果两个参与者分数相同，他们将共享当前可用的最高名次，而下一位参与者不会跳过名次。
* 排行榜不会出现任何缺失的名次。

{% hint style="info" %}
**示例：** 如果 Oliver、Dinah 和 Hazel 的分数分别为 20、15 和 20，那么排行榜会以以下任一方式对他们进行排名：
{% endhint %}

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Oliver | 20 |
| 1  | Hazel  | 20 |
| 2  | Dinah  | 15 |

| 排名 | 参与方    | 分数 |
| -- | ------ | -- |
| 1  | Hazel  | 20 |
| 1  | Oliver | 20 |
| 2  | Dinah  | 15 |

</details>

#### 参与者看到的样子

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9cf6df2b65278cb7baf4a646e399256ae7a3670b%2Fc8ca81a58e1fdbff34116b59b87da78b036770a45bb6a361dd5a9e1be06a1b8b.png?alt=media" alt=""><figcaption></figcaption></figure></div>

* 排行榜将显示参与者的排名、分数、名字和姓氏首字母。
* 查看排行榜的参与者对应的行将以您的品牌颜色高亮显示，并且可以隐藏 *排名* 该列（如果他们愿意）。
* 如果没有排行榜结果，将显示空状态。
* 如果选择了一个 *匿名排行榜* 被选中，那么参与者将只会看到排名和分数。


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
