> 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" %}
**重要：** 请参阅 [配置 Gateway 跟踪设置](/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="/files/f96cda457b7f69ac56661664da014e2d74fc2c0f" 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="/files/dff18c1b014d9f7e7d442a514d1e17130b458808" 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>。在这里，您可以为每个合作伙伴定义最多三个自定义值。这些值最常用于给合作伙伴打标签（例如，influencer、Cashback/Loyalty、Deal 等）。</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}`                           | ”influencers”,”preferred”                | <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>

| 参数类型         | 描述                                                              |
| ------------ | --------------------------------------------------------------- |
| 广告落地页        | 您在广告落地页元数据中配置的参数。（这些参数始终优先，除非请求中提供了深度链接；在这种情况下，深度链接参数会覆盖落地页参数。） |
| 程序跟踪模板       | 您在以下位置配置的参数 **设置 → Gateway** （位于 *跟踪* 部分）→ **程序跟踪模板**.          |
| 合作伙伴 gateway | 您在以下位置配置的参数 **设置 → Gateway** （位于 *跟踪* 部分）→ **程序跟踪模板**.          |
| 透传变量         | 您的合作伙伴可以使用 `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:

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

The question should be specific, self-contained, and written in natural language.
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.