> 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="/files/49c5787afa781e07268bea75f30ba0632947fc37" alt=""><figcaption></figcaption></figure></div>

跟踪参数可添加到：

* [**落地页链接**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program#step-1-set-up-your-program) — 你的推荐计划群网页的网址，也就是你希望流量去往的地方。
* [**分享链接**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes) — 你的倡导者用来向朋友推荐你的计划的自动生成链接。
* [**消息链接**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained) — 你的倡导者可以分享到不同平台的消息，其中包含诸如其分享链接之类的动态元素。

### 我的链接有哪些参数？

#### 静态参数

当访客打开分享链接或进入你的落地页时，以下参数会默认添加。这些参数是静态的，意味着它们具有不会变化的固定值：

* <mark style="color:红色;">**`utm_source=invite`**</mark> — 这显示访客来自哪里。我们将值设为“invite”，这样你就知道流量来自倡导者的推荐。
* <mark style="color:红色;">**`utm_medium=link`**</mark> — 这显示访客是如何到达你的页面的。我们将值设为“link”，表示他们点击的是推荐链接，而不是广告之类的内容。
* <mark style="color:红色;">**`utm_campaign=saasquatch`**</mark> — 这显示此次访问关联的是哪个计划。“Saasquatch”是一个占位值，用于表示你的 Advocate 计划。

#### 动态参数

除了静态参数之外，还会添加以下动态参数。动态参数的值会根据是哪位倡导者推荐了客户、他们最先通过哪个计划接触点建立联系，以及他们用哪个渠道将链接分享给朋友而变化：

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