> 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 项目的目标。有关如何配置的指南，请参阅 [设置排行榜](https://help.impact.com/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>

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

{% 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  | 迪娜  | 15 |
| 2  | 奥利弗 | 10 |
| 3  | 黑兹尔 | 10 |

| 排名 | 参与者 | 分数 |
| -- | --- | -- |
| 1  | 迪娜  | 15 |
| 2  | 黑兹尔 | 10 |
| 3  | 奥利弗 | 10 |

</details>

<details>

<summary>排名</summary>

* 使用此排名方式时，如果两位参与者的分数相同，他们将并列占据可用的最高名次，而下一位参与者的名次会跳过一个名次。
* 排行榜上会缺少一些名次。

{% hint style="info" %}
**示例：** 如果奥利弗、迪娜和黑兹尔的分数分别为 20、15 和 20，那么排行榜将按以下任一方式为他们排名：
{% endhint %}

| 排名 | 参与者 | 分数 |
| -- | --- | -- |
| 1  | 奥利弗 | 20 |
| 1  | 黑兹尔 | 20 |
| 3  | 迪娜  | 15 |

| 排名 | 参与者 | 分数 |
| -- | --- | -- |
| 1  | 黑兹尔 | 20 |
| 1  | 奥利弗 | 20 |
| 3  | 迪娜  | 15 |

</details>

<details>

<summary>密集排名</summary>

* 使用此排名方式时，如果两位参与者的分数相同，他们将并列占据可用的最高名次，而下一位参与者的名次不会跳过。
* 排行榜上不会缺少任何名次。

{% hint style="info" %}
**示例：** 如果奥利弗、迪娜和黑兹尔的分数分别为 20、15 和 20，那么排行榜将按以下任一方式为他们排名：
{% endhint %}

| 排名 | 参与者 | 分数 |
| -- | --- | -- |
| 1  | 奥利弗 | 20 |
| 1  | 黑兹尔 | 20 |
| 2  | 迪娜  | 15 |

| 排名 | 参与者 | 分数 |
| -- | --- | -- |
| 1  | 黑兹尔 | 20 |
| 1  | 奥利弗 | 20 |
| 2  | 迪娜  | 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.
