> 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/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md).

# Modelos de rastreamento do gateway

{% hint style="warning" %}
**Importante:** Consulte [Configure as configurações de rastreamento do Gateway](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/configure-gateway-tracking-settings.md) antes de continuar com este artigo de ajuda.
{% endhint %}

#### Modelo de rastreamento do programa

* É aqui que você pode definir parâmetros da string de consulta para todos os links de rastreamento dentro do seu programa. Esses parâmetros serão aplicados aos links de todas as suas fontes de mídia e parceiros. Consulte a *Referência de parâmetros da string de consulta* abaixo para obter ajuda.

<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%2FDXBg2HskLJz31L1Xssnr%2Fprogram_tracking.png?alt=media&amp;token=73b73cfc-988f-451e-bce3-cceffaf027b9" alt=""><figcaption></figcaption></figure></div>

#### Modelo de rastreamento de parceiro

* É aqui que você pode adicionar parâmetros globais da string de consulta aos links de rastreamento de parceiros. Se um clique vier de um link de rastreamento de um parceiro, os parâmetros que você definir no modelo serão aplicados. Este é um bom lugar para adicionar parâmetros UTM. Saiba como [coletar dados da campanha com o Google Analytics](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/collect-campaign-data-with-google-analytics.md) usando parâmetros UTM. Consulte a *Referência de parâmetros da string de consulta* abaixo para obter ajuda.

<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%2FifK7GKmmxfT7BlPUhu4H%2FScreenshot%202026-04-21%20at%2017.05.22.png?alt=media&amp;token=a1dc3868-e027-4699-8872-9d424de79272" alt="" width="563"><figcaption></figcaption></figure></div>

#### Parâmetros da string de consulta para modelos de rastreamento

* Parâmetros com chaves ({}) são strings de consulta dinâmicas que serão preenchidas automaticamente com um valor quando o link for clicado
* Valores fixos são compatíveis. Basta adicionar um valor sem chaves ({}), e ele sempre será passado em um clique.
* Valores personalizados são compatíveis; no entanto, recomendamos [entrar em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true) para discutir como usá-los.

<details>

<summary>Referência de parâmetros da string de consulta</summary>

| Parâmetro de URL                            | Exemplo                                  | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ------------------------------------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{clickid}`                                 | 2uz3sQWFlxyJRcqwUx 0Mo34VUkiyviUnPwZbQM0 | <p><strong>ID do clique</strong></p><p>ID exclusivo atribuído pelo impact.com associado ao evento de clique. Quando um link de rastreamento é clicado, isso será preenchido com o ID exclusivo do clique associado ao cliente.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `{iradid}`                                  | 828416                                   | <p><strong>ID do anúncio do impact.com</strong></p><p>ID exclusivo associado ao anúncio vinculado ao evento de clique. Quando um link de rastreamento é clicado, isso será preenchido com o ID do anúncio associado ao clique.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `{ircid}`                                   | 10306                                    | <p><strong>ID da campanha/programa do impact.com</strong></p><p>ID exclusivo associado ao seu programa (campanha) no impact.com. Quando um link de rastreamento é clicado, isso será preenchido com o ID da campanha/programa associado ao clique.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `{irpid}`                                   | 1234567                                  | <p><strong>ID do parceiro do impact.com</strong></p><p>ID exclusivo atribuído ao parceiro que gerou o clique. Quando um link de rastreamento é clicado, isso será preenchido com o ID do parceiro associado ao clique.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `{iradname}`                                | Meu Anúncio                              | <p><strong>Nome do anúncio do impact.com</strong></p><p>O nome que você atribuiu ao anúncio associado ao clique. Quando um link de rastreamento é clicado, isso será preenchido com o nome do anúncio.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `{iradtype}`                                | Banner                                   | <p><strong>Tipo de anúncio do impact.com</strong></p><p>Quando você cria anúncios no impact.com, você define o tipo do anúncio (por exemplo, banner, texto, imagem) antes de enviar o criativo. Quando um link de rastreamento é clicado, isso será preenchido com o tipo de anúncio.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `{iradsize}`                                | 100x100                                  | <p><strong>Tamanho do anúncio do impact.com</strong></p><p>O impact.com exige que você especifique o tamanho de um anúncio. Quando um link de rastreamento é clicado, isso será preenchido com o tamanho do anúncio que você especificou quando ele foi criado.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `{prodsku}`                                 | 123ABC987                                | <p><strong>SKU do produto</strong></p><p>SKU exclusivo atribuído ao produto associado ao anúncio. Quando um link de rastreamento é clicado, isso será preenchido com o valor do SKU do produto associado ao anúncio.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `{irmpname}`                                | CoyoteInfluencer                         | <p><strong>Nome do parceiro no impact.com</strong></p><p>O nome do parceiro no impact.com. Quando um link de rastreamento é clicado, isso será preenchido com o nome do parceiro associado ao clique.</p><p><strong>Observação:</strong> Os parceiros podem ter nomes duplicados ou nomes com caracteres especiais, o que provavelmente distorcerá os resultados da sua análise de dados. Para garantir dados precisos, use <code>{irpid}</code> em vez disso. (Você pode consultar os IDs dos parceiros no <a href="https://app.impact.com/secure/advertiser/report/viewReport.report?handle=adv_mp_date_joined"><em>Relatório de listagem de parceiros</em></a>.)</p>                                                                                                                                                                                                                                           |
| `{irmptype}`                                | mediapartner                             | <p><strong>Tipo de mídia do impact.com</strong></p><p>Isso retornará <em>mediapartner</em> ou <em>mediasource</em> dependendo de onde o clique se originou — seja de um dos seus parceiros ou de uma das suas fontes de mídia (como tráfego de um mecanismo de busca).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `{sharedid}`                                |                                          | <p><strong>ID Compartilhado</strong></p><p>Os parceiros podem anexar um valor de ID Compartilhado como parâmetro da string de consulta aos seus próprios links de rastreamento, que depois fica visível para você nos relatórios. Quando um link de rastreamento é clicado, isso será preenchido automaticamente com o ID Compartilhado que um parceiro tiver especificado, se उपलब्धível.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `{mp_value1}`, `{mp_value2}`, `{mp_value3}` | Oferta                                   | <p><strong>Valor personalizado do parceiro</strong></p><p>Isso será preenchido com um valor personalizado que você pode atribuir a um parceiro. <strong>Essa configuração é aplicada em toda a sua conta, não apenas para um único Programa/Campanha</strong>.</p><p>Valores personalizados podem ser atribuídos aos parceiros em <strong>Parceiros → Parceiros → Ações → Rastreamento</strong>. A partir daí, você pode definir até três valores personalizados para cada parceiro. Eles são mais comumente usados para rotular parceiros (por exemplo, influenciador, Cashback/Fidelidade, Oferta etc.).</p><p>Você também pode enviar em massa e editar valores personalizados de parceiros em <strong>Parceiros → Parceiros → Edição em massa</strong>. Você precisará de um arquivo Excel ou CSV com os IDs dos parceiros, bem como os próprios Valores do Parceiro que deseja atribuir a esse parceiro.</p> |
| `{timestamp}`                               | 1598556546                               | <p><strong>Carimbo de data/hora</strong></p><p>Gera o timestamp UNIX quando o evento de clique ocorreu. Quando um link de rastreamento é clicado, isso será acrescentado como um parâmetro da string de consulta. Isso pode ser usado como um anti-cache em algumas plataformas.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `{randint}`                                 | 1,234,567                                | <p><strong>Inteiro aleatório</strong></p><p>Gera um inteiro aleatório entre 0 e 9.999.999 quando um link de rastreamento é clicado.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `{impacttest}`                              | 1                                        | <p><strong>Teste</strong></p><p>Anexe este parâmetro ao testar seus links de rastreamento.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `{irmpgroupname}`                           | ”influenciadores”,”preferenciais”        | <p><strong>Nome do grupo</strong></p><p>Lista um ou vários grupos aos quais um parceiro pertence dentro de uma string de consulta.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `{CUSTOM}`                                  |                                          | <p><strong>Personalizado</strong></p><p>Use um parâmetro personalizado dinâmico da string de consulta. O impact.com recomenda entrar em contato com o suporte (ou com seu CSM) para discutir seu caso de uso específico.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

</details>

#### Explicação da desduplicação de parâmetros

Como o impact.com oferece suporte a vários métodos para aplicar parâmetros, é possível criar conflitos se mais de um método estiver configurado. Para resolver quaisquer conflitos, o impact.com considera apenas um único parâmetro e valor na seguinte ordem de prioridade, do mais alto para o mais baixo. Essa ordem prioriza os parâmetros especificados pela marca em relação aos especificados pelo parceiro:

<details>

<summary>Referência de tipo de parâmetro</summary>

| Tipo de parâmetro                  | Descrição                                                                                                                                                                                                                                                                       |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Página de destino do anúncio       | Os parâmetros que você configura nos metadados da página de destino do seu anúncio. (Esses parâmetros sempre têm precedência, a menos que um deep link seja fornecido com a solicitação; nesse caso, os parâmetros do deep link substituem os parâmetros da página de destino.) |
| Modelo de rastreamento do programa | Os parâmetros que você configura em **Configurações → Gateway** (encontrado na *Rastreamento* seção) → **Modelo de rastreamento do programa**.                                                                                                                                  |
| Modelo de rastreamento do parceiro | Os parâmetros que você configura em **Configurações → Gateway** (encontrado na *Rastreamento* seção) → **Modelo de rastreamento do programa**.                                                                                                                                  |
| Variável de passagem               | Os parâmetros que seus parceiros podem especificar dentro de um deep link, usando a `p.` notação. (Em casos raros, os parâmetros de passagem podem substituir os parâmetros que você especificar.)                                                                              |
| String de consulta do deep link    | Os parâmetros que seus parceiros podem usar para passar um deep link contendo parâmetros pré-definidos da string de consulta da página de destino.                                                                                                                              |

</details>

<details>

<summary>Exemplo</summary>

Se o `utm_medium` parâmetro for anexado tanto ao deep link da página de destino usado por um parceiro quanto ao seu próprio *Modelo de rastreamento do programa* como mostrado abaixo:

* *URL do Deep Link:* `https://brand.example?utm_medium=seo`
* *Modelo de Rastreamento do Programa:* `https://brand.example?utm_medium=affiliate`

  A página de destino final será:
* *Modelo de Rastreamento do Programa:* `https://brand.example?utm_medium=`**`affiliate`**

  Isso ocorre porque o *Modelo de rastreamento do programa* parâmetro foi definido por você e, portanto, recebe prioridade maior do que o definido pelo seu parceiro.

</details>


---

# 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/account-administration/program-settings/tracking-settings/gateway-tracking-templates.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.