> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ezmob.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Tokens e parâmetros de rastreamento: guia completo

Macros de rastreamento são marcadores entre chaves, como `{country}`, que a EZmob substitui por valores reais quando alguém clica no seu anúncio. Adicione-as à **URL de Destino** de um criativo para que seu tracker ou sua landing page saibam de onde veio cada clique.

## Adicionar uma macro

1. Nos criativos da campanha, clique no botão de macros ao lado do campo **URL de Destino** (dica: **Inserir macro de rastreamento**).
2. Em **Macros de rastreamento**, clique em uma macro para inseri-la na posição do cursor. Clique novamente em uma macro inserida para removê-la.
3. Dê um nome de parâmetro a cada macro, por exemplo `https://yoursite.com/landing?country={country}&device={device_type}`.

Você pode encadear macros em um único valor: `?source={pubfeed}_{subid}`.

## Macros disponíveis

| Macro | Substituída por |
|---|---|
| `{conversion}` | ID do clique, obrigatório para o rastreamento de conversões |
| `{campaign}` / `{offer}` / `{banner}` | ID da campanha / ID da oferta / ID do anúncio |
| `{bid}` | Custo do clique (CPC, XML) ou custo por visualização (CPV, Display) |
| `{keyword}` | Palavra-chave correspondente |
| `{subid}` / `{original_subid}` / `{source_subid}` | SubID do feed do publisher / SubID sem limitação / SubID da fonte |
| `{source}` | Fonte de tráfego: `{pubfeed}.{original_subid}` (XML) ou ID do site/app (Display) |
| `{publisher}` / `{pubfeed}` / `{pubpoint}` / `{pubzone}` / `{remfeed}` | IDs do publisher, do feed, do ponto, da zona e do feed remoto |
| `{site_id}` / `{app_id}` / `{app_bundle}` | ID do site do publisher / ID do app / bundle do app |
| `{request_id}` / `{timestamp}` | ID da solicitação / timestamp Unix |
| `{country}` / `{state}` / `{city}` / `{zip}` | País (duas letras) / região / cidade / código postal |
| `{ip}` / `{carrier}` | IP do usuário / provedor |
| `{device_type}` / `{device_brand}` / `{device_model}` / `{ifa}` | Tipo de dispositivo / marca / modelo / ID de publicidade |
| `{os}` / `{os_type}` / `{browser}` / `{user_agent}` | Sistema operacional / sistema operacional sem versão / navegador / user agent |
| `{query}` / `{referrer}` / `{referrer_domain}` | Palavra-chave do publisher / URL de referência / domínio de referência |
| `{search_ip}` / `{search_referrer_domain}` | IP do usuário da busca / domínio de referência da busca |
| `{ga}` | Usada para o Google Analytics |

`{pixel}` é aceita como `{conversion}`, e `{pubid}` como `{subid}`.

## Regras da URL

- Comece com `http://` ou `https://` e use um domínio público. `localhost` e IPs privados são rejeitados.
- Sem espaços; codifique-os como `%20`.
- As macros diferenciam maiúsculas de minúsculas: `{country}` funciona, `{Country}` não. Qualquer macro fora da lista acima, como `{click_id}`, é rejeitada.
- Feche todas as chaves e não deixe um `{}` vazio nem um parâmetro sem nome.

Se uma URL não passar na validação, o erro aparece abaixo do campo. Para espaços, `https://` ausente, `{}` vazio ou macros não suportadas, é oferecida uma correção com um clique.

## Google Analytics

Adicione seus próprios parâmetros UTM à URL de destino, por exemplo `?utm_source=ezmob&utm_campaign={campaign}&utm_content={banner}`.

## Capturas de tela

![Página de rastreamento de conversões com a sua URL de postback](https://zjcgneywpnkgamzggapu.supabase.co/storage/v1/object/public/helpdesk-media/adv/ee6d5611-1.png)

![Criativo da campanha, campo URL de Destino passando clickid={conversion}](https://zjcgneywpnkgamzggapu.supabase.co/storage/v1/object/public/helpdesk-media/adv/e7b5d1e9-1.png)

*As capturas mostram a interface em inglês. Você pode mudar o idioma do painel para português.*

## Artigos relacionados

- [Como rastrear conversões com o postback da EZmob](https://helpdesk.ezmob.com/pt/article/how-to-track-conversions-with-ezmobs-postback-19ift7a/)
- [Como rastrear conversões com o pixel da EZmob](https://helpdesk.ezmob.com/pt/article/track-conversions-with-ezmob-pixel-vw6ias/)
- [Criação de campanhas: o guia completo](https://helpdesk.ezmob.com/pt/article/campaign-creation-the-complete-guide-leb193/)
- [Solução de problemas de rastreamento de conversões](https://helpdesk.ezmob.com/pt/article/troubleshooting-conversion-tracking-issues-vnaeqt/)