> 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/pt-br/what-would-you-like-to-learn-about/advocate-program/advocate-tracking/advocate-tracking-parameters-explained.md).

# Explicação sobre parâmetros de rastreamento do Advocate

Os parâmetros de rastreamento são trechos de texto que podem ser adicionados ao final de um link. Eles permitem enviar dados específicos sobre o tráfego de indicação para a impact.com. Por exemplo, você pode usar um parâmetro para registrar *E-mail* como o *canal de compartilhamento* sempre que alguém visitar a página de destino do seu programa de indicações por meio de um link de e-mail. Assim, fica fácil identificar tendências de desempenho no tráfego de e-mail.<br>

<div data-with-frame="true"><figure><img src="https://526234278-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>

Os parâmetros de rastreamento podem ser adicionados a:

* [**Links da página de destino**](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program.md#step-1-set-up-your-program) — O URL da página do seu programa de indicações, ou seja, para onde você quer direcionar o tráfego.
* [**Links de compartilhamento**](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/assign-vanity-share-links-or-referral-codes.md) — Links gerados automaticamente que seus defensores usam para indicar amigos ao seu programa.
* [**Links de mensagens**](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md) — Mensagens que seus defensores podem compartilhar em diferentes plataformas, incluindo elementos dinâmicos, como o link de compartilhamento deles.

### Quais parâmetros meus links têm?

#### Parâmetros estáticos

Quando alguém acessa um link de compartilhamento ou chega à sua página de destino, os seguintes parâmetros são adicionados por padrão. Esses parâmetros são estáticos, ou seja, têm valores fixos que não mudam:

* <mark style="color:vermelho;">**`utm_source=invite`**</mark> — Indica de onde o visitante veio. Definimos o valor como “invite” para que você saiba que o tráfego veio da indicação de um defensor.
* <mark style="color:vermelho;">**`utm_medium=link`**</mark> — Indica como o visitante chegou à sua página. Definimos o valor como “link”, o que significa que ele clicou em um link de indicação, e não em um anúncio, por exemplo.
* <mark style="color:vermelho;">**`utm_campaign=saasquatch`**</mark> — Indica a qual programa a visita está associada. “Saasquatch” é um valor provisório que identifica seu programa de defensores.

#### Parâmetros dinâmicos

Além dos parâmetros estáticos, os seguintes parâmetros dinâmicos são adicionados. Os valores dos parâmetros dinâmicos mudam de acordo com o defensor que indica o cliente, o ponto de contato do programa com o qual ele interagiu primeiro e o canal usado para compartilhar o link com os amigos:

* **`rsCode=JOHNDOE`** — Indica qual defensor compartilhou o link e deve receber a recompensa se um novo cliente se cadastrar por meio dele. Por exemplo, John Doe recebeu o crédito pela indicação.
* **`rsEngagementMedium=EMBED`** — Indica o ponto de partida do defensor quando interagiu com o link pela primeira vez, por exemplo, por meio de um widget de indicação incorporado à sua página da web.
* **`rsShareMedium=Email`** — Indica qual canal o defensor usou para compartilhar o link com os amigos. Por exemplo, ele incluiu o link em um e-mail.

{% hint style="info" %}
**Exemplo:** `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 %}

### Adicionar parâmetros personalizados

Você pode escolher parâmetros de rastreamento adicionais para incluir no final dos links do seu programa de indicações. Isso é útil para acompanhar detalhes mais específicos, como o código de desconto, para conceder descontos aos amigos indicados, ou o grupo de mensagens, para comparar o desempenho de um canal com o de outro.

#### Regras para adicionar parâmetros

Antes de adicionar parâmetros personalizados, você precisa entender como isso afetará o comportamento dos seus links:

* Todos os parâmetros incluídos diretamente no URL configurado da página de destino serão sempre mantidos.
* Não recomendamos remover os três parâmetros UTM padrão nem alterar seus valores.
* Se você remover ou substituir um dos parâmetros UTM padrão (por exemplo, `utm_source=referral`), os outros dois também serão removidos.
* Para substituir os valores padrão corretamente, você precisa incluir **todos os três parâmetros UTM padrão** e seus novos valores no URL da página de destino.
* Todos os parâmetros personalizados adicionados precisam ter valores estáticos fixos. Valores dinâmicos não são compatíveis.
* Para garantir a consistência dos dados de relatórios, evite adicionar parâmetros personalizados duplicados.

#### Etapa 1: adicionar parâmetros personalizados a uma página de destino

Use esta abordagem para transmitir códigos de desconto e valores de rastreamento internos ou sempre que quiser aplicar uma regra a todos os visitantes indicados.

* Quaisquer parâmetros incluídos diretamente no URL da sua página de destino configurada sempre serão repassados

{% hint style="info" %}
**Exemplo:** Se você adicionar **`discountCode=REFERRED20`**, o URL resultante da página de destino ficará assim: `https://acmecorporation.com/signup-page?`**`discountCode=REFERRED20`**`&utm_source=invite&utm_medium=link&utm_campaign=saasquatch&rsCode=OLIVERSUTTON&rsEngagementMedium=POPUP&rsShareMedium=WHATSAPP`
{% endhint %}

#### Etapa 2: Adicionar parâmetros personalizados a um link de compartilhamento

Use essa abordagem para rastrear dados relacionados a um defensor específico e saber quantos clientes ele atrai.

* Você pode repassar parâmetros personalizados por meio de um link de compartilhamento, mas não pode substituir os UTMs padrão
* Quaisquer parâmetros personalizados são anexados após os parâmetros da página de destino

{% hint style="info" %}
**Exemplo:** Se você adicionar **`influencer_ID=carrie_oakey`** ao final do URL do seu link de compartilhamento, o URL resultante da página de destino ficará assim: `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 %}

#### Etapa 3: Adicionar parâmetros personalizados a um link de mensagem

Use essa abordagem para rastrear e comparar o desempenho de comunicações direcionadas.

* Você pode repassar parâmetros personalizados por meio de um link de mensagem usando o parâmetro `rsLandingPage` O
* Inclua o URL da sua página de destino — junto com quaisquer parâmetros personalizados — no valor de `rsLandingPage` Exemplo:

{% hint style="info" %}
**Se você incluir** rsLandingPage={<https://acmecorporation.com/signup-page?email\\_test\\_group=A}> **`no link da sua mensagem, o URL resultante da página de destino ficará assim:`** <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`**`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/pt-br/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.
