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

跟踪参数可添加到：

* [**落地页链接**](/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) — 您的推荐计划网页的 URL，即您希望流量到达的位置。
* [**分享链接**](/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes.md) — 由倡导者自动生成并用于邀请好友加入您计划的链接。
* [**消息链接**](/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 %}

### 添加自定义参数

您可以选择要添加到推荐计划链接末尾的其他跟踪参数。这对于跟踪更具体的细节很有用，例如折扣码，以便您为被推荐的好友提供折扣，或消息分组，以便您比较一个渠道与另一个渠道的表现。

#### 添加参数的规则

在添加自定义参数之前，您需要了解这样做会如何影响链接的行为：

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

#### 步骤 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.