Pixel de Rastreamento

O que são pixels de rastreamento?

Pixels de rastreamento são pequenos trechos de código JavaScript que as plataformas de anúncio (Meta, Google Ads e TikTok) fornecem para medir o comportamento dos visitantes após uma campanha. Quando integrados ao checkout, eles permitem:

  • Atribuir vendas às campanhas que as originaram
  • Otimizar automaticamente os lances (bidding) das suas campanhas
  • Criar públicos de remarketing com base em compradores reais
  • Calcular o ROAS (Retorno sobre Investimento em Anúncios) com precisão

O checkout Bempaggo injeta o código de pixel dinamicamente a partir das credenciais que você cadastra na plataforma Everest — nenhuma alteração de código é necessária da sua parte.


Plataformas suportadas

O checkout dispara eventos automaticamente para as três plataformas abaixo a cada transação.

PlataformaID necessárioDescrição
Meta (Facebook)FB_PIXEL_IDRastreia visualizações, início de checkout e compras no Facebook Ads e Instagram Ads.
Google AdsADWORDS_IDEnvia conversões para o Google Ads via gtag.js, suportando Smart Bidding e ROAS alvo.
TikTokTIKTOK_IDRastreia eventos de checkout e pagamento no TikTok Ads via pixel oficial.

Fluxo de carregamento

Entenda o ciclo de vida completo do pixel desde o acesso do comprador até o registro da conversão.

1. Comprador acessa a página do checkout O browser carrega o HTML do checkout. As tags <script> de pixel já estão presentes na página, mas sem conteúdo — elas são placeholders que serão preenchidos dinamicamente.

2. Consulta às credenciais do pixel Assim que o checkout é carregado, ele consulta automaticamente os IDs de pixel cadastrados para aquele produto na plataforma Everest.

3. Injeção dos scripts de pixel Com os IDs em mãos, o checkout injeta o código das bibliotecas de pixel nos placeholders: fbevents.js (Meta), gtag.js (Google) e events.js (TikTok). Cada script inicializa sua respectiva biblioteca e dispara o evento de PageView.

4. Evento InitiateCheckout Imediatamente após a injeção, o evento InitiateCheckout é enviado para todas as plataformas configuradas, indicando que o comprador abriu a página e visualizou o produto com o valor correspondente.

5. Comprador realiza o pagamento O comprador preenche seus dados e submete o pagamento. O checkout começa a verificar periodicamente o status das cobranças geradas.

6. Evento Purchase (conversão) Quando ao menos uma cobrança atingir o status PAY (pago) ou AUTHORIZED (autorizado), o evento Purchase é disparado para todas as plataformas, registrando o valor e os itens da transação.


Eventos disparados

O checkout dispara três tipos de eventos, cada um mapeado para o nome nativo de cada plataforma.

EventoMeta (Facebook)Google AdsTikTokGatilho
Visualização de páginaPageViewconfig (page view)ttq.page()Carregamento do script
Início de checkoutInitiateCheckoutbegin_checkoutInitiateCheckoutCredenciais carregadas
Compra realizadaPurchasepurchaseCompletePaymentStatus PAY ou AUTHORIZED

InitiateCheckout

Disparado quando o comprador abre o checkout.

ParâmetroTipoDescriçãoPlataformas
valuenumberValor total do checkoutMeta, Google, TikTok
currencystringCódigo ISO da moeda (ex: BRL)Meta, Google, TikTok
num_itemsnumberQuantidade total de itensMeta
content_idsstring[]Lista de IDs dos planos/produtosMeta
itemsobject[]Lista com item_id, item_name, quantity e priceGoogle
contentsobject[]Lista com id, name, quantity e priceTikTok

Purchase / CompletePayment

Disparado quando o pagamento é confirmado.

ParâmetroTipoDescriçãoPlataformas
valuenumberValor total da cobrança confirmadaMeta, Google, TikTok
currencystringMoeda da cobrança (ex: BRL)Meta, Google, TikTok
content_idsstring[]IDs dos planos vendidosMeta
contentsobject[]Itens com nome, quantidade e preço unitárioMeta, TikTok
content_typestringSempre "product"Meta
transaction_idstringCódigo único da transação (evita contagem duplicada)Google
itemsobject[]Lista com item_id, item_name, quantity e priceGoogle

Exemplos de payload

Exemplos das chamadas feitas pelo checkout no momento dos eventos.

Meta — InitiateCheckout

fbq('track', 'InitiateCheckout', {
  value: 97.00,
  currency: "BRL",
  num_items: 1,
  content_ids: ["42"]
});

Meta — Purchase

fbq('track', 'Purchase', {
  value: 97.00,
  currency: "BRL",
  content_ids: ["42"],
  content_type: "product",
  contents: [
    { id: "42", name: "Plano Mensal", quantity: 1, price: 97.00 }
  ]
});

Google Ads — begin_checkout

gtag('event', 'begin_checkout', {
  currency: "BRL",
  value: 97.00,
  items: [
    { item_id: "42", item_name: "Plano Mensal", quantity: 1, price: 97.00 }
  ]
});

Google Ads — purchase

gtag('event', 'purchase', {
  transaction_id: "TRX-00012345",
  currency: "BRL",
  value: 97.00,
  items: [
    { item_id: "42", item_name: "Plano Mensal", quantity: 1, price: 97.00 }
  ]
});

TikTok — InitiateCheckout

ttq.track('InitiateCheckout', {
  value: 97.00,
  currency: "BRL",
  contents: [
    { id: "42", name: "Plano Mensal", quantity: 1, price: 97.00 }
  ]
});

TikTok — CompletePayment

ttq.track('CompletePayment', {
  value: 97.00,
  currency: "BRL",
  contents: [
    { id: "42", name: "Plano Mensal", quantity: 1, price: 97.00 }
  ]
});

Como configurar um pixel

O processo é realizado inteiramente pela plataforma Everest, sem necessidade de alterar código.

  1. Acesse o painel Everest com sua conta.
  2. No menu lateral, navegue até Configurações > Pixels.
  3. Clique em Novo pixel e selecione a plataforma desejada (Meta, Google Ads ou TikTok).
  4. Informe o(s) ID(s) exigidos pela plataforma (veja a seção abaixo).
  5. Associe o pixel ao plano ou produto correspondente ao checkout.
  6. Salve. As credenciais serão entregues automaticamente ao checkout na próxima visita de um comprador.

Não é necessário reinicializar ou republicar o checkout. A busca de credenciais ocorre a cada carregamento de página.


IDs necessários por plataforma

Meta (Facebook / Instagram)

Acesse o Gerenciador de Eventos do Meta.

CampoOnde encontrarExemplo
FB_PIXEL_IDGerenciador de Eventos > Fontes de Dados > Pixel > Detalhes1234567890123456

Google Ads

Acesse Google Ads > Ferramentas > Medição > Conversões.

CampoOnde encontrarExemplo
ADWORDS_IDID do cliente da conta Google Ads (formato AW-XXXXXXXXX)AW-123456789

TikTok

Acesse o TikTok Ads Manager > Ativos > Eventos > Web Events.

CampoOnde encontrarExemplo
TIKTOK_IDPixel ID exibido na tela de configuração do pixelCXXXXXXXXXXXXXXXXX

Perguntas frequentes

O pixel dispara mesmo que o comprador não conclua o pagamento?

Sim. O evento InitiateCheckout é disparado assim que o checkout carrega as credenciais — independentemente de o comprador efetuar o pagamento. O evento Purchase só é enviado após a confirmação real do pagamento.

O evento de Purchase pode ser enviado mais de uma vez?

O checkout verifica o status das cobranças periodicamente. A lógica de negócio garante que o evento de Purchase seja disparado quando a primeira cobrança atingir status PAY ou AUTHORIZED. Para o Google Ads, o campo transaction_id com o código único da transação impede a contagem duplicada no painel do Google. Para Meta e TikTok, recomenda-se ativar a deduplicação via API de Conversões (server-side), que é uma funcionalidade futura planejada.

Posso cadastrar pixels de plataformas diferentes no mesmo checkout?

Sim. O checkout suporta múltiplos pixels simultâneos. Se você cadastrar IDs para Meta, Google Ads e TikTok, todos os três serão disparados nos momentos corretos.

Como verificar se o pixel está funcionando?

Utilize as ferramentas de diagnóstico de cada plataforma:

O Hotjar também está ativo no checkout?

Sim. O Hotjar está integrado de forma fixa em todos os checkouts para análise de usabilidade interna da Bempaggo. Ele não está disponível para configuração pelo cliente.