> 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

Parâmetros de rastreamento são trechos de texto que podem ser adicionados ao final de um link. Eles permitem que dados específicos sobre o seu tráfego de indicação sejam enviados para a impact.com. Por exemplo, você poderia usar um parâmetro para registrar *E-mail* como o *meio 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. Isso facilita identificar tendências de desempenho no seu 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>

Parâmetros de rastreamento podem ser adicionados a:

* [**Links da página de destino**](/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) — A URL da página web do seu programa de indicações, ou seja, para onde você quer direcionar o tráfego.
* [**Links de compartilhamento**](/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 promotores usam para indicar amigos ao seu programa.
* [**Links de mensagem**](/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained.md) — Mensagens que seus promotores podem compartilhar em diferentes plataformas, que incluem elementos dinâmicos como o link de compartilhamento deles.

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

#### Parâmetros estáticos

Quando um visitante abre 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 definidos que não mudam:

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

#### Parâmetros dinâmicos

Além dos seus parâmetros estáticos, os seguintes parâmetros dinâmicos são adicionados. Os valores dos parâmetros dinâmicos mudam dependendo de qual promotor indica o cliente, com qual ponto de contato do programa ele entrou em contato primeiro e qual canal ele usou para compartilhar o link com os amigos:

* **`rsCode=JOHNDOE`** — Isso mostra qual promotor compartilhou o link e deve ser recompensado se um novo cliente se cadastrar por meio dele, por exemplo, John Doe recebeu crédito.
* **`rsEngagementMedium=EMBED`** — Isso mostra o ponto de partida do promotor quando ele interagiu pela primeira vez com o link, por exemplo, por meio de um widget de indicação incorporado à sua página da web.
* **`rsShareMedium=Email`** — Isso mostra qual canal o promotor 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 que deseja que sejam adicionados ao final dos links do seu programa de indicações. Isso é útil para rastrear detalhes mais específicos, como o código de desconto, para que você possa oferecer descontos aos amigos indicados, ou o grupo da mensagem, para que você possa comparar o desempenho de um canal em relação a outro.

#### Regras para adicionar parâmetros

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

* Quaisquer parâmetros incluídos diretamente na URL configurada da sua página de destino sempre serão passados.
* Não é recomendável remover ou alterar o valor dos seus três parâmetros UTM padrão.
* Se você remover ou substituir um dos seus parâmetros UTM padrão (por exemplo, `utm_source=referral`), os outros dois serão removidos.
* Para substituir os valores padrão de forma eficaz, você deve incluir **todos os três parâmetros UTM padrão** e seus novos valores na URL da sua página de destino.
* Quaisquer parâmetros personalizados que você adicionar devem ter valores estáticos definidos. Valores dinâmicos não são suportados.
* Para garantir dados de relatório consistentes, evite adicionar parâmetros personalizados duplicados.

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

Use esta abordagem para passar códigos de desconto e valores de rastreamento internos, ou sempre que quiser que uma regra se aplique a cada visitante indicado.

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

{% hint style="info" %}
**Exemplo:** Se você adicionar **`discountCode=REFERRED20`**, a 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 esta abordagem para rastrear dados relacionados a um promotor específico, para que você possa ver quantos clientes ele traz.

* Você pode passar 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 acrescentados após os parâmetros da página de destino

{% hint style="info" %}
**Exemplo:** Se você adicionar **`influencer_ID=carrie_oakey`** ao final da URL do seu link de compartilhamento, a 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 esta abordagem para rastrear e comparar o desempenho de comunicações segmentadas.

* Você pode passar parâmetros personalizados por meio de um link de mensagem usando o `rsLandingPage` parâmetro
* Inclua a URL da sua página de destino — junto com quaisquer parâmetros personalizados — dentro do `rsLandingPage` valor

{% hint style="info" %}
**Exemplo:** Se você incluir **`rsLandingPage={https://acmecorporation.com/signup-page?email_test_group=A}`** no seu link de mensagem, a 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`**
{% 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.