> 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/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md).

# 网关跟踪模板

{% hint style="warning" %}
**重要提示：** 请参阅 [配置网关跟踪设置](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md) 然后再继续阅读本文。
{% endhint %}

#### 项目跟踪模板

* 您可以在此处为项目中的所有跟踪链接定义查询字符串参数。这些参数将应用于来自所有媒体来源和合作伙伴的链接。有关帮助，请参阅下方的 *查询字符串参数参考* 。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FDXBg2HskLJz31L1Xssnr%2Fprogram_tracking.png?alt=media&amp;token=73b73cfc-988f-451e-bce3-cceffaf027b9" alt=""><figcaption></figcaption></figure></div>

#### 合作伙伴跟踪模板

* 您可以在此处向合作伙伴跟踪链接添加全局查询字符串参数。如果点击来自合作伙伴的跟踪链接，则会应用您在模板中设置的参数。此处适合添加 UTM 参数。了解如何使用 UTM 参数 [通过 Google Analytics 收集营销活动数据](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/collect-campaign-data-with-google-analytics.md) 。有关帮助，请参阅下方的 *查询字符串参数参考* 。

<div data-with-frame="true"><figure><img src="https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FifK7GKmmxfT7BlPUhu4H%2FScreenshot%202026-04-21%20at%2017.05.22.png?alt=media&amp;token=a1dc3868-e027-4699-8872-9d424de79272" alt="" width="563"><figcaption></figcaption></figure></div>

#### 跟踪模板的查询字符串参数

* 带有花括号 ({}) 的参数是动态查询字符串，点击链接时会自动填入相应的值
* 支持硬编码值。只需添加不带花括号 ({}) 的值，该值就会在每次点击时传递。
* 支持自定义值，但我们建议 [联系支持团队](https://app.impact.com/support/portal.ihtml?createTicket=true) 以了解如何使用这些值。

<details>

<summary>查询字符串参数参考</summary>

| URL 参数                                      | 示例                                       | 说明                                                                                                                                                                                                                                                                                                                                                           |
| ------------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `{clickid}`                                 | 2uz3sQWFlxyJRcqwUx 0Mo34VUkiyviUnPwZbQM0 | <p><strong>点击 ID</strong></p><p>impact.com 分配的唯一 ID，与点击事件相关联。点击跟踪链接时，此参数将填入与客户关联的唯一点击 ID。</p>                                                                                                                                                                                                                                                                |
| `{iradid}`                                  | 828416                                   | <p><strong>impact.com 广告 ID</strong></p><p>与点击事件关联的广告的唯一 ID。点击跟踪链接时，此参数将填入与该次点击关联的广告 ID。</p>                                                                                                                                                                                                                                                                 |
| `{ircid}`                                   | 10306                                    | <p><strong>impact.com 营销活动/项目 ID</strong></p><p>与您的 impact.com 项目（营销活动）关联的唯一 ID。点击跟踪链接时，此参数将填入与该次点击关联的营销活动/项目 ID。</p>                                                                                                                                                                                                                                        |
| `{irpid}`                                   | 1234567                                  | <p><strong>impact.com 合作伙伴 ID</strong></p><p>分配给促成此次点击的合作伙伴的唯一 ID。点击跟踪链接时，此参数将填入与该次点击关联的合作伙伴 ID。</p>                                                                                                                                                                                                                                                         |
| `{iradname}`                                | 我的广告                                     | <p><strong>impact.com 广告名称</strong></p><p>您为与此次点击关联的广告指定的名称。点击跟踪链接时，此参数将填入该广告的名称。</p>                                                                                                                                                                                                                                                                        |
| `{iradtype}`                                | 横幅                                       | <p><strong>impact.com 广告类型</strong></p><p>在 impact.com 中创建广告时，您需要在上传创意素材前指定广告类型（例如横幅、文本、图片）。点击跟踪链接时，此参数将填入广告类型。</p>                                                                                                                                                                                                                                          |
| `{iradsize}`                                | 100x100                                  | <p><strong>impact.com 广告尺寸</strong></p><p>impact.com 要求您指定广告尺寸。点击跟踪链接时，此参数将填入创建广告时指定的尺寸。</p>                                                                                                                                                                                                                                                                 |
| `{prodsku}`                                 | 123ABC987                                | <p><strong>产品 SKU</strong></p><p>分配给与广告关联产品的唯一 SKU。点击跟踪链接时，此参数将填入与该广告关联的产品 SKU 值。</p>                                                                                                                                                                                                                                                                        |
| `{irmpname}`                                | CoyoteInfluencer                         | <p><strong>impact.com 合作伙伴名称</strong></p><p>impact.com 中合作伙伴的名称。点击跟踪链接时，此参数将填入与该次点击关联的合作伙伴名称。</p><p><strong>注意：</strong> 合作伙伴的名称可能重复或包含特殊字符，这可能会影响数据分析结果。为确保数据准确，请改用 <code>{irpid}</code> 。（您可以在 <a href="https://app.impact.com/secure/advertiser/report/viewReport.report?handle=adv_mp_date_joined"><em>合作伙伴列表报告</em></a>.)</p>                           |
| `{irmptype}`                                | 媒介合作伙伴                                   | <p><strong>impact.com 媒体类型</strong></p><p>此处将返回 <em>媒介合作伙伴</em> 或 <em>媒体来源</em> 具体取决于点击的来源：可能来自您的某个合作伙伴，也可能来自您的某个媒体来源（例如来自搜索引擎的流量）。</p>                                                                                                                                                                                                                      |
| `{sharedid}`                                |                                          | <p><strong>共享 ID</strong></p><p>合作伙伴可以将共享 ID 值作为查询字符串参数附加到自己的跟踪链接中，您随后便可在报告中查看该值。有人点击跟踪链接后，如果合作伙伴指定了共享 ID，该参数就会自动填入该值。</p>                                                                                                                                                                                                                                   |
| `{mp_value1}`, `{mp_value2}`, `{mp_value3}` | 优惠                                       | <p><strong>合作伙伴自定义值</strong></p><p>此处将填入您可分配给合作伙伴的自定义值。 <strong>此设置适用于您的整个账户，而不仅限于单个计划/营销活动</strong>.</p><p>您可以在以下位置为合作伙伴分配自定义值： <strong>合作伙伴 → 合作伙伴 → 操作 → 跟踪</strong>。在此处，您最多可以为每个合作伙伴定义三个自定义值。这些值最常用于标记合作伙伴（例如：网红、返现/忠诚度、优惠等）。</p><p>您还可以在以下位置批量上传和编辑合作伙伴自定义值： <strong>合作伙伴 → 合作伙伴 → 批量编辑</strong>。您需要准备一个 Excel 或 CSV 文件，其中包含合作伙伴 ID 以及要分配给相应合作伙伴的值。</p> |
| `{timestamp}`                               | 1598556546                               | <p><strong>时间戳</strong></p><p>生成点击事件发生时的 UNIX 时间戳。有人点击跟踪链接后，该时间戳将作为查询字符串参数附加。它可在某些平台上用作缓存清除参数。</p>                                                                                                                                                                                                                                                           |
| `{randint}`                                 | 1,234,567                                | <p><strong>随机整数</strong></p><p>有人点击跟踪链接时，生成一个介于 0–9,999,999 之间的随机整数。</p>                                                                                                                                                                                                                                                                                     |
| `{impacttest}`                              | 1                                        | <p><strong>测试</strong></p><p>测试跟踪链接时，请附加此参数。</p>                                                                                                                                                                                                                                                                                                             |
| `{irmpgroupname}`                           | ”网红”,”优选”                                | <p><strong>组名称</strong></p><p>在查询字符串中列出合作伙伴所属的一个或多个组。</p>                                                                                                                                                                                                                                                                                                    |
| `{CUSTOM}`                                  |                                          | <p><strong>自定义</strong></p><p>使用自定义动态查询字符串参数。impact.com 建议联系支持团队（或您的客户成功经理）讨论您的具体使用场景。</p>                                                                                                                                                                                                                                                                   |

</details>

#### 参数去重说明

由于 impact.com 支持多种应用参数的方法，如果配置了多种方法，就可能发生冲突。为解决此类冲突，impact.com 仅采用一个参数及其值，并按以下优先级顺序（从高到低）处理。此顺序优先采用品牌指定的参数，而非合作伙伴指定的参数：

<details>

<summary>参数类型参考</summary>

| 参数类型      | 说明                                                                     |
| --------- | ---------------------------------------------------------------------- |
| 广告落地页     | 您在广告落地页元数据中配置的参数。（除非请求中提供了深层链接，否则这些参数始终具有最高优先级；如果提供了深层链接，其参数将覆盖落地页参数。） |
| 计划跟踪模板    | 您在以下位置配置的参数： **设置 → 网关** （位于 *跟踪* 部分）→ **计划跟踪模板**.                     |
| 合作伙伴跟踪模板  | 您在以下位置配置的参数： **设置 → 网关** （位于 *跟踪* 部分）→ **计划跟踪模板**.                     |
| 透传变量      | 合作伙伴可使用以下表示法在深层链接中指定的参数： `p.` 。（在少数情况下，透传参数可能会覆盖您指定的参数。）               |
| 深层链接查询字符串 | 合作伙伴可使用这些参数传递深层链接，其中包含预定义的落地页查询字符串参数。                                  |

</details>

<details>

<summary>示例</summary>

如果 `utm_medium` 参数同时附加到合作伙伴使用的落地页深层链接和你自己的 *计划跟踪模板* 如下所示：

* *深层链接 URL：* `https://brand.example?utm_medium=seo`
* *计划跟踪模板：* `https://brand.example?utm_medium=affiliate`

  最终落地页将是：
* *计划跟踪模板：* `https://brand.example?utm_medium=`**`affiliate`**

  这是因为 *计划跟踪模板* 参数由你定义，因此优先级高于合作伙伴定义的参数。

</details>


---

# 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/account-administration/program-settings/tracking-settings/gateway-tracking-templates.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.
