> 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。例如，你可以使用一个参数来记录 *电子邮件* 作为 *分享媒介* 当有人通过电子邮件链接访问你的推荐计划落地页时。这使你很容易发现电子邮件流量中的表现趋势。
跟踪参数可以添加到：
* [**落地页链接**](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) —— 你的推荐计划网页的 URL，也就是你希望流量到达的位置。
* [**分享链接**](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) —— 你的倡导者可以分享到不同平台的消息，其中包含诸如其分享链接之类的动态元素。
### 我的链接有哪些参数？
#### 静态参数
当访客打开分享链接或到达你的落地页时，以下参数会默认添加。这些参数是静态的，意味着它们具有不会变化的固定值：
* **`utm_source=invite`** —— 这显示访客来自哪里。我们将其值设为“invite”，这样你就知道流量来自倡导者的推荐。
* **`utm_medium=link`** —— 这显示访客是如何到达你的页面的。我们将其值设为“link”，表示他们点击的是推荐链接，而不是例如广告。
* **`utm_campaign=saasquatch`** —— 这显示此次访问关联的是哪个计划。“Saasquatch”是一个占位值，用于表示你的 Advocate 计划。
#### 动态参数
除了静态参数外，还会添加以下动态参数。动态参数的值会根据是哪位倡导者推荐了客户、他们最初通过哪个计划触点与之接触，以及他们使用哪个渠道与朋友分享链接而变化：
* **`rsCode=JOHNDOE`** —— 这显示是哪位倡导者分享了链接，如果新客户通过该链接注册，应将奖励归于谁，例如，John Doe 被记为奖励对象。
* **`rsEngagementMedium=EMBED`** —— 这显示倡导者首次与链接互动时的起始点，例如，通过嵌入在你网页上的推荐小组件。
* **`rsShareMedium=Email`** —— 这显示倡导者使用哪个渠道与朋友分享了链接，例如，他们将链接包含在一封电子邮件中。
{% hint style="info" %}
**示例：** `https://acmecorporation.com/signup-page?`**`utm_source=invite&utm_medium=link&utm_campaign=saasquatch`****`&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`**
{% endhint %}
### 添加自定义参数
你可以选择在推荐计划链接末尾添加额外的跟踪参数。这对于跟踪更具体的细节很有用，例如折扣码，这样你就可以给被推荐的朋友发放折扣，或者消息组，这样你就可以比较一个渠道相对于另一个渠道的表现。
#### 添加参数的规则
在添加自定义参数之前，你需要了解这样做会如何影响链接的行为：
* 任何直接包含在你配置的落地页 URL 中的参数都会原样传递。
* 不建议移除或更改你这三个默认 UTM 参数的值。
* 如果你确实移除或覆盖了一个默认 UTM 参数（例如， `utm_source=referral`），另外两个将会被删除。
* 要有效覆盖默认值，你必须在落地页 URL 中包含 **全部三个默认 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 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=&goal=
```
`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.
