> 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).
# 创建自定义 Widget
开发动态工具，帮助合作伙伴推广您的品牌。自定义组件允许您通过 iframe 将外部托管的工具或页面直接嵌入 impact.com 界面。使用本指南创建并配置一个自定义内容组件，为您的合作伙伴提供个性化资源和一致的品牌体验。
{% stepper %}
{% step %}
#### 访问自定义组件创建器
1. 从左侧导航菜单中，选择  **\[互动]** → **内容** → [**小组件**](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.