> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/vambe-ads/vambe-ads-pt-br/envie-eventos-para-a-meta/eventos-en-vambe-ads-como-optimizar-tus-campanas-con-retroalimentacion-real.md).

# Eventos no Vambe Ads: como otimizar suas campanhas com feedback real

## Eventos no Vambe Ads: como otimizar suas campanhas com feedback real

### O que é a funcionalidade de Eventos no Vambe Ads?

A funcionalidade de **Eventos** permite enviar informações de feedback diretamente para os pixels das suas plataformas de anúncios, como **Meta Ads** e **TikTok Ads** (Google Ads estará disponível em breve).

Esses eventos informam às plataformas quando ocorrem ações reais dentro do Vambe, como, por exemplo, um **agendamento**, o que permite que seus algoritmos aprendam com conversões reais e não apenas com cliques ou impressões.

{% hint style="info" %}
Pré-requisito: antes de configurar eventos, você deve ter seu pixel corretamente conectado.\
Se ainda não fez isso, veja: 👉 [Como conectar o Meta Pixel no Vambe Ads](https://academy.vambe.ai/vambe-ads/conecta-tus-cuentas/como-conectar-el-meta-pixel-capi-en-vambe-ads)
{% endhint %}

### Para que servem os eventos?

Os eventos permitem que suas campanhas de anúncios sejam otimizadas automaticamente com base no que realmente importa: **ações reais dos seus leads**.

Principais benefícios

* Melhor otimização do algoritmo das plataformas de anúncios
* Redução de custos em campanhas
* Melhores taxas de conversão
* Leads de maior qualidade

(Vídeo: explicação geral — 0:27 a 0:55)

{% embed url="<https://www.youtube.com/watch?v=WEYz7obYtQE>" %}

### Passo a passo: como configurar Eventos no Vambe Ads

{% stepper %}
{% step %}
**Acessar a seção de Eventos**

(Vídeo: 1:07 – 1:14)

* [Acesse o Vambe Ads](https://academy.vambe.ai/vambe-ads/como-ingresar-a-vambe-ads):
* No menu lateral esquerdo, clique em **Eventos**

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/bAzMquZ6xb2Jf50qHNd0/image\(123\).png)

* Se for sua primeira vez, você verá a tela vazia de eventos

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/KZhW3CW8UyRO9Upg8zKH/image\(124\).png)
{% endstep %}

{% step %}
**Conectar seu pixel (se ainda não fez isso)**

(Vídeo: 1:17 – 1:22)

* Clique em **Conectar pixel**
* Você será redirecionado para a tela de **Espaços de trabalho**
* Aqui ficam todas as configurações de integrações

(Veja também: <https://academy.vambe.ai/vambe-ads/conecta-tus-cuentas/como-conectar-el-meta-pixel-capi-en-vambe-ads>)
{% endstep %}

{% step %}
**Configurar a conexão do pixel**

(Vídeo: 1:29 – 1:48)

* Você pode conectar:
  * Pixel do **Meta**
  * Pixel do **TikTok**
* O sistema vai te guiar com um **tutorial passo a passo** e mostrará imagens com as informações necessárias em cada plataforma.
  {% endstep %}

{% step %}
**Inserir as credenciais do pixel**

(Vídeo: 1:56 – 2:14)

* Insira o **ID do pixel**
* Insira a **chave secreta**
* O sistema validará a conexão (leva apenas alguns segundos)

✅ Uma vez validado, o pixel ficará conectado e pronto para receber eventos
{% endstep %}

{% step %}
**Configurar eventos específicos**

(Vídeo: 2:18 – 2:41)

* Volte para a tela de **Eventos**
* Selecione o **funil (pipeline)** em que você quer trabalhar

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/BxDDNEoUh9DtiJUFmrsx/image\(125\).png)

* Defina o evento que você deseja enviar

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/tFlhw7AVy02BnLzZFBiT/image\(126\).png)

Exemplo prático:

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/oYPZxuvUKqZPhf8DHzMI/image\(127\).png)

* Evento: **Mudança de etapa**
* Etapa: *Schedule Leads*
* Resultado: é enviado um evento ao pixel indicando que ocorreu um **agendamento**
  {% endstep %}

{% step %}
**Salvar e ativar o evento**

(Vídeo: 2:48 – 2:58)

* Salve a configuração

A partir desse momento, cada contato que entrar na etapa configurada enviará automaticamente o evento para **Meta** e **TikTok**.

![](https://content.gitbook.com/content/BeqJYnB10ImYM5stMls3/blobs/E002aWgT7EAWtLGpRHZo/image\(128\).png)
{% endstep %}

{% step %}
**Testar a configuração (Test Event)**

(Vídeo: 3:18 – 3:37)

* Clique em **Evento de teste**
* Simula um contato entrando na etapa configurada
* Você poderá ver:
  * O movimento do contato no funil
  * Que o evento esteja sendo enviado corretamente
    {% endstep %}

{% step %}
**Monitoramento e acompanhamento de eventos**

(Vídeo: 3:41 – 4:09)

* Uma vez configurados, os eventos aparecem no painel principal e são exibidos quando estão sendo enviados.
* Isso permite verificar em tempo real se tudo está funcionando corretamente.
  {% endstep %}
  {% endstepper %}

### Confira o resumo dos seus eventos

Dentro de **Eventos**, a aba **Resumo** mostra de relance como está funcionando o envio dos seus eventos para as plataformas de anúncios, sem precisar revisar cada evento configurado separadamente.

No canto superior direito, você escolhe o **período** que você quer analisar, com intervalos predefinidos (hoje, últimos 7/14/30 dias, este mês, mês passado, últimos 3/6 meses) ou um intervalo personalizado no calendário.

![Seletor de período](https://3535060037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FckvS5gnaf6OuuP4pCl8x%2Fresumen-eventos-selector-periodo.png?alt=media)

Para esse período, quatro indicadores resumem o estado geral:

* **Total**: todos os eventos gerados.
* **Bem-sucedidos**: os que chegaram corretamente à plataforma de anúncios.
* **Omitidos**: os que não foram enviados porque o contato não trouxe as informações necessárias para atribuição (por exemplo, sem ID de clique nem dados de contato).
* **Falhos**: os que a plataforma de anúncios rejeitou, normalmente por um problema de configuração.

Abaixo, o gráfico **Eventos por dia** mostra a evolução diária de cada uma dessas categorias, útil para detectar picos ou quedas no envio. Mais abaixo, a tabela de **Eventos** lista cada evento configurado junto com sua quantidade de **enviados** —os que efetivamente foram enviados para a plataforma de anúncios, sem contar os omitidos— e sua **taxa de sucesso** sobre esses enviados.

![Resumo de eventos com KPIs, gráfico e tabela](https://3535060037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2F5ElbUJvqm3lvSYVOZnxb%2Fresumen-eventos-kpis-tabla.png?alt=media)

Ao clicar em qualquer linha da tabela, abre-se um painel com os detalhes desse evento em particular, dividido em duas abas:

* **Resumo**: repete os mesmos indicadores e o gráfico diário restritos a esse evento, e adiciona o detalhe de por que cada envio foi omitido ou falhou —por exemplo, que o clique seja mais antigo que a janela de conversão configurada, ou que o contato não traga dados de atribuição— junto com uma breve explicação do que fazer em cada caso.

![Detalhe de um evento com causas de falhas e omitidos](https://3535060037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2F9ET241U4jGHicenfTaj8%2Fresumen-eventos-detalle-resumen.png?alt=media)

* **Histórico**: um registro cronológico de cada envio desse evento, com a plataforma de destino, o contato associado, a data e hora exatas, e se o envio foi bem-sucedido ou omitido.

![Histórico de envios de um evento](https://3535060037-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FeBSvWBV3VDtgaVAmItkc%2Fresumen-eventos-detalle-historial.png?alt=media)

### Exporte o histórico para o Excel

Se você precisar revisar em detalhe quais conversões foram enviadas para suas plataformas de anúncios, ou auditar por que algumas não chegaram, você pode baixar esse histórico completo em um arquivo Excel em vez de percorrê-lo tela por tela dentro do Vambe.

Na tela **Resumo**, o botão **Exportar** (canto superior direito) abre o painel **Histórico de exportação**, onde você escolhe exatamente o que incluir no arquivo.

![Botão Exportar na tela Resumo](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FgsX3Mb5adT1Z6LFPs26x%2Fexport-boton-resumen.png?alt=media)

Você também pode exportar a partir dos detalhes de um evento específico: dentro do mesmo painel que se abre ao clicar em uma linha da tabela, você encontrará seu próprio botão **Exportar**. Aí o evento já vem selecionado e o intervalo de datas chega com o mesmo período que você tinha aplicado na tela anterior; o botão **Voltar** leva você de volta aos detalhes do evento sem perder a seleção.

![Exportação aberta a partir dos detalhes de um evento, com o evento preenchido e o botão Voltar](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FOKhjBsPi9TP2lRwYgCWe%2Fexport-desde-detalle-evento.png?alt=media)

O painel permite restringir a exportação por vários critérios ao mesmo tempo:

* **Eventos a incluir**: por padrão traz todos, mas você pode buscar e escolher um ou vários específicos em um buscador com seleção múltipla.
* **Plataformas**: Meta, Google Analytics, TikTok e Google Ads, todas ativas por padrão.
* **Estados**: bem-sucedidos, omitidos e falhos, para ficar só com o que você precisa auditar.
* **Intervalo de datas**: com as mesmas opções rápidas do seletor de período (últimos 7/14/30 dias, este mês etc.) ou um intervalo personalizado no calendário.

![Seletor de eventos a incluir, com buscador e seleção múltipla](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2Fqc5WbYf8A7lkmsHoyHhI%2Fexport-selector-eventos.png?alt=media)

![Seletor de intervalo de datas com opções predefinidas e calendário](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FjW5bRaLMZfQVQVezo3kJ%2Fexport-selector-fechas.png?alt=media)

Por padrão, os eventos de teste ficam fora do arquivo; se você precisar deles para uma revisão específica, ative-os com o interruptor **Incluir eventos de teste**.

{% hint style="info" %}
Se a combinação de filtros que você montou não tiver nenhum evento associado, o Vambe avisa imediatamente no mesmo painel, para que você ajuste a seleção antes de tentar novamente.
{% endhint %}

![Aviso quando nenhum evento atende aos filtros selecionados](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FpHm6bj96aJKCtBn8V61X%2Fexport-alerta-sin-resultados.png?alt=media)

O arquivo traz uma linha para cada evento enviado, com data e hora no fuso horário de quem faz o download (não em UTC), o evento e a plataforma, o status com seu motivo explicado em espanhol —incluindo as rejeições que chegam diretamente das plataformas de anúncios—, os dados do cliente final e as colunas de atribuição UTM do clique que originou a conversão, para cruzar campanhas com resultados sem sair do Excel.

Como alguns históricos podem ser muito grandes, a exportação roda em segundo plano: você verá uma barra de progresso dentro do mesmo painel enquanto o Vambe monta o arquivo, e o download começa automaticamente assim que termina.

![Barra de progresso enquanto o arquivo é gerado](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2FBYnKmv1UvtwLLQtGh567%2Fexport-barra-progreso.png?alt=media)

![Arquivo baixado automaticamente ao finalizar a exportação](https://2961245653-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBeqJYnB10ImYM5stMls3%2Fuploads%2F2RkLn5DuLEK68GPvYwRF%2Fexport-archivo-descargado.png?alt=media)

{% hint style="info" %}
Se a combinação de filtros que você escolheu ultrapassar 50.000 linhas, o Vambe não falha em silêncio: ele mostra um alerta pedindo para você restringir o intervalo de datas ou os eventos selecionados.
{% endhint %}

### Tipos de eventos disponíveis

(Vídeo: 3:08 – 3:16)

O Vambe Ads permite configurar diferentes tipos de eventos de acordo com o seu processo comercial (por exemplo, agendamentos, avanços de etapa, entre outros). Recomenda-se analisar qual tipo de evento se ajusta melhor à estratégia do seu negócio antes de configurá-los.

### Resultados esperados ao usar Eventos

(Vídeo: 3:55 – 4:07)

Uma configuração correta de eventos permite:

* Reduzir o custo das campanhas
* Obter leads com maior probabilidade de conversão
* Otimizar automaticamente os algoritmos de anúncios
* Melhorar a eficiência do gasto com anúncios

### Notas importantes

* Google Ads estará disponível em breve
* Configure apenas eventos relevantes para o seu processo real
* Use sempre **Evento de teste** para validar
* Os eventos são enviados automaticamente depois de ativados

### Conclusão

A funcionalidade de **Eventos no Vambe Ads** é uma ferramenta essencial para conectar suas campanhas de anúncios com o que realmente acontece dentro do seu funil. Ao enviar feedback direto para os pixels, as plataformas de anúncios deixam de otimizar por cliques e passam a otimizar por **resultados reais**, permitindo reduzir custos e melhorar a qualidade dos seus leads.


---

# 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://academy.vambe.ai/vambe-ads/vambe-ads-pt-br/envie-eventos-para-a-meta/eventos-en-vambe-ads-como-optimizar-tus-campanas-con-retroalimentacion-real.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.
