> 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/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.md).

# Advocate 跟踪参数说明

跟踪参数是可以添加到链接末尾的文本片段。它们可将有关推荐流量的特定数据发送到 impact.com。例如，您可以使用参数记录 *电子邮件* 作为 *分享媒介* 这样，每当有人通过电子邮件链接访问您的推荐计划落地页时，就能轻松发现电子邮件流量中的效果趋势。<br>

<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%2FLWCRiIPynY7zLQ7P96hK%2FScreenshot%202026-02-19%20at%204.11.23%E2%80%AFPM.png?alt=media&amp;token=5761f8cd-4e3d-421f-b77c-df545151efd6" alt=""><figcaption></figcaption></figure></div>

可以将跟踪参数添加到：

* [**落地页链接**](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md#step-1-set-up-your-program) — 您的推荐计划网页的网址，即您希望流量前往的页面。
* [**分享链接**](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes.md) — 系统自动生成的链接，倡导者可以使用这些链接向朋友推荐您的计划。
* [**消息链接**](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md) — 倡导者可以分享到不同平台的消息，其中包含其分享链接等动态元素。

### 我的链接包含哪些参数？

#### 静态参数

访客打开分享链接或访问您的落地页时，默认会添加以下参数。这些参数是静态的，意味着其值固定不变：

* <mark style="color:红色;">**`utm_source=invite`**</mark> — 用于显示访客的来源。我们将值设为“invite”，以便您知道流量来自倡导者的推荐。
* <mark style="color:红色;">**`utm_medium=link`**</mark> — 用于显示访客通过何种方式访问您的页面。我们将值设为“link”，表示访客点击的是推荐链接，而非广告等其他内容。
* <mark style="color:红色;">**`utm_campaign=saasquatch`**</mark> — 用于显示此次访问关联的计划。“Saasquatch”是一个占位值，用于表示您的倡导者计划。

#### 动态参数

除了静态参数外，还会添加以下动态参数。动态参数的值会根据推荐客户的倡导者、客户首次接触的计划触点，以及倡导者与朋友分享链接时使用的渠道而变化：

* **`rsCode=JOHNDOE`** — 用于显示分享链接的倡导者。如果新客户通过该链接注册，奖励应发给这位倡导者。例如，奖励会记在 John Doe 名下。
* **`rsEngagementMedium=EMBED`** — 用于显示倡导者首次与链接互动时的起点，例如通过嵌入您网页中的推荐小组件。
* **`rsShareMedium=Email`** — 用于显示倡导者与朋友分享链接时使用的渠道，例如在电子邮件中附上链接。

{% hint style="info" %}
**示例：** `https://acmecorporation.com/signup-page?`<mark style="color:$primary;">**`utm_source=invite&utm_medium=link&utm_campaign=saasquatch`**</mark>**`&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`**
{% endhint %}

### 添加自定义参数

您可以选择要添加到推荐计划链接末尾的其他跟踪参数。这有助于跟踪更具体的信息，例如折扣码（以便向受推荐的朋友提供折扣），或消息群组（以便比较不同渠道的效果）。

#### 添加参数的规则

添加自定义参数前，您需要了解此操作会如何影响链接的行为：

* 直接包含在已配置落地页网址中的任何参数都会始终传递。
* 不建议删除或更改三个默认 UTM 参数的值。
* 如果您确实删除或覆盖了某个默认 UTM 参数（例如， `utm_source=referral`），另外两个参数也会被移除。
* 若要有效覆盖默认值，您必须在落地页网址中包含 **全部三个默认 UTM 参数** 及其新值。
* 您添加的任何自定义参数都必须具有固定的静态值。不支持动态值。
* 为确保报告数据一致，请避免添加重复的自定义参数。

#### 第 1 步：向落地页添加自定义参数

使用此方法传递折扣码和内部跟踪值，或在您希望某条规则适用于每一位受推荐访客时使用。

* 直接包含在已配置的落地页 URL 中的任何参数都会始终传递

{% hint style="info" %}
**示例：** 如果添加 **`discountCode=REFERRED20`**，生成的落地页 URL 将如下所示： `https://acmecorporation.com/signup-page?`**`discountCode=REFERRED20`**`&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`
{% endhint %}

#### 第 2 步：向分享链接添加自定义参数

使用此方法跟踪与特定推荐者相关的数据，以便了解他们带来了多少客户。

* 您可以通过分享链接传递自定义参数，但无法覆盖默认的 UTM 参数
* 任何自定义参数都会追加在落地页参数之后

{% hint style="info" %}
**示例：** 如果将 **`influencer_ID=carrie_oakey`** 添加到分享链接 URL 的末尾，生成的落地页 URL 将如下所示： `https://acmecorporation.com/signup-page?discountCode=REFERRED20&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP&`**`influencer_ID=carrie_oakey`**
{% endhint %}

#### 第 3 步：向消息链接添加自定义参数

使用此方法跟踪并比较定向沟通的效果。

* 您可以通过消息链接传递自定义参数，使用 `rsLandingPage` 参数
* 将落地页 URL（以及任何自定义参数）包含在 `rsLandingPage` 值中

{% hint style="info" %}
**示例：** 如果在消息链接中包含 **`rsLandingPage={https://acmecorporation.com/signup-page?email_test_group=A}`** ，生成的落地页 URL 将如下所示： `https://acmecorporation.com/signup-page?discountCode=REFERRED20&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP&influencer_ID=carrie_oakey&`**`email_test_group=A`**
{% endhint %}


---

# 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/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.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.
