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

# Parâmetros de rastreamento do Advocate explicados

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 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 visita a página de destino do seu programa de indicação por meio de um link de e-mail. Isso facilita identificar tendências de desempenho no tráfego de e-mails.<br>

<div data-with-frame="true"><figure><img src="/files/a2b5ccc967a4cfd089e15ff9554009acd50a1e65" 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/what-would-you-like-to-learn-about/advocate-program/getting-started-with-advocate/configure-your-advocate-program#step-1-set-up-your-program) — A URL da página da web do seu programa de indicação, ou seja, para onde você quer que o tráfego vá.
* [**Links de compartilhamento**](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) — Links gerados automaticamente que seus defensores usam para indicar amigos ao seu programa.
* [**Links de mensagem**](https://help.impact.com/brand/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/message-links-explained) — Mensagens que seus defensores 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 acessa sua página de destino, os seguintes parâmetros são adicionados por padrão. Esses parâmetros são estáticos, o que significa que 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 da indicação de um defensor.
* <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 com qual programa a visita está associada. “Saasquatch” é um valor de espaço reservado para indicar seu programa de Defensores.

#### 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 defensor indica o cliente, com qual ponto de contato do programa eles interagiram primeiro e qual canal usaram para compartilhar o link com amigos:

* **`rsCode=JOHNDOE`** — Isso mostra qual defensor compartilhou o link e deve ser recompensado se um novo cliente se cadastrar por meio do link, por exemplo, John Doe recebeu o crédito.
* **`rsEngagementMedium=EMBED`** — Isso mostra o ponto de partida do defensor quando ele 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`** — Isso mostra qual canal o defensor usou para compartilhar o link com 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 adicionar ao final dos links do seu programa de indicação. Isso é útil para rastrear detalhes mais específicos, como o código de desconto, para que você possa conceder descontos a 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 da sua página de destino configurada sempre serão repassados.
* Não é recomendado 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 descartados.
* 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.
* Todos os 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: Adicione 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 da sua página de destino configurada sempre serão repassados

{% 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: Adicione parâmetros personalizados a um link de compartilhamento

Use esta abordagem para rastrear dados relacionados a um defensor 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 adicionados 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: Adicione 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}`** em 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 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/pt-br/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.