> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metrito.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parâmetros e UTMs

> Configure os parâmetros de URL dos seus anúncios para atribuir cada conversão à campanha certa.

## Por que os UTMs importam

Os parâmetros UTM são o que diz ao Metrito **qual campanha, conjunto e anúncio** trouxe cada visitante. Sem eles, o tráfego é registrado, mas o Metrito não consegue ligar a conversão ao anúncio — e a tela de [Campanhas](/analise/campanhas) fica sem dados de resultado.

O Metrito usa o formato **`nome|id`**: cada parâmetro carrega o nome legível (para os relatórios) **e** o ID técnico (para conciliar com a plataforma) de uma vez só.

## A tela Parâmetros/UTM

Na seção **Parâmetros/UTM** do tracking há um card do **Meta Ads** que já monta a string de UTM pronta para você. Clique em **Copiar template** (ou clique na própria string) e cole nos parâmetros de URL dos seus anúncios.

A string gerada segue este padrão:

```
utm_source=facebook&utm_campaign={{campaign.name}}|{{campaign.id}}&utm_medium={{adset.name}}|{{adset.id}}&utm_content={{ad.name}}|{{ad.id}}&utm_term={{placement}}
```

Cada parâmetro tem um papel:

| Parâmetro      | Papel          | Valor dinâmico                       |
| -------------- | -------------- | ------------------------------------ |
| `utm_source`   | Fonte          | `facebook` (fixo)                    |
| `utm_campaign` | Campanha       | `{{campaign.name}}\|{{campaign.id}}` |
| `utm_medium`   | Conjunto       | `{{adset.name}}\|{{adset.id}}`       |
| `utm_content`  | Anúncio        | `{{ad.name}}\|{{ad.id}}`             |
| `utm_term`     | Posicionamento | `{{placement}}`                      |
| `fbclid`       | Click ID       | capturado automaticamente da URL     |

## Como configurar no Meta Ads

<Steps>
  <Step title="Copie o template no Metrito">
    Na seção **Parâmetros/UTM**, clique em **Copiar template** no card do Meta Ads.
  </Step>

  <Step title="Abra o Gerenciador de Anúncios">
    Acesse o [Gerenciador de Anúncios](https://adsmanager.facebook.com), selecione a campanha e clique em **Editar**.
  </Step>

  <Step title="Cole nos Parâmetros de URL">
    Role até a seção **Rastreamento** e cole o template no campo **Parâmetros de URL**.
  </Step>

  <Step title="Publique">
    Clique em **Publicar**. Todos os anúncios passam a incluir os parâmetros automaticamente.
  </Step>
</Steps>

<Tip>
  Configure no **nível da campanha** para que todos os conjuntos e anúncios herdem os parâmetros. A Meta substitui os `{{placeholders}}` pelos valores reais no momento do clique.
</Tip>

### O que o Metrito extrai

De uma URL como:

```
https://seusite.com.br/produtos?utm_source=facebook&utm_campaign=Promoção Verão|123456789&utm_medium=Mobile iOS|987654321&utm_content=Vídeo 50%25 Off|456789123&utm_term=feed&fbclid=IwAR1a2b3c
```

O Metrito interpreta e guarda:

| Campo          | Valor                             |
| -------------- | --------------------------------- |
| Fonte          | `facebook`                        |
| Campanha       | `Promoção Verão` · ID `123456789` |
| Conjunto       | `Mobile iOS` · ID `987654321`     |
| Anúncio        | `Vídeo 50% Off` · ID `456789123`  |
| Posicionamento | `feed`                            |

## Outras plataformas

Embora a tela traga o template do Meta pronto, você pode aplicar o mesmo padrão `nome|id` em outras fontes.

<AccordionGroup>
  <Accordion title="Google Ads">
    Use um **modelo de acompanhamento** no nível da campanha (Configurações → Opções de URL da campanha):

    ```
    {lpurl}?utm_source=google&utm_campaign={campaignname}|{campaignid}&utm_medium={adgroupname}|{adgroupid}&utm_content={creative}&utm_term={keyword}&gclid={gclid}
    ```
  </Accordion>

  <Accordion title="TikTok Ads">
    Em **Rastreamento → Parâmetros de URL**, use:

    ```
    utm_source=tiktok&utm_campaign={{campaign.name}}|{{campaign_id}}&utm_medium={{adgroup.name}}|{{adgroup_id}}&utm_content={{ad.name}}|{{ad_id}}&ttclid={{ttclid}}
    ```
  </Accordion>
</AccordionGroup>

## Boas práticas

1. **Configure no nível da campanha** — vale para todos os anúncios de uma vez.
2. **Mantenha o padrão `nome|id`** — garante nomes legíveis e IDs técnicos.
3. **Teste antes de escalar** — rode uma campanha pequena e confira a atribuição na tela de Campanhas.
4. **Não troque o padrão no meio do caminho** — pode quebrar a atribuição histórica.
5. **Use nomes limpos e consistentes** — relatórios melhores começam em nomes bons.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Pixels" icon="square-code" href="/tracking/pixels">
    Conecte seus pixels da Meta para receber as conversões.
  </Card>

  <Card title="Campanhas" icon="rectangle-ad" href="/analise/campanhas">
    Veja o desempenho dos anúncios cruzado com os resultados.
  </Card>
</CardGroup>