**UTM (Urchin Tracking Module)** é um padrão consagrado de marketing digital para classificar origens de tráfego. O MEDSAC usa os 5 campos padrão:

| Campo          | Para que serve                               | Exemplo                                          |
| -------------- | -------------------------------------------- | ------------------------------------------------ |
| `utm_source`   | **De onde** veio o tráfego (plataforma/site) | `google`, `instagram`, `facebook`, `tv`, `qr`    |
| `utm_medium`   | **Como** veio (tipo de mídia)                | `cpc`, `social`, `email`, `offline`, `bio`       |
| `utm_campaign` | **Qual campanha** específica                 | `checkup-maio`, `dia-das-maes`, `volta-as-aulas` |
| `utm_content`  | **Qual variação** (A/B testing)              | `imagem-1`, `video-curto`, `texto-direto`        |
| `utm_term`     | **Qual palavra-chave** (Google Ads)          | `laboratorio-perto`, `exame-sangue`              |

## Onde definir

### Opção 1: Padrões da campanha (recomendado)

Ao criar a campanha no MEDSAC, preencha os 5 campos UTM. Eles serão **gravados automaticamente em todos os cliques** desse link.

**Vantagem:** simples. Você divulga só `https://app.medsac.com.br/r/MSAC-...` e o MEDSAC cuida do resto.

### Opção 2: UTMs na URL (override)

Você pode passar UTMs na URL pública para sobrescrever os defaults:

```
https://app.medsac.com.br/r/MSAC-Zaryd4...?utm_source=facebook&utm_campaign=teste-b
```

**Quando usar:** quando uma mesma campanha é divulgada em vários canais e você quer separar resultados sem criar várias campanhas.

Regra: **se vier na URL, ganha do default**. Se não vier, usa o default da campanha.

## Boas práticas

* Use **minúsculas e kebab-case** consistente: `checkup-maio`, não `Checkup_Maio`.

* **Padronize entre clientes** — alinhe com sua equipe de marketing para que `instagram` sempre seja `instagram` (e não às vezes `insta`, às vezes `ig`).

* **utm_campaign deve ser específico**: `checkup-maio-2026` é melhor que `checkup` (que confunde de um ano pro outro).

* Não coloque dados pessoais nos UTMs — eles ficam visíveis em logs e relatórios.

## Como os UTMs aparecem na conversa

O card MEDSAC mostra:

```
MEDSAC                    Lead via link rastreável
CAMPANHA
checkup-maio
Origem: instagram         Meio: cpc
```

Se você não preencher os UTMs, o card mostra só o que tiver (ex: só "Origem: instagram" se o medium estiver vazio).

## Google Ads e Meta tracking

Além dos UTMs padrão, o MEDSAC captura automaticamente:

* `gclid` (Google Click ID) — quando o paciente vem de um anúncio do Google.

* `fbclid` (Facebook Click ID) — quando vem do Meta.

Esses IDs **não aparecem no card** (privacidade), mas ficam disponíveis nos relatórios como contagens e chips ("Google Ads", "Meta/Facebook").