> 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" %}
**重要：** 请参阅 [配置网关跟踪设置](/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%2FbDxnCa31osyQYVDuWuwr%2FScreenshot%202026-04-21%20at%2016.38.46.png?alt=media&amp;token=10cb955b-9f1d-458b-8202-e54a150930df" alt=""><figcaption></figcaption></figure></div>

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

* 您可以在这里为合作伙伴跟踪链接添加全局查询字符串参数。如果点击来自某个合作伙伴的跟踪链接，则会应用您在模板中设置的参数。这里是添加 UTM 参数的好地方。了解如何 [使用 Google Analytics 收集营销活动数据](/brand/zh/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/collect-campaign-data-with-google-analytics.md) 使用 UTM 参数。请参阅 *查询字符串参数参考* 以获取帮助。

<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}`                                | mediapartner                             | <p><strong>impact.com 媒体类型</strong></p><p>这将返回 <em>mediapartner</em> 或 <em>mediasource</em> 中的任意一个，具体取决于点击来源——来自您的某个合作伙伴，还是来自您的某个媒体来源（例如来自搜索引擎的流量）。</p>                                                                                                                                                                                   |
| `{sharedid}`                                |                                          | <p><strong>共享 ID</strong></p><p>合作伙伴可以将 Shared ID 值作为查询字符串参数追加到他们自己的跟踪链接中，之后您可以在报告中看到该值。当跟踪链接被点击时，如果可用，这里将自动填充合作伙伴指定的 Shared ID。</p>                                                                                                                                                                                                      |
| `{mp_value1}`, `{mp_value2}`, `{mp_value3}` | 交易                                       | <p><strong>合作伙伴自定义值</strong></p><p>这里将填充您可以分配给合作伙伴的自定义值。 <strong>此设置适用于您的整个账户，而不只是单个程序/活动</strong>.</p><p>可在 <strong>合作伙伴 → 合作伙伴 → 操作 → 跟踪</strong>。从这里，您可以为每个合作伙伴定义最多三个自定义值。这些值最常用于给合作伙伴打标签（例如：网红、返现/忠诚、优惠等）。</p><p>您还可以在 <strong>合作伙伴 → 合作伙伴 → 批量编辑</strong>。中批量上传和编辑合作伙伴自定义值。您需要一个包含合作伙伴 ID 以及您想分配给该合作伙伴的合作伙伴值本身的 Excel 或 CSV 文件。</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 建议联系支持团队（或您的 CSM）来讨论您的具体使用场景。</p>                                                                                                                                                                                                                                                 |

</details>

#### 参数去重说明

程序中为广告指定的各种参数有时会导致返回重复值，尤其是在多个参数同名时。重复的参数值可能会导致 impact.com 的报告与您更广泛的营销团队工具（例如 Google Analytics）的报告之间出现差异。为避免这种情况，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 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/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md?ask=<question>&goal=<endgoal>
```

`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.