> 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-and-microsite-components-explained.md).
# 小组件与微站组件说明
参加 PXA 课程
{% hint style="success" %}
**有限**：除给定模板中提供的组件外，组件仅适用于某些产品版本或附加项。如果您希望更细致地控制您的微站使用哪些组件，请联系我们升级您的方案。
{% endhint %}
组件是构成您的 Advocate 项目小部件或微站的单个构建模块，例如主视觉图片和任务卡片。这些元素塑造了 [参与者体验](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/introduction-to-participant-experiences.md) ，并可根据您的品牌进行自定义。
本文提供了小部件和微站编辑器中可用组件的分类列表。大多数组件都支持样式和自定义，但有些存在设计限制。您还可以在编辑器界面中预览组件状态。
统计数据
使用 *统计数据* 组件让参与者了解他们在项目中的表现。要查看这些组件可支持的统计数据列表，请访问 [小部件和微站统计数据](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-and-microsite-statistics-explained.md).
| 组件 | 说明 |
| ------ | ------------------------------------------ |
| 积分余额 | 显示参与者的积分余额。用于以积分奖励参与者的 Advocate 项目。 |
| 已获得礼品卡 | 显示 Advocate 获得的礼品卡奖励数量。 |
| 推荐 | 显示参与者已进行的推荐数量。包括已发起和已转化的推荐。 |
| 三统计容器 | 一个可容纳三个统计数据的模板。显示的统计数据可以更改。可根据需要添加和移除统计数据。 |
| 其他统计 | 显示您选择的统计数据。您可以在推荐统计、各类奖励统计之间进行选择，或创建自定义统计。 |
常用组件
*常用组件* 被广泛用于提升您的小部件或微站的功能性和设计一致性。它们涵盖通用的视觉和结构元素，如主视觉图片、布局格式和说明性的项目步骤。
| 组件 | 说明 |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 双栏主视觉图片 | 横跨两栏的横幅图片和标题文本。图片、文本和背景颜色都可以更新。
|
| 叠加主视觉图片 | 带有叠加文本的横幅图片。图片、文本和背景颜色都可以更新。
|
| 图片 | 一张图片。背景颜色、对齐方式、高度和宽度都可以更改。
|
| 链接按钮 | 可点击的按钮，会将参与者重定向到您选择的链接。按钮颜色由品牌容器级别设置的品牌颜色控制。
|
| 项目说明 | 一个说明 Advocate 项目如何运作的模板，例如如何获得奖励。默认包含两个项目说明步骤。可添加更多步骤。颜色由品牌容器级别设置的品牌颜色控制。
|
| 项目说明步骤 | 添加说明文本以解释项目的一部分。适用于项目说明组件中。颜色由品牌容器级别设置的品牌颜色控制。
|
| 项目时间线 | 显示参与者推荐流程和奖励的概览。可根据需要添加或移除时间线条目。圆形图标及条目之间线条的颜色由品牌容器级别设置的品牌颜色控制。
|
| 时间线条目 | 适用于项目时间线组件中，用于显示推荐流程的一个步骤。圆形图标及条目之间线条的颜色由品牌容器级别设置的品牌颜色控制。
|
| 用户名显示 | 动态拉取参与者的全名。如果参与者尚未输入姓名，默认为“匿名用户”。
|
奖励
{% hint style="info" %}
**注意：** *奖励* 组件只能用于已验证访问的小部件和微站。
{% endhint %}
| 组件 | 说明 |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 任务卡片信息流 | 任务卡片可让您的用户直接通过小部件或微站执行操作或查看距离完成 Advocate 项目目标的进度。此组件会向您的小部件或微站添加多张任务卡片。按钮颜色由品牌容器级别设置的品牌颜色控制。
|
| 奖励兑换 | 允许参与者将已获得的奖励兑换为其他类型的奖励。
您必须先 奖励兑换 完成设置后才能使用此功能。
|
| 奖励表 | 显示参与者已获得的奖励列表。可包含手动奖励和/或在多个 Advocate 项目中获得的奖励。
|
| 客户备注列 | 为奖励表再添加一列备注。必须放置在奖励表组件内。
|
| 日期列 | 为奖励表再添加一列日期。必须放置在奖励表组件内。
|
| 奖励列 | 为奖励表再添加一列奖励。必须放置在奖励表组件内。
|
| 来源列 | 为奖励表再添加一列来源。必须放置在奖励表组件内。
|
| 状态列 | 为奖励表再添加一列状态。必须放置在奖励表组件内。
|
微站组件
*微站* 组件主要用于微站的注册表单和导航侧边栏。这些组件不能添加到项目小部件中。
| 组件 | 说明 |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 表单复选框字段 | 为注册表单添加一个复选框。您可以将该框是否被勾选映射到 Advocate 参与者的自定义字段。更多信息请阅读“查看您的微站注册表单提交”。
|
| 表单下拉字段 | 为注册表单添加一个带可自定义列表项的下拉列表。您可以将用户选择的列表项映射到 Advocate 参与者的自定义字段。有关帮助，请联系支持。
|
| 表单输入字段 | 为注册表单添加一个自由文本输入字段。您可以将用户输入的文本映射到 Advocate 参与者的自定义字段。 联系支持 以获取这方面的帮助。
|
| 表单姓名字段 | 为注册表单添加可填写的名字和姓氏字段。
|
| 侧边栏项 | 为您的微站侧边栏导航添加一个新页面或链接。只能放置在微站的已登录布局中。
|
| 表单密码字段 | 为注册表单添加可填写的密码字段。
|
即时访问
*即时访问* 组件让被推荐的好友无需经过标准注册流程即可快速轻松地注册或兑换奖励。它们非常适合使用即时访问推荐小部件或好友注册流程的项目。
| 组件 | 说明 |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 优惠券代码 | 显示 Fuel Tank 奖励的可兑换代码。
该 奖励燃料箱 必须有可用的优惠券代码，此组件才能按预期工作。
|
| Advocate 注册 | 允许新 Advocate 输入电子邮件地址进行注册并发起推荐。输入电子邮件地址后，用户将进入第二个界面，在那里可以访问他们的推荐分享链接。用于即时访问的网站推荐小部件。
|
| 注销当前用户 | 允许查看者退出个性化即时访问显示。
|
| 好友注册 | 允许被推荐的好友输入电子邮件地址进行注册。输入电子邮件地址后，用户将进入第二个界面，在那里可以访问他们的优惠券代码奖励。用于即时访问的好友小部件。
|
布局
*布局* 组件让您可以组织并组合其他组件。可用于创建区块、行、列或选项卡。
| 组件 | 说明 |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| 双栏主视觉布局 | 添加一个包含两列内容的主视觉布局。
|
| 行布局容器 | 为内容添加一个新的行容器。其他组件可以放置在该行中。
|
| 列布局容器 | 为内容添加一个新的列容器。其他组件可以放置在该列中。
|
| 选项卡 | 为通用选项卡组添加一个新选项卡。
|
| 通用选项卡组 | 添加一组选项卡。每个选项卡都可以包含不同的组件和内容。默认有三个选项卡，但可根据需要移除或添加。
|
| 标题区块 | 添加一个包含标题和段落文本的新区块。其他组件可以添加到标题区块下的标题中。
|
发票
*发票* 组件允许您插入发票组件以查看收益数据。
| 组件 | 说明 |
| ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| 发票表 | 添加一个可展开的发票折叠面板，用于承载收益数据。
|
| 发票表日期列 | 为您的发票表组件添加一列。
|
该 *排行榜* 组件允许您对项目参与者进行排名、向表现最佳者提供奖励，并激励参与者为项目带来更大成果。将排行榜添加到您的 [已验证访问的小部件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/widget-types-explained.md) 或 [微站](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsites-overview.md)中，并配置计分系统、排名系统和参与者筛选选项。更多信息请参阅以下文章：
* [排行榜说明](/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/set-up-a-leaderboard.md)
| 组件 | 说明 |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 已发起推荐 | 此类排行榜根据参与者已发起的推荐数量进行排名。您的客户倡导者得分将与已发起的推荐数量相对应。
|
| 已转化推荐 | 此类排行榜根据参与者已转化的推荐数量进行排名。当被推荐的好友达成某个项目目标，例如完成您定义价值的购买时，推荐即视为已转化。您的客户倡导者得分将与已转化的推荐数量相对应。
|
| 已获得积分 | 此类排行榜根据参与者在奖励积分的 Advocate 项目中获得的总积分数量进行排名。只要未处于待定或已取消状态，所有奖励单位积分都计入。此排行榜类型仅适用于积分奖励类型。
|
| 匿名排行榜 | 一个完全匿名化的排行榜版本，不显示其他项目参与者的任何个人身份信息。可显示任何类型的排行榜。
|
税务和现金
*税务和现金* 组件让您可以在您的 [已验证访问的小部件](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/widget-experiences/widget-types-explained.md) 或 [微站](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsites-overview.md).
此组件组仅在以下情况下可用： [*现金支付*](/brand/zh/what-would-you-like-to-learn-about/advocate-program/advocate-rewards/pay-with-cash/cash-payouts-for-advocate-explained.md) 功能已在您的账户中开启。
| 组件 | 说明 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 支付状态提醒 | 在参与者能够收到现金支付之前，提醒其需要采取的操作。该组件包含一个行动召唤按钮，可将参与者带到其支付设置页面进行查看。
您也可以选择自定义参与者查看该组件时看到的任何文本说明。
|
| 微站与小部件现金支付表单 | 插入一个表单，用于收集参与者的银行信息以及任何适用的税务表格，如 W-8 或 W-9。
您也可以选择自定义参与者查看该表单时看到的任何文本说明。
您还可以在此组件中设置验证提醒和要求。
|
分享
*分享* 组件为参与者提供了便捷的方式，可在多个渠道推广他们的推荐链接和代码。当参与者点击分享按钮时，会打开所选渠道，例如 *Facebook*, *LinkedIn*, *WhatsApp*，或 *电子邮件*，并自动填入预设消息或链接，准备发送。
某些组件，如推荐代码，会显示参与者的个人推荐码或促销码，并提供复制到剪贴板选项以便快速分享。另一些组件，如促销码，会以滑块视图展示多个可用代码（如果已分配），并包含分享按钮，使参与者可以立即发布或发送所选代码。这些工具让参与者轻松传播信息并带来新的推荐。
| 组件 | 说明 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 推荐代码 | 显示推荐代码字段，并提供复制到剪贴板选项。用作促销码功能的一部分。
|
| 促销码 | 预格式化的组件块，包含推荐促销码字段；如果分配了多个代码，则带有滑块以在不同代码之间切换。它还包括分享链接，以及 Facebook、LinkedIn 和 Twitter / X 分享按钮组件。
|
| Facebook 分享按钮 | 显示“分享到 Facebook”按钮，并可自定义文本。点击后，按钮会跳转到用户 Facebook 个人主页上的新帖子，并预先填入品牌的社交消息。
|
| X 分享按钮 | 显示“通过 X 分享”按钮，并可自定义文本。点击后，按钮会跳转到用户 X 账户上的新帖子，并预先填入品牌的社交消息。
|
| 邮件分享按钮 | 显示“通过邮件分享”按钮，并可自定义文本。点击后，按钮会打开用户默认的电子邮件应用，并使用预先填入的品牌社交消息创建一封新邮件。
|
| 移动分享面板按钮 | 显示一个可在参与者网页浏览器内分享的按钮。点击后，按钮会打开一个菜单，列出用户可用于分享链接的所有可用应用。选择某个应用后，会使用预先填入的品牌社交消息创建新帖子或消息。
|
| LinkedIn 分享按钮 | 显示“分享到 LinkedIn”按钮，并可自定义文本。点击后，按钮会跳转到用户 LinkedIn 个人主页上的新帖子，并预先填入品牌的社交消息。
|
| 短信分享按钮 | 显示“发短信给好友”按钮，并可自定义文本。点击后，按钮会跳转到用户默认的短信/文本消息应用，并使用预先填入的品牌社交消息创建一条新的短信/文本消息。
|
| Messenger 分享按钮 | 显示“通过 Messenger 分享”按钮，并可自定义文本。点击后，按钮会跳转到用户 Facebook Messenger 应用中的新消息，并预先填入品牌的社交消息。
|
| WhatsApp 分享按钮 | 显示“通过 WhatsApp 分享”按钮，并可自定义文本。点击后，按钮会跳转到用户 Whatsapp 账户中的新消息，并预先填入品牌的社交消息。
|
| LINE 分享按钮 | 显示“通过 Line Messenger 分享”按钮，并可自定义文本。点击后，按钮会跳转到用户 Line Messenger 应用中的新消息，并预先填入品牌的社交消息。
|
| Pinterest 分享按钮 | 显示“分享到 Pinterest”按钮，并可自定义文本。点击后，按钮会跳转到用户 Pinterest 个人主页上的新帖子，并预先填入品牌的社交消息。
|
| 分享链接 | 显示此项目的参与者分享链接。
|
| 二维码 | 以二维码形式显示此项目的参与者分享链接。
|
推荐
*推荐* 组件显示参与者已推荐好友及其转化状态的信息。它们让参与者可以轻松跟踪自己推荐了谁、转化何时发生，以及因这些推荐获得了哪些奖励。
| 组件 | 说明 |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 推荐卡片 | 预格式化的组件块，包含 项目时间线 , 分享链接 、以及 Facebook , LinkedIn、 和 Twitter / X 分享按钮组件。可根据需要添加或移除其他组件。
|
| 推荐表 | 显示一个表格，展示参与者已推荐的好友、转化日期和转化状态。
|
| 推荐表日期列 | 为推荐表再添加一列日期。必须放置在推荐表组件内。
|
| 推荐表奖励列 | 为推荐表再添加一列奖励。必须放置在推荐表组件内。
|
| 推荐表状态列 | 为推荐表再添加一列状态。必须放置在推荐表组件内。
|
| 推荐表用户列 | 为推荐表再添加一列客户（被推荐好友）。必须放置在推荐表组件内。
|
高级
高级组件可让您更好地控制参与者看到什么以及何时看到。它们支持条件显示内容、项目覆盖以及其他专门配置，帮助为特定受众量身定制体验。
| 组件 | 说明 |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 条件区域 / 细分 | 仅当参与者属于某个时才在此部分显示内容 用户分群 .
要设置用户细分，请打开组件属性并编辑以下位置中的 JSONata 表达式： 条件 字段。
位于所设置细分中的用户将看到条件区域中显示的所有内容，而不在该细分中的用户将看不到这些内容。
|
| 条件区域 / 字段 | 仅当 自定义字段 参与者资料上的某个值包含特定值时，才在此部分显示内容。
要设置自定义字段名称和值，请打开组件属性并编辑以下位置中的 JSONata 表达式： 条件 字段。
具有正确自定义字段值的用户将看到条件区域中显示的所有内容，而没有正确自定义字段值的用户将看不到这些内容。
|
| 项目区块 | 项目区块组件允许您覆盖其子组件的项目 ID。当您想显示不与特定项目关联的内容时使用它。默认包含在大多数小部件和微站模板中。
|
排版
排版组件可让您向小部件或微站添加格式化文本块。可从以下内容中选择：
* 段落
* 标题 1
* 标题 2
* 标题 3
* 标题 4
---
# 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/widget-and-microsite-components-explained.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.