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

# Configurar UTM template (Google Ads e Meta Ads)

> Habilite ROAS por campanha e nome legível no dashboard de Atribuição configurando ValueTrack no Google Ads e Dynamic Insertion no Meta Ads

## Por que isso importa

O dashboard de **Atribuição** da Make Talk mostra de onde vem cada conversa, lead e venda. Sem o UTM template configurado nas suas plataformas de mídia paga, você ainda vê **que** veio de Google Ads ou Meta Ads (porque capturamos `gclid`, `fbclid` e `ctwa_clid` automaticamente), mas não consegue identificar **qual campanha** trouxe cada conversa.

Na prática, sem essa configuração:

* O dashboard mostra `Google Ads · campanha não identificada` em vez do nome real da campanha
* Você consegue ver ROAS **agregado** por plataforma (gasto total Google Ads / receita total Google Ads), mas não consegue calcular ROAS **por campanha**
* Comparar performance entre campanhas vira inviável

Com o UTM template configurado (uma vez, leva uns 5 minutos), passa a funcionar:

* Nome legível da campanha no dashboard (ex: `Black Friday 2026`, `Verão Hotel Copacabana`)
* ROAS por campanha calculado automaticamente quando você conectar Google Ads API ou Meta CAPI
* Drill-down por anúncio individual (`utm_content`) e palavra-chave (`utm_term`)

<Note>
  A captura de origem na Make Talk **não depende** do UTM template — sempre conseguimos identificar a plataforma pelos click IDs (`gclid`, `fbclid`, `ctwa_clid`). O UTM template adiciona granularidade de campanha sobre essa captura de base.
</Note>

***

## Google Ads — ValueTrack

O Google Ads tem um sistema de tokens chamado [ValueTrack](https://support.google.com/google-ads/answer/2375447) que preenche automaticamente parâmetros UTM com dados reais a cada clique (ID da campanha, ID do grupo de anúncios, palavra-chave clicada, etc.).

### Template recomendado

Cole exatamente este template no Google Ads:

```
utm_source=google&utm_medium=cpc&utm_campaign={_displayname}&utm_id={campaignid}&utm_campaign_id={campaignid}&utm_adgroup_id={adgroupid}&utm_content={creative}&utm_term={keyword}
```

| Token            | O que captura                                                    |
| ---------------- | ---------------------------------------------------------------- |
| `{_displayname}` | Nome amigável da campanha (configurável por você no Google Ads)  |
| `{campaignid}`   | ID numérico da campanha — chave para cruzar com a Google Ads API |
| `{adgroupid}`    | ID do grupo de anúncios                                          |
| `{creative}`     | ID do anúncio individual                                         |
| `{keyword}`      | Palavra-chave que disparou o clique (campanhas de busca)         |

<Tip>
  O campo `utm_id={campaignid}` é o **mais importante** — é ele que permite cruzar com os dados de gasto vindos da Google Ads API e calcular ROAS por campanha.
</Tip>

### Onde colar no Google Ads

A configuração é feita uma vez na **conta inteira** (não precisa repetir por campanha):

1. Abra o **Google Ads** → menu lateral **Admin**
2. Clique em **Configurações da conta**
3. Expanda a seção **Acompanhamento**
4. No campo **Sufixo de URL final** (Final URL suffix), cole o template acima
5. Clique em **Salvar**

<Frame caption="Sufixo de URL final no Google Ads">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/maketalk-7da59a87/images/administradores/utm-template/google-step-1.png" alt="Configurações da conta no Google Ads" />
</Frame>

<Frame caption="Campo Sufixo de URL final">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/maketalk-7da59a87/images/administradores/utm-template/google-step-2.png" alt="Campo Sufixo de URL final preenchido" />
</Frame>

<Note>
  Se você já configurou parâmetros de URL em campanhas individuais, não precisa refazer — o sufixo da conta se aplica como complemento. Em caso de conflito (mesmo parâmetro definido nos dois lugares), o nível mais específico (campanha) vence.
</Note>

### Como testar

1. Abra um dos seus anúncios em uma aba anônima (sem custo extra — Google detecta clique de teste)
2. Após chegar no seu site/landing page, copie a URL completa da barra do navegador
3. Confira se a URL tem `utm_id=` com um número longo (ex: `utm_id=21234567890`)
4. Se tiver, está funcionando — em até alguns minutos as próximas conversas vindas desses anúncios já vão aparecer no dashboard com o nome real da campanha

***

## Meta Ads — Dynamic Insertion

O Meta Ads (Facebook e Instagram) usa **parâmetros dinâmicos** com sintaxe de duas chaves (`{{...}}`) para preencher UTMs em tempo de clique. [Documentação oficial da Meta](https://www.facebook.com/business/help/2360940870872492).

### Template recomendado

```
utm_source=facebook&utm_medium=cpc&utm_campaign={{campaign.name}}&utm_id={{campaign.id}}&utm_content={{ad.id}}
```

| Parâmetro           | O que captura                                                         |
| ------------------- | --------------------------------------------------------------------- |
| `{{campaign.name}}` | Nome legível da campanha                                              |
| `{{campaign.id}}`   | ID numérico da campanha — chave para cruzar com Meta CAPI             |
| `{{ad.id}}`         | ID do anúncio individual                                              |
| `{{adset.id}}`      | ID do conjunto de anúncios (opcional, adicionar se quiser drill-down) |

<Tip>
  Para anúncios que rodam no Instagram, troque `utm_source=facebook` por `utm_source=instagram` quando criar campanhas separadas por placement. Se o anúncio roda nos dois automaticamente, deixe `facebook` mesmo — o classificador da Make Talk reconhece ambos como Meta Ads.
</Tip>

### Onde colar no Meta Ads Manager

Diferente do Google, no Meta a configuração é **por anúncio** (não conta inteira):

1. Abra o **Meta Ads Manager** → seu anúncio
2. Clique em **Editar**
3. Role até a seção **Rastreamento** (geralmente no fim da página)
4. No campo **Parâmetros de URL**, cole o template
5. Clique em **Publicar**

<Frame caption="Campo Parâmetros de URL no anúncio Meta">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/maketalk-7da59a87/images/administradores/utm-template/meta-step-1.png" alt="Parâmetros de URL no Meta Ads Manager" />
</Frame>

<Frame caption="Template colado no campo">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/maketalk-7da59a87/images/administradores/utm-template/meta-step-2.png" alt="Template Dynamic Insertion preenchido" />
</Frame>

<Warning>
  Como a configuração é por anúncio, **lembre de aplicar em cada anúncio novo** que criar. Uma alternativa é duplicar um anúncio já configurado — os parâmetros de URL são duplicados junto.
</Warning>

### Como testar

1. No Ads Manager, abra o anúncio → **Pré-visualizar**
2. Use a opção **Compartilhar pré-visualização** → **Link**
3. Abra o link, clique no botão de CTA do anúncio
4. Na URL final, confira se aparecem os UTMs preenchidos com valores reais (não com `{{campaign.id}}` literal)

***

## Validar que está funcionando na Make Talk

Depois de configurar e dar uns minutos pro tráfego rodar:

1. Abra o **CRM** → escolha um deal recente vindo de Google Ads ou Meta Ads
2. Na lateral, expanda **Atributos personalizados**
3. Confira que aparecem `utm_source`, `utm_campaign`, `utm_id` preenchidos com valores reais
4. Vá pro **Dashboard de Atribuição** → na tabela por origem/campanha, as conversas vindas dos seus anúncios já aparecem com o nome da campanha (não mais como "campanha não identificada")

<Note>
  Se você acabou de configurar e o dashboard ainda mostra "campanha não identificada", normal — só conversas **novas** (depois da configuração) vão aparecer com nome de campanha. Conversas antigas continuam como estavam.
</Note>

***

## Limitações conhecidas

### ROAS por campanha sem ValueTrack é impossível

Mesmo com a Google Ads API conectada, **não conseguimos calcular ROAS por campanha** se o ValueTrack não estiver configurado. Motivo técnico:

* O snapshot de gasto vem da Google Ads API com `campaign_id`
* Mas o deal/conversa só tem `gclid` solto (sem `campaign_id`)
* Cruzar `gclid` → `campaign_id` retroativamente exigiria consultas adicionais ao Google com janela limitada (90 dias) e cota apertada — não é viável manter

**Resultado:** ROAS **agregado por plataforma** (Google Ads total) funciona normalmente. ROAS **por campanha** depende do ValueTrack pré-configurado.

### Click to WhatsApp (CTWA) do Meta não usa UTM template

Anúncios CTWA (Click to WhatsApp) abrem direto o WhatsApp — não passam por landing page onde a gente leria UTMs. Para esses, o Meta envia um identificador chamado `ctwa_clid` direto no webhook do WhatsApp, e a Make Talk usa isso pra identificar a campanha de origem automaticamente. Você não precisa configurar nada extra para CTWA.

### Outras plataformas (LinkedIn, TikTok, Bing)

LinkedIn Ads, TikTok Ads e outras plataformas pagas hoje são classificadas como `:other_paid` no dashboard da Make Talk — ainda não temos drill-down por campanha para essas redes. Mesmo assim, vale configurar UTMs nelas (`utm_source=linkedin&utm_medium=cpc&utm_campaign=...`) para o nome aparecer corretamente no dashboard.

***

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Já tenho UTM configurado no Google Ads há tempos. Preciso refazer?">
    Não necessariamente. Confira que a sua configuração atual contém pelo menos `utm_id={campaignid}` — esse é o campo que viabiliza ROAS por campanha. Se não tiver, complemente o template existente.
  </Accordion>

  <Accordion title="Uso Google Ads, Meta Ads e LinkedIn. Configuro tudo igual?">
    Não — cada plataforma tem sintaxe própria. Google usa `{token}` (chaves simples), Meta usa `{{token}}` (chaves duplas). LinkedIn não tem injeção dinâmica equivalente a esses; você precisa criar UTMs estáticos manualmente por campanha (`utm_source=linkedin&utm_medium=cpc&utm_campaign=nome-fixo`).
  </Accordion>

  <Accordion title="Funciona em campanhas de remarketing/retargeting?">
    Sim. Tanto ValueTrack do Google quanto Dynamic Insertion do Meta preenchem em qualquer tipo de campanha — busca, display, vídeo, remarketing, shopping, todas.
  </Accordion>

  <Accordion title="Os UTMs aparecem no WhatsApp do cliente?">
    Não. A Make Talk captura a atribuição **antes** do clique abrir o WhatsApp (através do formulário no seu site, do widget de chat, ou do `ctwa_clid` no caso de CTWA). O cliente não vê parâmetros UTM em lugar nenhum — eles ficam só no metadado da conversa/deal no CRM.
  </Accordion>

  <Accordion title="Preciso configurar isso por cliente diferente da minha agência?">
    Sim. Cada conta de Google Ads e cada Business Manager Meta é independente — a configuração precisa ser repetida para cada cliente que você gerencia. Como é uma configuração única por conta, na prática são 5 minutos por cliente novo.
  </Accordion>

  <Accordion title="E se a URL final do meu anúncio já tem outros parâmetros (?source=email&id=123)?">
    O Google Ads concatena automaticamente: ele adiciona o sufixo da conta com `&` apropriado, sem sobrescrever os que já estão. No Meta, o campo "Parâmetros de URL" também adiciona ao final sem conflitar com a URL base.
  </Accordion>
</AccordionGroup>

***

## Próximos passos

<CardGroup cols={2}>
  <Card title="Política de atribuição" icon="bullseye" href="/administradores/politica-atribuicao">
    Entenda como a Make Talk classifica origens de conversa e calcula ROAS.
  </Card>

  <Card title="Integrações avançadas" icon="plug" href="/administradores/integracoes-avancadas-remarketing">
    Conecte CRM, ERP e plataformas de marketing para campanhas automatizadas.
  </Card>

  <Card title="Visão geral de relatórios" icon="chart-line" href="/relatorios/visao-geral">
    Veja todos os dashboards disponíveis na plataforma.
  </Card>

  <Card title="Cobrança WhatsApp API" icon="dollar-sign" href="/administradores/cobranca-whatsapp-api">
    Entenda os custos de mensagens via WhatsApp API.
  </Card>
</CardGroup>