> 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/widget-experiences/customize-program-widgets.md).

# 自定义项目组件

## 访问小组件编辑器

1. 从左侧导航菜单中，选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → 内容**.
2. 在 *小组件* 卡片中，选择 **编辑小组件。**
3. 从左侧滑出菜单中，选择你要编辑的小组件名称。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F0I1JAhlX9u017vOG1oiM%2FScreenshot%202026-05-18%20at%2009.39.01.png?alt=media&#x26;token=9315e124-9a39-4aa7-9a74-15c1d76cef00" alt="" width="347"><figcaption></figcaption></figure></div>

## 自定义你的小组件

{% stepper %}
{% step %}

### **第 1 步：选择模板**

1. 从左侧滑出菜单中，在 *当前小组件*下方，选择 **模板**.
2. 选择 **应用模板** ，作为起始模板。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FUprZtBVbqNwCSdeRzWgh%2FScreenshot%202026-05-18%20at%2009.22.47.png?alt=media&#x26;token=ffb2f798-297e-4f6c-a154-30146230482c" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="success" %}
**注意：** 如果你想在不提交更改的情况下预览模板的外观，请在保存前选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-190c6a03e6a68d67509d00452b10fd803bee5c87%2F57c7cba09bd1b97dd75b7c245e517c8d1ca0469d7c57bdc13ee6e427b75a860a.svg?alt=media) **\[预览]** 。只有在你准备好提交所做更改时，才选择 **保存** 按钮。
{% endhint %}
{% endstep %}

{% step %}

### **第 2 步：调整小组件内容**

你可以添加、编辑、移动或移除组件，以修改你的客户倡导者在小组件中看到的内容。

{% hint style="success" %}
**注意：** 有关小组件编辑器各个元素的说明，请参阅小组件编辑器概览。
{% endhint %}

{% tabs %}
{% tab title="添加" %}

1. 在页面右侧的 *组件* 菜单的 **添加** 选项卡中，选择一个组件组。
   * 了解更多关于可用组件及其分组方式的信息。
2. 选择合适的组件。
3. 选择蓝色的 **添加到** 按钮，将组件放置到画布上你想要的位置。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-faf3362b50a4598aeacff4ca831e5dcef8c7ef6e%2F346370cdced07562b504cd2b9bf6bf08b51539060e9551f784f029d4899ffa12.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="编辑" %}
你可以编辑的属性取决于你选择的组件类型。例如，如果你选择 *英雄图片* 组件，你将能够选择新图片并更改背景颜色。如果你选择像标题这样的纯文本元素，则可以修改字体、文字颜色和文本内容。

1. 选择你要编辑的组件。
2. 使用 *组件* 菜单的 **编辑** 选项卡中的选项来更改其属性。

   * 如果你想在文本组件中插入链接，可以通过编辑小组件的 HTML 来实现。

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-3e26ab9dbdff4f8e5d3d3e078d965672ade44d45%2F026f0ef0af7421ecfab6535433ea587862ec12c5223e8b393ef1db1228676e1f.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="移动" %}

1. 在画布中，选择并按住你要移动的组件。
2. 将组件拖到画布上的新位置，然后松开以放置到位。

   * 某些组件无法移动。如果组件不可拖动，当你尝试重新定位时，它不会移动。

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-7bd9887e9f359c787f834a8344a181d7bb186dd3%2Faadaf737882c59604dcaa6bbed1857c867a32cad8c3dd8ea7975c047c04e6a3f.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endtab %}

{% tab title="移除" %}

1. 在画布上选择你要移除的组件。
2. 选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c5ab8423372b2c345ded634b7aa4cab16c87fe3a%2Fd17a259fe817ff10ea9fd87140a89bd62ece6fa9940e05902574dcf95bed5960.svg?alt=media) **\[移除]**.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-030ab8fb2f678027aa57af859245968daee6f736%2F987319390fa75c5fb85f94d2d6e0a951fbf4511a72dbd91af4e55c8f39317301.jpg?alt=media" alt="" width="507"><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### **第 3 步：自定义小组件外观和主题**

#### **添加图片或徽标**

1. 在右侧，从 *组件* 菜单的 **添加** 选项卡中，选择 **常用组件** 类别。
2. 选择以下任一项：
   * **叠加英雄图片** （带有可编辑叠加文字的图片）
   * **图片** （不带文字的纯图片）
3. 将图片添加到画布中。
4. 从 *组件菜单的* **编辑** 选项卡中，选择 **选择文件** 按钮下方的 *图片* 标题。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FlgpOwJZHPh4UAnrEyoZ2%2FScreenshot%202026-05-18%20at%2009.26.52.png?alt=media&#x26;token=6430a500-8532-4fda-9789-1c879854cb67" alt="" width="295"><figcaption></figcaption></figure></div>

#### **替换图片或徽标**

1. 在画布中，选择你想要更改的照片。
2. 在 **编辑** 菜单中，选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[移除]** 然后选择 **选择文件** 以重新上传新图片。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FnLgD9kbzviI0PLgHBwi2%2FScreenshot%202026-05-18%20at%2009.27.57.png?alt=media&#x26;token=f6eddd68-8246-4d60-8470-ab4cf3a66c9a" alt="" width="299"><figcaption></figcaption></figure></div>

3. 使用以下方法之一上传图片：
   * 将图片拖放到此处
   * 在你的电脑上浏览文件
   * 在 *网页地址* 选项卡，粘贴该文件的公共 URL
4. 选择 **完成**.

#### **调整显示哪些分享按钮**

你可以使用 **编辑** 菜单编辑现有的分享按钮。

1. 在画布上选择你要编辑的分享按钮。
2. 在 **编辑** 选项卡中，选择“ *分享媒介* 标题。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNvgjnWp81PZSbXRInnFF%2FScreenshot%202026-05-18%20at%2009.30.34.png?alt=media&#x26;token=a9e03a88-d25c-4f80-a304-a922741ca5d2" alt="" width="296"><figcaption></figcaption></figure></div>

通过使用 **添加** 菜单编辑现有的分享按钮。

1. 从 **添加** 选项卡，选择 **分享**.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FAjOJfvj8X7nfL0AAJTJK%2FScreenshot%202026-05-18%20at%2009.31.51.png?alt=media&#x26;token=5abcab17-8b61-4df8-892b-41db83253eb3" alt="" width="283"><figcaption></figcaption></figure></div>

2. 选择合适的卡片。
3. 选择蓝色的 **添加到** 按钮，将组件放置到画布上。
   {% endstep %}

{% step %}

### **第 4 步：预览并保存**

1. 通过选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-190c6a03e6a68d67509d00452b10fd803bee5c87%2F57c7cba09bd1b97dd75b7c245e517c8d1ca0469d7c57bdc13ee6e427b75a860a.svg?alt=media) **\[预览]** 从顶部菜单栏预览小组件在参与者端的显示效果。
   * 你可以在以下体验预览之间切换： ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-ae8027a26340e35a4d47f2a067cfadc9fc78113f%2F286f2a6c1251052ae82b73cd1c52b622b18f5203ba9cc10fde4d74292ac28d34.png?alt=media) **\[桌面]**, ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-deeb14b0e398d5dbb2dfb280d3fd7d8e9411b26e%2F74c7be4be7f1d77a3793767c29c5bd878acceacf1d2533055231d5110b12dd61.png?alt=media) **\[平板]**，或 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6156958cf5fc18498276161791a0514d9005d7cf%2F906c40a4da5b9c02a51450974f61a71761acc07baff3052b53f708d5b768a9be.png?alt=media) **\[移动端]** 用户的预览，只需选择相应的设备图标。
2. 要返回编辑界面，请选择 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-60e9ace573178da411cb3be9c6f3b0f4b7e5b524%2F4094fadf599e544cfc618c18eb22087defdb9be38a580cd0041a242a88294e1e.svg?alt=media) **\[编辑]** 从顶部菜单栏预览小组件在参与者端的显示效果。

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FLtrKm25PXlhbzNvd63Kd%2FScreenshot%202026-05-18%20at%2009.32.48.png?alt=media&#x26;token=6e306358-0acf-4592-bcdd-5122c7fee062" alt="" width="563"><figcaption></figcaption></figure></div>

3. **保存** 你的更改。

{% hint style="warning" %}
**警告：** 小组件编辑器不会自动保存你的更改。请经常点击 **保存** ，以确保你不会丢失工作内容。
{% endhint %}

当你选择 **保存**时，这些更改将添加到你的项目草稿中。
{% endstep %}
{% endstepper %}

## 高级自定义选项

高级组件允许你包含基于参与者 *电子邮件*, *分群*，或 *自定义字段*的条件内容。例如，如果你想只向黄金级订阅者显示排行榜， **按分群条件部分** 组件可以让你做到这一点。

你可以从 **添加** 选项卡中添加高级组件。设置它们需要多做一点工作，因为你需要在 [JSONata 表达式](http://docs.jsonata.org/overview.html) 中输入一个 *条件* 框，用于定义满足条件时的逻辑。如果你需要帮助，请联系我们的 [支持团队](mailto:saasquatch-support@impact.com) 。

## 了解更多

* [为 Advocate 编辑你的小组件或微型站点 HTML](#access-the-widget-editor-0-0)
* [为 Advocate 安装自定义 NPM 包](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/install-custom-npm-packages-for-advocate.md)


---

# 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/widget-experiences/customize-program-widgets.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.
