> 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%2FDXBg2HskLJz31L1Xssnr%2Fprogram_tracking.png?alt=media&amp;token=73b73cfc-988f-451e-bce3-cceffaf027b9" 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>。你需要一个 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 建议联系支持团队（或你的 CSM）以讨论你的具体使用场景。</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.