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

# Adicionar UTMs ao Payment Link

> Monte URLs rastreadas para anúncios, e-mails, mensagens e QR codes sem criar um novo Payment Link para cada campanha.

Coloque as UTMs **na URL do Payment Link que será distribuída**. O mesmo link
pode receber parâmetros diferentes em cada campanha, sem duplicar a oferta no
Dashboard.

```text theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=meta&utm_medium=paid_social&utm_campaign=lancamento&utm_content=video_a
```

Quando o comprador abre essa URL, a Chargefy:

1. lê os parâmetros da campanha;
2. cria uma Checkout Session exclusiva;
3. grava a atribuição nessa sessão;
4. redireciona o comprador para o checkout.

As UTMs podem desaparecer da barra de endereço depois do redirecionamento. Isso
é esperado: a campanha já ficou registrada na sessão.

## Parâmetros mínimos recomendados

| Parâmetro      | O que responde                               | Exemplo                            |
| -------------- | -------------------------------------------- | ---------------------------------- |
| `utm_source`   | De onde veio o tráfego                       | `meta`, `newsletter`, `affiliate`  |
| `utm_medium`   | Qual foi o tipo de distribuição              | `paid_social`, `email`, `referral` |
| `utm_campaign` | Qual iniciativa gerou o clique               | `lancamento`, `black_friday`       |
| `utm_content`  | Qual anúncio ou variação venceu              | `video_a`, `headline_2`            |
| `utm_term`     | Palavra-chave ou segmentação, quando existir | `gestores_financeiros`             |

Use pelo menos `utm_source`, `utm_medium` e `utm_campaign`. Acrescente
`utm_content` quando houver mais de um criativo dentro da mesma campanha.

<Tip>
  Escolha uma taxonomia e mantenha-a. `paid_social`, `paid-social` e
  `social_paid` aparecem como mídias diferentes no relatório.
</Tip>

## Um Payment Link, várias campanhas

Você não precisa criar um Payment Link para cada canal. Use a mesma URL-base e
mude apenas os parâmetros:

```text Campanha de anúncios theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=meta&utm_medium=paid_social&utm_campaign=lancamento
```

```text E-mail theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=newsletter&utm_medium=email&utm_campaign=lancamento
```

```text Parceiro theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=parceiro_a&utm_medium=referral&utm_campaign=lancamento
```

Itens, valor e regras continuam vindo do mesmo Payment Link. Somente a origem
daquela visita muda.

## Anúncios da Meta

Configure suas UTMs no campo de parâmetros da URL do anúncio. A Meta normalmente
acrescenta o `fbclid` quando a pessoa clica; não crie esse valor manualmente.

Uma URL pode receber UTMs e `fbclid` ao mesmo tempo. As UTMs dão nomes legíveis
à campanha dentro da Chargefy. O `fbclid` ajuda a relacionar a conversão ao
clique na Meta.

## QR codes e materiais impressos

O QR code copiado do Dashboard usa a URL-base do Payment Link. Para medir um
material específico, gere o QR code a partir da URL já decorada:

```text theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=evento&utm_medium=qr_code&utm_campaign=feira_agosto&utm_content=totem_entrada
```

Crie uma URL diferente para cada material que precise ser comparado: palco,
mesa, panfleto ou parceiro. Todos continuam apontando para a mesma oferta.

## Combinar com parâmetros do checkout

As UTMs podem coexistir com parâmetros de pré-preenchimento, idioma e referência
do pedido. Use `&` depois do primeiro parâmetro:

```text theme={"theme":"css-variables"}
https://pay.chargefy.io/link/seu_link?utm_source=whatsapp&utm_medium=message&utm_campaign=recuperacao&locale=pt-BR&client_reference_id=pedido-8472
```

Cada grupo tem uma função:

* `utm_*` descreve a campanha;
* `client_reference_id` relaciona a sessão ao seu pedido;
* `locale` escolhe o idioma;
* `prefilled_*` antecipa dados permitidos no formulário.

## Regras para uma URL segura

* codifique espaços e caracteres especiais ao montar a URL;
* não coloque e-mail, telefone, CPF, token ou segredo em UTMs;
* não use UTMs para transportar dados internos do comprador;
* confira se a URL final continua começando por
  `https://pay.chargefy.io/link/`;
* teste a URL em uma janela anônima antes de publicar a campanha.

<Warning>
  Tudo que fica na query string pode aparecer no navegador, no histórico e em
  ferramentas externas. UTMs devem descrever a campanha, nunca a pessoa.
</Warning>

## Quando existe uma landing page antes

Se o anúncio leva primeiro ao seu site, não basta deixar uma URL-base no botão
de compra. Preserve os parâmetros recebidos com
[Chargefy.js](/payments/configure-landing-page).