> For the complete documentation index, see [llms.txt](https://hubla.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hubla.gitbook.io/docs/pixel-ads/facebook-meta-ads/explorando-eventos-enviados-em-tempo-real.md).

# Explorando eventos enviados em tempo real

## Introdução

Depois de configurar o Pixel e a API de Conversões, é crucial entender os eventos que sua plataforma está capturando e enviando para o Facebook Meta Ads. Esses eventos são essenciais para medir o desempenho das suas campanhas e otimizar os resultados. Vamos explorar como visualizar e interpretar esses eventos em tempo real.

## O que são eventos?

Os **eventos** são as ações que os usuários realizam no seu site ou aplicativo e que são enviados ao Facebook para rastreamento e análise. Eles podem ser disparados automaticamente (como visualização de página) ou personalizados para capturar interações específicas (como adição ao carrinho, finalização de compra, etc.).

Os eventos podem ser enviados de duas formas:

1. **Via navegador (Facebook Pixel)** – os eventos são capturados e enviados diretamente do navegador do usuário.
2. **Via servidor (API de Conversões)** – os eventos são enviados diretamente do servidor da sua plataforma para os servidores do Facebook, garantindo maior precisão, especialmente quando o rastreamento via navegador é bloqueado.

***

## **Visualizando eventos em tempo real no Gerenciador de Eventos**

Você pode verificar se os eventos estão sendo enviados corretamente e ver quais interações estão ocorrendo em tempo real. Para isso, siga os passos:

1. **Acesse o Gerenciador de Eventos**:
   * Faça login no [Facebook Meta Ads Manager](https://www.facebook.com/adsmanager).
   * No menu superior esquerdo, clique no ícone **menu (≡)** e selecione **Gerenciador de Eventos**.<br>

     <figure><img src="https://362338790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2RlpXepfB0XfFvxSdcP%2Fuploads%2Fd117nRoJKdnHeczxSkTh%2Fimage.png?alt=media&amp;token=b09923c0-d19f-448a-9e28-6709e1b2663d" alt=""><figcaption></figcaption></figure>
2. **Selecionar o Pixel**:
   * No painel do Gerenciador de Eventos, você verá uma lista de fontes de dados
   * Selecione o Pixel que você deseja monitorar para visualizar os eventos relacionados.<br>

     <figure><img src="https://362338790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2RlpXepfB0XfFvxSdcP%2Fuploads%2FDXpvWCKfnDojW3Aq9iTp%2Fimage.png?alt=media&amp;token=9f3ca968-41e3-46cb-b699-e9b3186938b8" alt=""><figcaption></figcaption></figure>
3. **Monitorar eventos**:
   * Na seção **Visão Geral**, você verá um painel que exibe os eventos enviados em tempo real. Isso inclui eventos como **PageView**, **Visualização de Conteúdo**, **Iniciar finalização da compra, Compra**, entre outros.
   * Você pode ver quantos eventos foram disparados e o status de cada evento (sucesso ou falha).<br>

     <figure><img src="https://362338790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2RlpXepfB0XfFvxSdcP%2Fuploads%2FZ4421vbyna26mzcKXAuc%2Fimage.png?alt=media&amp;token=f62f8de9-46cd-4814-a6cb-5b389e1981ee" alt=""><figcaption></figcaption></figure>

     <figure><img src="https://362338790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2RlpXepfB0XfFvxSdcP%2Fuploads%2FNb0Du1R9xgcW75lZSkNt%2FCaptura%20de%20Tela%202024-09-26%20a%CC%80s%2016.40.52.png?alt=media&amp;token=99ad68ca-8a0e-4af4-a63f-4c652717c088" alt=""><figcaption></figcaption></figure>

***

## **Principais eventos que a plataforma da Hubla envia**

Aqui estão os eventos que a Hubla envia para o Meta Ads, tanto via Pixel quanto via API de Conversões. Esses eventos são fundamentais para entender o comportamento dos usuários e otimizar as campanhas de marketing:

| **Evento**           | **Descrição**                                                                              | **Origem (Pixel ou API)** | **Comportamento padrão da Hubla**                                |
| -------------------- | ------------------------------------------------------------------------------------------ | ------------------------- | ---------------------------------------------------------------- |
| **PageView**         | Quando um usuário visita uma página.                                                       | Pixel                     | Enviado                                                          |
| **ViewContent**      | Disparado quando um usuário visualiza um conteúdo específico, como a sua página de compra. | Pixel                     | Enviado                                                          |
| **InitiateCheckout** | Quando o processo de checkout é iniciado.                                                  | Pixel, API de Conversões  | Disparado quando o cliente começa a preencher os dados da compra |
| **AddToCart**        | Quando o cliente aceita uma oferta adicional (order bump).                                 | Pixel, API de Conversões  | Enviado                                                          |
| **Purchase**         | Disparado quando uma compra é concluída.                                                   | Pixel, API de Conversões  | Enviado apenas para vendas aprovadas, com o valor total pago     |

{% hint style="info" %}
Essa é a **configuração padrão recomendada pela Hubla**. Ela segue as boas práticas das plataformas de anúncio e, na Meta, alcança **9,3/10** de **Event Match Quality** (qualidade da correspondência), métrica consultada através da Dataset Quality API.
{% endhint %}

### **A importância de combinar Pixel e API de Conversões**

O uso combinado de Pixel e API de Conversões oferece uma visão completa do comportamento dos usuários. O Pixel capta as interações em tempo real, enquanto a API de Conversões garante que eventos importantes sejam capturados mesmo quando o Pixel é bloqueado ou falha. Essa abordagem híbrida resulta em dados mais precisos e otimiza o desempenho das campanhas, melhorando a segmentação e o rastreamento de conversões.

***

## **Personalizando os eventos do seu pixel**

Cada operação de tráfego tem uma estratégia de mensuração diferente. Por isso, além do padrão acima, você pode **personalizar quais eventos são enviados, em que momento cada um é disparado e qual valor é considerado na conversão**.

<figure><img src="https://362338790-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm2RlpXepfB0XfFvxSdcP%2Fuploads%2Fgit-blob-dccc109c9e707aa4184a34e7241c37b14c7a59dc%2Fpersonalizacao-eventos-pixel.png?alt=media" alt="Painel de personalização de eventos de pixel na Hubla"><figcaption><p>Painel de personalização de eventos, disponível na configuração de cada pixel.</p></figcaption></figure>

### O que é possível personalizar

* **Visita à página (ViewContent)** — você escolhe se o evento será enviado ou não.
* **Início da compra (InitiateCheckout)** — além de ativar ou desativar, você define **quando** o evento dispara:
  * *Quando o cliente começa a preencher* — conta só quem demonstrou intenção, gerando um sinal mais preciso. **(padrão da Hubla)**
  * *Assim que a página abre* — conta logo que o cliente chega ao checkout, gerando mais volume de eventos.
* **Item extra adicionado (AddToCart)** — você escolhe se o evento do order bump será enviado.
* **Compra (Purchase)** — aqui você personaliza tanto o momento do disparo quanto o valor da conversão:
  * **Quando enviar:** *apenas vendas aprovadas* **(padrão da Hubla)** ou *vendas pendentes e aprovadas*, incluindo o momento em que o boleto ou Pix é gerado, antes do pagamento.
  * **Valor enviado:** *valor total pago*, incluindo os juros do parcelamento **(padrão da Hubla)**, ou *valor total pago sem juros*, já considerando os descontos aplicados.

{% hint style="warning" %}
As opções disponíveis variam de acordo com o provedor de anúncio, já que cada plataforma aceita um conjunto diferente de eventos. A personalização é feita **individualmente para cada pixel**.
{% endhint %}

### Quando vale a pena personalizar

A personalização é **opcional** — quem não altera nada continua com o padrão recomendado pela Hubla. Ela costuma fazer sentido em dois cenários:

1. **Migração de plataforma** — se você já tinha campanhas estruturadas em torno de um determinado comportamento de eventos, é possível reproduzir essa lógica na Hubla e fazer a transição sem reaprender a medir.
2. **Estratégia própria de mensuração** — quando a sua operação já definiu o que considera conversão (pagamento aprovado ou Pix gerado?) e qual valor faz sentido enviar (com ou sem juros do parcelamento).

{% hint style="info" %}
Se você está começando agora ou não tem uma necessidade específica, recomendamos manter a configuração padrão da Hubla.
{% endhint %}

### Como personalizar

{% stepper %}
{% step %}

#### Acesse seus produtos

Entre em [app.hub.la/dashboard/products](https://app.hub.la/dashboard/products) e escolha o produto que você quer configurar.
{% endstep %}

{% step %}

#### Abra o Pixel de Rastreamento

No menu do produto, selecione **Pixel de Rastreamento** e escolha o pixel que deseja ajustar — ou adicione um novo.
{% endstep %}

{% step %}

#### Confira as credenciais

Preencha ou confira o ID e o token do pixel e avance.
{% endstep %}

{% step %}

#### Configure os eventos

Ative ou desative os eventos disponíveis, escolha o comportamento de cada um e **salve** a configuração.
{% endstep %}

{% step %}

#### Teste antes de usar

Use a opção de teste para validar se os eventos estão sendo disparados de acordo com o que você configurou.
{% endstep %}
{% endstepper %}

### Testando a configuração antes de colocar no ar

Depois de salvar, a Hubla abre um **checkout de teste** com dados fictícios e um painel lateral que permite acompanhar em tempo real:

* quais pixels foram carregados;
* quais parâmetros de rastreamento chegaram ao checkout;
* quais eventos foram disparados e em qual ordem.

Você também pode informar o endereço da sua **landing page** e começar o teste por ela, validando o caminho completo e conferindo se os parâmetros de rastreamento estão sendo repassados corretamente para a Hubla no momento do redirecionamento.

{% hint style="success" %}
Os eventos realizados no checkout de teste **não são contabilizados** como dados reais no seu provedor de anúncio.
{% endhint %}

{% hint style="warning" %}
Aguarde alguns instantes após salvar uma alteração — a configuração pode levar um curto período para sincronizar. Se o teste ainda mostrar o comportamento anterior, aguarde e tente novamente.
{% endhint %}

Para mais detalhes, consulte o artigo [Como customizar eventos de pixel?](https://help.hub.la/hc/pt-br/como-customizar-) na nossa Central de Ajuda.

***

## Nota de Qualidade da correspondência

A **qualidade da correspondência** é uma métrica utilizada pelo Facebook para avaliar a precisão dos dados enviados via Pixel e API de Conversões, especialmente para eventos críticos como **Compra** e **Iniciar Finalização da Compra**. Ela representa o quão bem as informações enviadas, como dados do usuário (e-mail, telefone, nome), são correspondidas aos dados existentes no Facebook. Quanto mais alta a qualidade da correspondência, melhor será a eficácia dos anúncios, permitindo uma segmentação mais precisa e a otimização das campanhas.

### **O que significa a qualidade da correspondência?**

A qualidade da correspondência mede a precisão dos dados enviados sobre os usuários (por exemplo, durante a compra ou no processo de checkout) em relação às informações que o Facebook já tem em suas plataformas. Isso afeta diretamente como o Facebook pode rastrear eventos e otimizar suas campanhas de remarketing e conversões.

A métrica é avaliada em uma escala de 0 a 10, sendo que uma pontuação de **9,3/10** indica que a correspondência entre os dados enviados e os dados do Facebook é extremamente alta, o que sugere que a captura de informações como e-mails, números de telefone, nomes, entre outros, está sendo realizada de forma eficiente.

### **Importância da qualidade de correspondência alta para eventos de Iniciar Finalização da Compra e Compra**

A qualidade da correspondência é especialmente importante para eventos como **Compra** e **Iniciar Finalização da Compra** por várias razões:

1. **Melhor segmentação de anúncios**:
   * Com uma correspondência alta, o Facebook consegue identificar com mais precisão os usuários que estão realizando essas ações. Isso permite criar públicos personalizados altamente eficazes, como quem abandonou o carrinho ou concluiu uma compra.
2. **Otimização das conversões**:
   * Uma correspondência precisa melhora a otimização de campanhas focadas em conversão, como campanhas de vendas e remarketing. Isso significa que suas campanhas serão mostradas para pessoas com maior probabilidade de concluir a compra, com base em dados comportamentais confiáveis.
3. **Redução de custos com anúncios**:
   * Uma correspondência de alta qualidade pode reduzir o custo por aquisição, pois o algoritmo do Facebook pode trabalhar com dados mais precisos, direcionando os anúncios de forma mais eficiente para o público certo.