> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/marketing-e-atribuicao/google-campaigns/google-utm-tracking.md).

# Como configurar a atribuição do Google Ads (UTMs)

Para a Patagon AI atribuir suas campanhas do Google **Landing → WhatsApp**, duas coisas precisam chegar à sua landing page em cada clique no anúncio: o **`gclid`** (o click ID do Google) e seus **parâmetros UTM**. O script da Patagon AI na página captura os dois.

A Patagon AI ordena os dados de atribuição pela hierarquia de UTMs: `utm_source` → `utm_medium` → `utm_campaign` → `utm_content` → `utm_term`.

## 1. Ative o auto-tagging (captura o `gclid`)

O auto-tagging é o que faz o Google adicionar o `gclid` a cada clique no anúncio. É necessário para a Patagon AI conseguir capturá-lo.

1. Vá em **Admin → Account settings**.
2. Abra o contêiner de **Auto-tagging**.
3. Ative **"Tag the URL that people click through from my ad"** e clique em **Save**.

![Ativar o auto-tagging em Account settings](/files/i25XVCWc1LFDVImB57SU)

{% hint style="info" %}
Capturar o `gclid` importa hoje para a atribuição, e também é o que vai permitir que a Patagon AI envie conversões de leads qualificados de volta para o Google quando as conversões offline do Google estiverem disponíveis.
{% endhint %}

## 2. Adicione seus parâmetros UTM com um final URL suffix

Os UTMs são configurados usando um **final URL suffix**, que o Google adiciona ao final da URL da sua landing page. Você pode configurá-lo em dois níveis: escolha conforme queira ver **nomes** ou aceite os **IDs** numéricos na Patagon AI.

{% hint style="warning" %}
Os ValueTrack do Google têm tokens para os **IDs** de campanha e grupo de anúncios (`{campaignid}`, `{adgroupid}`) mas **não** para os seus **nomes**. Para mostrar nomes na Patagon AI, você os digita manualmente e os **codifica em URL** (ex. `Campaign 1` → `Campaign%201`).
{% endhint %}

### Opção A: No nível do grupo de anúncios (mostra nomes)

Use esta opção se quiser ver os **nomes** da sua campanha e grupo de anúncios na Patagon AI.

1. Vá em **Campaigns → Ad groups**.
2. Passe o cursor sobre o grupo de anúncios, clique na engrenagem de **⚙ settings** e escolha **Edit settings**.

![Ad groups — abra as configurações do grupo de anúncios](/files/uRrv7AgxsAXK0t5bGIPJ)

3. Abra **Other settings → Ad group URL options** e, em **Final URL suffix**, informe seus UTMs.

![Ad group URL options — Final URL suffix](/files/Az4xQgvJwipUVcqXhpfK)

```
utm_source=google&utm_medium=cpc&utm_campaign=Campaign%201&utm_content=Ad%20group%201&utm_term={keyword}
```

| Parâmetro      | Valor                                                                                                       |
| -------------- | ----------------------------------------------------------------------------------------------------------- |
| `utm_source`   | `google`                                                                                                    |
| `utm_medium`   | `cpc`                                                                                                       |
| `utm_campaign` | o nome da sua campanha, **codificado em URL** (ex. `Campaign%201`) ou `{campaignid}` para o ID numérico     |
| `utm_content`  | o nome do seu grupo de anúncios, **codificado em URL** (ex. `Ad%20group%201`)                               |
| `utm_term`     | `{keyword}` (a palavra-chave que disparou o clique) ou `{creative}` (o ID do anúncio que disparou o clique) |

Na Patagon AI isso aparece como: **google → cpc → Campaign 1 → Ad group 1 → keyword**.

A contrapartida: você configura isso **por grupo de anúncios** e codifica os nomes você mesmo, então é mais manual, mas obtém nomes legíveis.

### Opção B: No nível da conta (usa IDs, aplica a tudo)

Use esta opção se não precisa de nomes e quer uma única configuração global. Ela depende totalmente do ValueTrack, então a Patagon AI mostrará IDs numéricos em vez de nomes.

1. Vá em **Admin → Account settings**.
2. Na seção **Tracking**, informe seus UTMs em **Final URL suffix** e salve.

![Account settings — Tracking → Final URL suffix](/files/GK1OevvOI5B0diebKcgz)

```
utm_source=google&utm_medium=cpc&utm_campaign={campaignid}&utm_content={adgroupid}&utm_term={keyword}
```

| Parâmetro      | Valor                                                          |
| -------------- | -------------------------------------------------------------- |
| `utm_source`   | `google`                                                       |
| `utm_medium`   | `cpc`                                                          |
| `utm_campaign` | `{campaignid}` (o ID numérico da campanha, não o nome)         |
| `utm_content`  | `{adgroupid}` (o ID numérico do grupo de anúncios, não o nome) |
| `utm_term`     | `{keyword}` ou `{creative}`                                    |

Mais simples (configurado uma única vez para a conta inteira), mas a Patagon AI mostra IDs em vez de nomes.

## Referência de ValueTrack

Parâmetros de ValueTrack comuns que você pode usar em um final URL suffix: `{keyword}`, `{creative}` (o ID do anúncio), `{campaignid}`, `{adgroupid}`, `{network}`, `{device}`. Para a lista completa e atualizada, veja a [documentação de parâmetros ValueTrack do Google](https://support.google.com/google-ads/answer/6305348).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/marketing-e-atribuicao/google-campaigns/google-utm-tracking.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.