> 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).

# 设置排行榜

排行榜会将您的计划参与者与其他人一同排名，以激励他们完成计划目标，并鼓励他们争夺更高名次。您可以将排行榜添加到已验证访问权限的小组件或微型网站中，并像自定义其他组件一样进行设置。

排行榜可通过多种方式配置，以最契合您计划的目标。有关不同选项的更多信息，请参阅 [排行榜详解](https://help.impact.com/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. 选择以下选项，前往您的小组件或微型网站： ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → 内容 → 编辑小组件** 或 **编辑内容**.
   * 如果您尚未设置小组件或微型网站，请先完成设置。

     <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%2FvbZxfC4IoKEUzksFMMpP%2FScreenshot%202026-05-19%20at%2009.40.45.png?alt=media&amp;token=a9d78fa1-417e-4f8e-b517-5eeb441cd41c" alt=""><figcaption></figcaption></figure></div>
2. 选择要编辑的小组件或微型网站页面。
   * 了解如何 [编辑小组件内容](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/customize-program-widgets.md) 或 [编辑微型网站页面](https://help.impact.com/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. 选择一种 **排行榜**.
   * 有关各类可用排行榜的说明，请参阅 [排行榜详解](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md#leaderboard-types-0-0).
5. 在画布上选择蓝色的 **添加到** 按钮，以将组件放置在所需位置。

<figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FaXBEZtX1RjI2nfInBYFp%2FScreenshot%202026-05-19%20at%2009.44.33.png?alt=media&amp;token=4c43c5dd-8f20-4221-9971-1199cb9e2129" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**第 3 步：自定义排行榜**

{% tabs %}
{% tab title="编辑" %}

1. 在画布上选择要编辑的排行榜组件。
2. 使用右侧边栏菜单中 **编辑** 选项卡里的选项更改排行榜属性。
   * 如果要在文本组件中插入链接，可以选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-63c2caf34c8c42984b458d40b5ac087e03360307%2Fc5fc23a16175bc8c8603fda06785d3d10c8d687bb14c7c6f1424d705c272963e.svg?alt=media) **\[代码视图]** 然后编辑微件或微型网站的 HTML。
3. 选择 **保存草稿** 完成后。

**编辑字段参考**

| 设置           | 说明                                                                                                                                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 未知用户文本       | 输入没有姓名的用户的默认显示名称，例如 *匿名用户*.                                                                                                                                                                                                                      |
| 隐藏当前查看用户     | 开启此选项后，如果当前查看者不在显示的前几名中，其所在行将被隐藏。                                                                                                                                                                                                                |
| 排行榜时间范围      | 输入要查看排行榜结果的开始日期和结束日期，格式为 `mm/dd/yyyy`.                                                                                                                                                                                                           |
| 排行榜类型        | 选择要使用的评分系统。有关可用评分系统的更多信息，请参阅 [排行榜详解](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).                                                    |
| 最大行数         | 输入排行榜要显示的最大行数。                                                                                                                                                                                                                                   |
| 计划           | 选择一个项目，将排行榜结果限制为该项目的参与者。若要查看所有项目的全局结果，请不要选择项目。                                                                                                                                                                                                   |
| 排名类型         | 有关可用排名系统类型的更多信息，请参阅 [排行榜详解](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/leaderboards-explained.md).                                                             |
| 排名列标题        | 输入要显示为 *排名* 列的列名。                                                                                                                                                                                                                                |
| 显示排行榜排名      | ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[开启]** 如果希望排行榜显示 *排名* 列。 |
| 统计列标题        | 输入要显示在参与者分数列中的列名称。                                                                                                                                                                                                                               |
| 用户列标题        | 输入要显示在参与者姓名列中的列名称。                                                                                                                                                                                                                               |
| {% endtab %} |                                                                                                                                                                                                                                                  |

{% tab title="移动" %}

1. 在画布上，选择要移动的组件。
2. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[移动]**.
   * 某些组件无法移动。只有当画布上存在可供组件移至的其他有效位置时，才会显示 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9e2a26b918e7394cf67e8a26e3713e081b203ac9%2F15d049b0c04d1c54c39dbbb5a7cd2ba64d86f1f99220111674e768744ea7ceb9.svg?alt=media) **\[移动]** 选项。
3. 选择蓝色的 **移至** 按钮，将组件移至该位置。
4. 选择 **保存**.
   {% endtab %}

{% tab title="移除" %}

1. 在画布上，选择要移除的组件。
2. 选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fe3GCJYT1vVzaTSMmeCgp%2Ftrash-alt-solid.svg?alt=media\&token=b5b84aa2-055e-49a1-910c-4b9a88bc2c9d) **\[移除]**.
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 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/set-up-a-leaderboard.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.
