> For the complete documentation index, see [llms.txt](https://ajuda.norux.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.norux.chat/admin/configuracao-e-administracao/rastreamento-de-conversoes.md).

# Rastreamento de Conversões

## Rastreamento de Conversões

{% 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 Norux 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**.

***

**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.

***

**Vídeo Tutorial**

***

**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 Norux identifica esse parâmetro automaticamente e devolve a conversão para a Meta e Google, confirmando que o clique resultou em uma conversa real.

**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.

***

**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 %}

{% 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: "Norux 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 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://ajuda.norux.chat/admin/configuracao-e-administracao/rastreamento-de-conversoes.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.
