> 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/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md).
# 创建自定义小组件
开发动态工具，帮助合作伙伴推广您的品牌。自定义组件可让您通过 iframe 将外部托管的工具或页面直接嵌入 impact.com 界面。本指南将帮助您创建并配置自定义内容组件，为合作伙伴提供个性化资源和一致的品牌体验。
{% stepper %}
{% step %}
#### 访问自定义组件创建器
1. 从左侧导航菜单中，选择  **\[Engage]** → **内容** → [**组件**](https://app.impact.com/secure/advertiser/engage/ads/list-widget-tool-flow.ihtml)**.**
2. 在右上角，选择 **创建组件** → **自定义**.
{% endstep %}
{% step %}
#### 输入组件详细信息
1. 输入一个 **名称** 自定义组件的。
2. 可选地，输入一个 **描述** 用于自定义组件。
3. 可选地，输入一个 **标签** 用于自定义组件。
4. 如有需要，  **\[打开开关] 限制合作伙伴访问** 以指定应有权访问该组件的单个合作伙伴和组。
* **合作伙伴：** 输入可访问自定义组件的合作伙伴名称。
* **组：** 输入可访问自定义组件的组名称。
{% endstep %}
{% step %}
#### 配置组件
1. 从显示选项中选择该组件的行为方式：
* **在新标签页中打开：** 在单独的标签页中打开托管 URL。
* **嵌入 impact.com：** 直接在平台界面中显示该组件。
2. 可选地，在 **预览图片** 部分下，选择 **选择文件** 字段中上传缩略图。确保文件为 GIF、JPG 或 PNG，且不超过 512 KB。
3. 在 **小组件 URL** 字段中，输入您的组件托管所在的网址。
4. 从 **\[下拉菜单]**，选择与您网站安全性匹配的协议（例如 https\://）。
5. 如有需要，选择  **\[添加] 插入动态字段** 以展开令牌列表。
6. 找到要使用的令牌并选择 **插入**。平台会自动将令牌（例如 {irpid}）附加到您的 **小组件 URL**。请参阅 [动态字段令牌](#dynamic-field-tokens) 下方部分，以查看每个令牌的说明。
{% endstep %}
{% step %}
#### 更新高级设置
从 **语言** **\[下拉菜单]**，选择此组件显示的语言。
{% endstep %}
{% step %}
#### 完成自定义组件
选择 **创建** 以保存您的组件。合作伙伴可以在 *内容组件*.
{% endstep %}
{% endstepper %}
动态字段令牌
| 令牌 | 描述 |
| ------------------------------ | -------------------- |
| `{click_url_encoded}` | 点击 URL（已编码） |
| `{click_url}` | 点击 URL（未编码） |
| `{irimpurl}` | 我们的展示 URL |
| `{irpid}` | 合作伙伴 ID |
| `{subid1}` | 合作伙伴子 ID 1 |
| `{subid2}` | 合作伙伴子 ID 2 |
| `{subid3}` | 合作伙伴子 ID 3 |
| `{sharedId}` | 共享 ID |
| `{iradid}` | 广告 ID |
| `{ircid}` | 项目 ID |
| `{click_url_encoded_deeplink}` | 已编码的点击 URL，附加深度链接参数。 |
---
# 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/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.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.