> 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 奖励代码。
该 奖励 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 得分将与已发起的推荐数量相对应。
|
| 推荐转化 | 此类排行榜按参与者转化的推荐数量进行排名。只有当被推荐好友达成计划目标，例如完成你定义价值的购买时，推荐才视为已转化。你的客户 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/advocate-rewards/pay-with-cash/cash-payouts-for-advocate-explained.md) 功能已为你的账户开启时可用。
| 组件 | 说明 |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 合作伙伴信息弹窗 | 插入一个弹窗，用于收集参与者的国家和货币信息。这些信息可确保参与者顺利领取奖励，而不会延迟或增加额外设置步骤。
根据参与者的电子邮件是否已关联到现有账户，它有两种可配置状态：
新合作伙伴说明 ：显示给首次参与者。默认文案（“立即确认你的国家和货币，以更快获得未来奖励”）会提示他们在收到分享链接前先提供详细信息。现有合作伙伴说明 ：当参与者的电子邮件已与 impact.com 上的账户关联时显示。该弹窗会预填他们的信息，并要求他们确认，而不是从头重新输入。在参与者可获得现金付款之前，提醒他们需要完成的操作。该组件包含一个行动按钮，可引导参与者查看其付款设置。
你也可以根据需要自定义参与者在查看组件时将看到的任意文本说明。
|
| 微型网站和小组件现金付款表单 | 插入一个表单，用于收集参与者的银行信息以及任何适用的税务表格，例如 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.
