> 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/set-up-a-leaderboard.md).
# 设置排行榜
排行榜会将你的项目参与者与其他人并列排名，以激励他们完成项目目标，并鼓励他们为更高名次展开竞争。你可以将排行榜添加到已验证访问小组件或微站点中，并像其他组件一样进行自定义。
排行榜可以通过多种方式进行配置，以最适合你项目的目标。有关不同选项的更多信息，请参阅 [排行榜说明](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).
{% hint style="warning" %}
此功能仅适用于某些 impact.com 版本或附加组件。 [联系我们](https://app.impact.com/support/portal.ihtml?createTicket=true&) 以升级您的账户并获取访问权限！
{% endhint %}
{% stepper %}
{% step %}
**第 1 步：启用排行榜**
在开始设置排行榜之前，请联系你的项目策略经理（PSM）或创建一个 [支持工单](mailto:advocate-support@impact.com) ，为你的项目启用排行榜功能。
{% endstep %}
{% step %}
**第 2 步：将排行榜添加到小组件或微站点**
1. 通过选择以下内容，进入你的小组件或微站点  **\[Engage] → 内容 → 编辑小组件** 或 **编辑内容**.
* 如果你还没有设置小组件或微站点，需要先完成这一步。
2. 选择你想编辑的小组件或微站点页面。
* 了解如何 [编辑小组件内容](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) 或 [编辑微站点页面](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
3. 从右侧边栏菜单中展开 **排行榜** 组件。
* 如果你没有看到 *排行榜* 组件，则首先需要安装 Mint Components 包：
* **为小组件安装 Mint Components**
1. 从左侧边栏菜单中，选择 **包 → 添加包**.
1. 在 *Mint Components* 卡片中，选择 **添加**.
2. 现在你应该可以展开 **排行榜** 组件了，位于右侧边栏菜单中。
* **为微站点安装 Mint Components**
1. 返回到 *内容* 界面，选择 **→ \[Engage] 内容** ，在左侧导航栏或顶部菜单中。
2. 在 *微站点* 卡片中，选择 **编辑设置**.
3. 滚动，直到你看到 *包* 字段，然后选择 **添加包**.
4. 在 *Mint Components* 卡片中，选择 **添加**.
5. 选择 **保存配置** 并返回编辑器。
4. 选择一种 **排行榜**.
* 有关可用排行榜类型的说明，请参阅 [排行榜说明](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md#leaderboard-types-0-0).
5. 选择蓝色 **添加到** 按钮，在你希望组件出现的画布位置。
{% endstep %}
{% step %}
**第 3 步：自定义排行榜**
{% tabs %}
{% tab title="编辑" %}
1. 在你的画布上，选择要编辑的排行榜组件。
2. 使用右侧边栏菜单中 **编辑** 选项卡里的选项来更改排行榜属性。
* 如果你想在文本组件中插入链接，可以通过选择  **\[代码视图]** 并编辑小组件或微站点的 HTML 来实现。
3. 选择 **保存草稿** 完成后。
**字段编辑参考**
| 设置 | 说明 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 未知用户文本 | 为没有姓名的用户输入默认显示名称，例如， *匿名用户*. |
| 隐藏查看用户 | 开启后，如果查看参与者未进入顶部显示名次，其所在行将被隐藏。 |
| 排行榜时间区间 | 输入你想查看排行榜结果的开始和结束日期，格式为 `mm/dd/yyyy`. |
| 排行榜类型 | 选择你要使用的计分系统。有关可用计分系统的更多信息，请参阅 [排行榜说明](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md). |
| 最大行数 | 输入要在排行榜上显示的最大行数。 |
| 项目 | 选择一个项目，以将排行榜结果限制为该项目中的参与者。若要查看所有项目的全局结果，请不要选择项目。 |
| 排名类型 | 有关可用排名系统类型的更多信息，请参阅 [排行榜说明](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md). |
| 排名列标题 | 输入你希望显示为该列的列名 *排名* 列。 |
| 显示排行榜排名 |  **\[开启切换]** 如果你希望排行榜显示 *排名* 列。 |
| 统计列标题 | 输入你希望显示为包含参与者得分的列的列名。 |
| 用户列标题 | 输入你希望显示为包含参与者姓名的列的列名。 |
| {% endtab %} | |
{% tab title="移动" %}
1. 在你的画布上，选择你想移动的组件。
2. 选择  **\[移动]**.
* 某些组件无法移动。  **\[移动]** 选项仅在画布上存在另一个可用于重新定位该组件的有效位置时才会出现。
3. 选择蓝色 **移动到** 按钮，将组件移动到你希望的位置。
4. 选择 **保存**.
{% endtab %}
{% tab title="移除" %}
1. 在你的画布上，选择你想移除的组件。
2. 选择  **\[移除]**.
3. 选择 **保存**.
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}
---
# 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/manage-advocate-participant-experiences/set-up-a-leaderboard.md?ask=&goal=
```
`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.
