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

# Configuração de UTMs

> Padrão de rastreamento da Nemu coexistindo com as UTMs já utilizadas no GA4 (Meta, Google e TikTok)

## Contexto

Na integração via Bucket, os campos padrão de UTM (`utm_source`, `utm_medium`, `utm_campaign`, `utm_content`) geralmente **já estão em uso pelo GA4 do cliente e não devem ser alterados**. O único campo livre para a atribuição da Nemu é o **`utm_term`**.

Por isso, todos os dados de atribuição (origem, campanha, conjunto e criativo) são **empacotados dentro de um único `utm_term`**, que o GA4 do cliente captura e repassa para a Nemu.

## Como funciona a configuração

Cada canal (Meta, Google, TikTok) envia o `utm_term` empacotado na URL de destino. Todos os dados de atribuição da Nemu (origem, campanha, conjunto e criativo) ficam concatenados nesse único campo, que o GA4 do cliente captura e devolve para a Nemu, que então desempacota e reconstrói cada informação.

<Info>
  Os campos `utm_source`, `utm_medium`, `utm_campaign` e `utm_content`
  continuam como estão hoje, sem alteração. São de uso do GA4 do cliente e não
  devem ser tocados.
</Info>

## Onde configurar

Toda essa configuração é feita **dentro do gerenciador de anúncios de cada plataforma**, no campo de parâmetros de URL / acompanhamento. Não há alteração no site ou no checkout do cliente: os parâmetros são anexados à URL de destino pela própria plataforma de anúncios.

| Plataforma | Caminho no gerenciador de anúncios |
| - | - |
| **Meta** | Campanhas → aba **Anúncios** → selecionar os anúncios → **Editar** → no final da página, campo **"Parâmetros de URL"** → colar a configuração → **Publicar**. |
| **Google** | **Configurações** → **Configurações da conta** → habilitar **Codificação automática** → **Acompanhamento** (modelo de acompanhamento) → colar a configuração → **Salvar**. |
| **TikTok** | Campanhas → **Anúncios** → editar o anúncio → desabilitar **"Adicionar parâmetros de URL automaticamente"** → **Editar Parâmetros da URL** → em **Parâmetros personalizados**, adicionar cada par → **Aplicar**. |

## Parâmetros por plataforma

Em cada plataforma, cole o parâmetro `utm_term` correspondente:

### Meta

```text Meta: wrap theme={null}
utm_term=source~facebook~~campaign~{{campaign.name}}|{{campaign.id}}~~adset~{{adset.name}}|{{adset.id}}~~content~{{ad.name}}|{{ad.id}}
```

### Google

```text Google: wrap theme={null}
utm_term=source~google~~campaign~{campaignid}~~adset~{adgroupid}_{assetgroupid}~~content~{creative}~~term~{keyword}
```

### TikTok

```text TikTok: wrap theme={null}
utm_term=source~tiktok~~campaign~__CAMPAIGN_NAME__%7C__CAMPAIGN_ID__~~adset~__AID_NAME__%7C__AID__~~content~__CID_NAME__%7C__CID__
```

## Mapa dos campos (referência)

| Campo Nemu | Meta | Google | TikTok |
| - | - | - | - |
| `source` | `facebook` | `google` | `tiktok` |
| `campaign` | `{{campaign.name}}\|{{campaign.id}}` | `{campaignid}` | `__CAMPAIGN_NAME__%7C__CAMPAIGN_ID__` |
| `adset` | `{{adset.name}}\|{{adset.id}}` | `{adgroupid}_{assetgroupid}` | `__AID_NAME__%7C__AID__` |
| `content` | `{{ad.name}}\|{{ad.id}}` | `{creative}` | `__CID_NAME__%7C__CID__` |
| `term` | - | `{keyword}` | - |

## Pontos de atenção na implementação

<Warning>
  **Um único campo.** Toda a atribuição da Nemu vai concatenada no `utm_term`.
  É esse campo que o GA4 captura e repassa para a Nemu, então ele precisa estar
  preenchido em **todas as URLs de destino**.
</Warning>

<Warning>
  **Não alterar os demais UTMs.** `utm_source`, `utm_medium`, `utm_campaign` e
  `utm_content` permanecem como já estão configurados no GA4 do cliente.
</Warning>