# Marketing: como ligar o site aos seus leads (rastreamento, links e UTM)

Este guia mostra como fazer o **Dashboard › Marketing** enxergar de onde vêm os seus leads: instalar o rastreamento, ligar o site aos contatos e padronizar as UTMs dos anúncios. Sem o passo 2, o site manda visitas mas o Dashboard nunca sabe qual visitante virou lead.

## 1. Instale o código de rastreamento

1. Vá em **Configurações › Marketing › Geral**.
2. Copie o **Código de rastreamento** e cole antes do `</body>` em **todas** as páginas do site e das landing pages.
3. Em **Domínios permitidos**, informe os domínios do seu site (ex.: `meusite.com.br, landing.meusite.com.br`).
4. Volte à tela: o status muda para **Tracking ativo** assim que a primeira visita chegar.

> O código captura automaticamente páginas vistas, sessões, `utm_*` e os identificadores de clique de anúncios (Google `gclid`, Meta `fbclid`, Microsoft `msclkid`, TikTok `ttclid`, X `twclid`).

## 2. Ligue o site aos seus leads

O rastreamento sozinho só conhece **visitantes anônimos**. Para o Dashboard saber qual visitante virou contato, use pelo menos um dos caminhos abaixo.

### 2.1 Botões de WhatsApp → links rastreados (recomendado)

1. **Configurações › Marketing › Links e UTM** → escolha **Link de WhatsApp**, informe o número, a mensagem inicial e as UTMs.
2. Clique em **Criar link rastreado** e copie a **URL curta** (`https://seu-dominio/l/abc123`).
3. No site, troque o `https://wa.me/...` dos botões por essa URL curta.

Quando alguém clica, o SimplesDesk registra o clique, carimba o visitante e leva a pessoa ao WhatsApp com um código na mensagem. Na primeira mensagem, o contato é ligado ao clique: a jornada inteira (páginas vistas, campanha, score) entra no lead e a **origem** é gravada automaticamente.

### 2.2 Formulários → `sd.identify`

No envio de qualquer formulário (contato, orçamento, newsletter), chame `sd.identify` com e-mail e/ou telefone:

```html
<script>
document.querySelector('#form-contato').addEventListener('submit', function (e) {
  var f = e.target;
  sd.identify({
    name: f.nome.value,
    email: f.email.value,
    phone: f.telefone.value // com DDD, ex.: 11999999999
  });
});
</script>
```

O contato é criado (ou encontrado) no CRM, recebe a origem da campanha que trouxe o visitante e o score acumulado no site.

### 2.3 Páginas de destino → links de URL

Para anúncios que levam a uma página do site, crie um **Link de URL** em Links e UTM. A URL curta redireciona para o destino já com as UTMs e um identificador de clique; se a pessoa preencher um formulário ou clicar num botão de WhatsApp depois, tudo fica ligado ao mesmo lead.

### 2.4 Anúncios de clique para WhatsApp (Meta)

Conversas iniciadas por anúncios da Meta chegam com o identificador do anúncio. A origem **Meta Ads** é gravada sozinha, o lead recebe a etiqueta `meta-ads` e as conversões voltam para a Meta pela CAPI (Configurações › Marketing › Geral › Conversões).

## 3. Padronize as UTMs dos anúncios

Use o **construtor** em Links e UTM para todas as URLs de anúncio. O catálogo guarda os valores já usados (`utm_source`, `utm_medium`, `utm_campaign`) para que "Facebook", "facebook" e "fb" não virem três origens diferentes.

| Parâmetro | Exemplos |
| --- | --- |
| `utm_source` | `google`, `facebook`, `instagram`, `tiktok`, `newsletter` |
| `utm_medium` | `cpc`, `paid_social`, `email`, `organic`, `referral` |
| `utm_campaign` | `black_friday_2026`, `institucional_q4` |

## 4. Confira no Dashboard

- **Dashboard › Marketing › Visão geral**: leads criados no período, identificados no site, sessões e funil.
- **Origens**: leads por origem, canal, forma de atribuição e faixa de score, com oportunidades, vendas e receita.
- **Campanhas**: tráfego por campanha/origem/meio com leads, vendas, receita e ROAS.
- Os avisos no topo (**diagnósticos**) dizem o que falta: rastreamento parado, leads sem origem, cliques pagos sem campanha, site sem identificação.

## Perguntas frequentes

**Por que "Identificados no site" está em zero?** O site envia visitas, mas nenhum formulário chama `sd.identify` e os botões de WhatsApp não usam links rastreados. Aplique o passo 2.

**Meus contatos antigos estão sem origem.** Em **Configurações › Marketing › Origem do Lead**, use **Preencher origem por canal**: contatos sem origem recebem a origem padrão do canal da primeira conversa (WhatsApp, Instagram, Site...).

**O visitante recusou cookies.** O SDK respeita o consentimento: sem consentimento não carimba links nem identifica.