# Modelos de rastreamento do gateway

{% hint style="warning" %}
**Importante:** Consulte [Configurar as Configurações de Rastreamento do Gateway](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/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 de 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 de string de consulta* abaixo para obter ajuda.

  <div data-with-frame="true"><figure><img src="/files/56ea114628dc7073a0dda5533d9cc308aaf23378" alt=""><figcaption></figcaption></figure></div>

#### Modelo de Rastreamento de Parceiros

* É aqui que você pode adicionar parâmetros globais de string de consulta aos links de rastreamento de parceiros. Se um clique vier de um link de rastreamento de 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 de Campanha com o Google Analytics](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/set-up-tracking/collect-campaign-data-with-google-analytics.md) usando parâmetros UTM. Consulte a *referência de parâmetros de string de consulta* abaixo para obter ajuda.

  <div data-with-frame="true"><figure><img src="/files/56409289052b4512746e3b28aa37e3a7eb089375" alt=""><figcaption></figcaption></figure></div>

#### parâmetros de 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 codificados são suportados — basta adicionar um valor sem chaves ({}), e ele sempre será passado em um clique.
* Valores personalizados são suportados, no entanto, recomendamos [entrar em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true) para discutir como usá-los.
* Use sublinhados para adicionar vários parâmetros dentro de uma única string de consulta.

<details>

<summary>referência de parâmetros de 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 pela impact.com associado ao evento de clique. Quando um link de rastreamento é clicado, isso será preenchido com o ID de clique exclusivo associado ao cliente.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `{iradid}`                                  | 828416                                   | <p><strong>ID do Anúncio da impact.com</strong></p><p>ID exclusivo associado ao anúncio ligado 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 da impact.com</strong></p><p>ID exclusivo associado ao seu programa (campanha) na 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 da 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 da impact.com</strong></p><p>O nome que você atribuiu ao anúncio que foi 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 da impact.com</strong></p><p>Quando você cria anúncios na impact.com, define o tipo do anúncio (por exemplo, banner, texto, imagem) antes de enviar a peça criativa. Quando um link de rastreamento é clicado, isso será preenchido com o tipo de anúncio.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `{iradsize}`                                | 100x100                                  | <p><strong>Tamanho do Anúncio da impact.com</strong></p><p>A 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 da impact.com</strong></p><p>O nome do parceiro na 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 das suas análises 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 da 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 acrescentar um valor de ID Compartilhado como parâmetro de string de consulta aos seus próprios links de rastreamento, que então 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 especificou, se disponível.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `{mp_value1}`, `{mp_value2}`, `{mp_value3}` | Deal                                     | <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 a um único Programa/Campanha</strong>.</p><p>Valores personalizados podem ser atribuídos a parceiros em <strong>Parceiros → Parceiros → Ações → Rastreamento</strong>. A partir daqui, 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 fazer upload 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á anexado como um parâmetro de string de consulta. Isso pode ser usado como um cache-buster 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>Acrescente este parâmetro quando você testar seus links de rastreamento.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `{irmpgroupname}`                           | ”influenciadores”,”preferidos”           | <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 de string de consulta dinâmico personalizado. A impact.com recomenda entrar em contato com o suporte (ou com seu CSM) para discutir seu caso de uso específico.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

</details>

#### Deduplicação de parâmetros explicada

Os vários parâmetros especificados para um anúncio em um programa às vezes podem resultar no retorno de valores duplicados, especialmente quando vários parâmetros têm o mesmo nome. Valores duplicados de parâmetros podem criar discrepâncias entre os relatórios da impact.com e os relatórios das ferramentas da sua equipe de marketing mais ampla, como o Google Analytics. Para evitar isso, a impact.com considera apenas um único valor de parâmetro na seguinte ordem de prioridade (da mais alta para a mais baixa).

Essa ordem prioriza os parâmetros especificados pela marca em relação aos especificados pelo parceiro:

<details>

<summary>Referência de tipos de parâmetros</summary>

| Tipo de parâmetro                  | Descrição                                                                                                                                                                                                                                                             |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Página de destino do anúncio       | Os parâmetros que você configura nos metadados da landing page 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 landing page.) |
| Modelo de rastreamento do programa | Os parâmetros que você configura em **Configurações → Gateway** (encontrado na seção *Rastreamento* ) → **Modelo de Rastreamento do Programa**.                                                                                                                       |
| Gateway do parceiro                | Os parâmetros que você configura em **Configurações → Gateway** (encontrado na seção *Rastreamento* ) → **Modelo de Rastreamento do Programa**.                                                                                                                       |
| Variável passthrough               | Os parâmetros que seus parceiros podem especificar dentro de um deep link, usando a `p.` notação. (Em casos raros, os parâmetros passthrough 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 de string de consulta predefinidos da landing page.                                                                                                                          |

</details>

<details>

<summary>Exemplo</summary>

Se o `utm_medium` o parâmetro é anexado tanto ao deep link da landing page usado por um parceiro quanto ao seu próprio *Modelo de Rastreamento do Programa* conforme mostrado abaixo:

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

  A landing page 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: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/account-administration/program-settings/tracking-settings/gateway-tracking-templates.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
