> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/integracoes/rastreamento-de-conversoes.md).

# Rastreamento de Conversão Meta Ads

{% hint style="warning" %}
**Disponível para o perfil:** Administrador
{% endhint %}

O **Rastreamento de Conversões** permite identificar e mensurar a eficácia dos seus anúncios pagos. Ele atribui as mensagens recebidas no Z-PRO a campanhas específicas do **Meta Ads** (Facebook/Instagram) e gera relatórios para o **Google Analytics 4**. O sistema captura parâmetros técnicos, como o `CTWA Click ID`, permitindo que você saiba exatamente qual anúncio gerou cada atendimento e otimize o algoritmo da Meta para encontrar leads mais qualificados.

***

#### Como acessar a página

1. No menu principal, clique em **Configurações**.
2. Selecione a aba **Integrações**.
3. No submenu lateral esquerdo, clique em **Conversões Ads**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FyZlaJQ1mkIuiVDwySKhn%2Fimage.png?alt=media&amp;token=6f773027-c673-49cd-93d2-f9f58af66ed9" alt="" width="204"><figcaption></figcaption></figure>

***

#### Você verá a seguinte tela

A interface é dividida entre as abas de **Configurações**, onde são gerenciadas as chaves técnicas e regras, e a aba de **Relatórios de Anúncios**, onde as conversões processadas são listadas.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FM9Eztkm9J6g55Xbwkxyv%2Fimage.png?alt=media&amp;token=a9acef9e-9218-40dc-a998-292746c5cd7d" alt=""><figcaption></figcaption></figure>

***

#### Vídeo Tutorial

{% embed url="<https://youtu.be/uehWN3WX3bU>" %}

***

#### Passo a passo de configuração e uso

**1. Configurar Credenciais de Plataforma**

Para que o sistema se comunique com as ferramentas de anúncio, você deve inserir as chaves de acesso:

* **Para Meta/Facebook:** Clique em **+ Nova credencial**, selecione a plataforma e insira o **Pixel ID** e o **Access Token** (gerado no Gerenciador de Eventos da Meta em Configurações > Conversions API).
* **Para Google GA4:** Clique em **+ Nova credencial**, selecione Google GA4 e insira o **Measurement ID** (ID de Mensuração) e a **API Secret** (Chave secreta do protocolo de mensuração).

**2. Definir Regras de Conversão**

Você precisa dizer ao sistema qual evento disparar quando uma mensagem chegar:

* Clique em **+ Nova regra**.
* **Gatilho:** Selecione "Conversa Iniciada via Anúncio (WABA/Instagram/Messenger)".
* **Evento (Meta):** Use preferencialmente o nome `LeadSubmitted` (ou `Lead`). Este nome é o que aparecerá no seu Gerenciador de Anúncios para otimização da campanha.
* **Evento (G.A):** Defina um nome como `qualify_lead` ou `generate_lead` para fins de relatório no Analytics.

**3. Configuração do Anúncio (Lógica CTWA)**

Para o rastreamento funcionar, a sua campanha na Meta deve ser do tipo **"Cliques para o WhatsApp"** (destino direto no WhatsApp).

* Quando o cliente clica no anúncio e envia a mensagem, a Meta anexa o parâmetro `CTWA Click ID`.
* O Z-PRO identifica esse parâmetro automaticamente e devolve a conversão para a Meta e Google, confirmando que o clique resultou em uma conversa real.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FtmhJP0rSK4QPGdD3biw2%2Fphoto_2026-05-25_10-46-52.jpg?alt=media&amp;token=e652b56d-d45c-4b5d-9486-6fab196407b2" alt=""><figcaption></figcaption></figure>

**4. Consultar Relatórios de Anúncios**

Na aba **Relatórios de Anúncios**, você pode auditar os resultados em tempo real:

* **Filtros:** Busque por período, Canal específico ou pelo ID do Anúncio.
* **Análise de Dados:** A tabela exibirá o **Título do Anúncio**, o **Contato** vinculado, o número do **Ticket** e o código **CTWA Click ID**.
* **Status do Evento:** Verifique se o evento consta como "Enviado", confirmando que a plataforma de anúncios recebeu o dado de conversão.
* **URL:** Clique em "Ver anúncio" para visualizar a peça criativa que gerou aquele atendimento.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FekFUztmJVIP2vRCupG20%2Fimage.png?alt=media&amp;token=9164412d-4ffa-405d-b192-624e7fd9ee4b" alt=""><figcaption></figcaption></figure>

***

#### Avisos e Precauções

{% hint style="danger" %}
**Limitação de Atribuição:** O rastreamento **não funciona** se o anúncio enviar o cliente para um site/landing page intermediária. Quando o cliente clica em um botão de WhatsApp dentro de um site, o parâmetro original do anúncio (Click ID) se perde, impossibilitando a atribuição direta nesta página.
{% endhint %}

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FXsxtTyMaXkJADrhsiKX7%2Fphoto_2026-05-25_10-46-58.jpg?alt=media&amp;token=7f06413b-35c1-4cc5-9b4d-af1d7e950f9d" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Google Ads:** Diferente da Meta, o Google Ads não envia o ID de clique nativamente dentro da mensagem do WhatsApp. A integração com Google nesta página serve para alimentar o **Google Analytics (GA4)** com relatórios de volume, mas não otimiza lances de campanhas de pesquisa diretamente como ocorre no Facebook/Instagram.
{% endhint %}

{% hint style="info" %}
**Conjunto de Dados:** Em alguns casos, a Meta cria um conjunto de dados automático para mensagens (ex: "Z-PRO Event Data"). Verifique no seu Gerenciador de Eventos se o ID do Pixel que você está usando é o mesmo que está recebendo os eventos de mensagem.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/integracoes/rastreamento-de-conversoes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.