Skip to content

Meta CAPI — Rastreamento Server-Side

Tempo estimado: 15 minutos para configurar.

Para Que Serve

O Meta Pixel padrão (JavaScript no navegador) perde eventos quando o cliente usa navegação privada, bloqueia cookies ou usa extensão anti-rastreamento. Isso faz seus relatórios de anúncios subestimarem as conversões reais.

A Conversions API (CAPI) envia os mesmos eventos direto do servidor PopinaFlow para o Meta — independente do navegador do cliente. Resultado: atribuição mais precisa, menor CPA calculado, melhor otimização das campanhas.

Pré-requisitos

  • Conta de anúncios ativa no Meta Ads Manager
  • Pixel criado no Gerenciador de Eventos do Meta
  • Token de acesso CAPI gerado

Passo a Passo

1. Obter o Pixel ID e o Token

  1. Acesse Meta Gerenciador de Eventos
  2. Selecione seu Pixel (ou crie um novo)
  3. Vá em Configurações → Conversions API
  4. Clique em Gerar token de acesso
  5. Anote o Pixel ID (número que aparece na URL) e o token gerado

2. Configurar no PopinaFlow

  1. Acesse Configurações → Marketing → Meta CAPI
  2. Cole o Pixel ID e o Token de acesso
  3. Mantenha Modo de teste ativado por enquanto
  4. Salve

3. Testar antes de ativar

Com o Modo de teste ativo, os eventos são registrados nos logs do sistema mas não enviados ao Meta. Faça um pedido teste e confira nos logs (Suporte → Logs de sistema) se o evento Purchase aparece.

4. Ativar em produção

Desative o Modo de teste e ative o envio real. A partir daí, cada pedido pago gera automaticamente um evento Purchase no Meta com:

  • Valor do pedido (R$)
  • Identificação anonimizada do cliente (email/telefone em SHA-256 — nunca dados brutos)
  • ID único de deduplicação (para não contar duas vezes com o Pixel browser)

Eventos Enviados

EventoQuando ocorre
PurchasePedido pago/entregue
AddToCartItem adicionado ao carrinho (se habilitado)
ViewContentVisualização de item do cardápio (se habilitado)

Privacidade

O PopinaFlow nunca envia dados pessoais em texto claro ao Meta. Todos os dados de identificação (email, telefone) são transformados em hash SHA-256 antes do envio — padrão exigido pela Meta e compatível com LGPD.

Perguntas Frequentes

Preciso remover o Pixel JavaScript do site? Não — mantenha os dois. O Pixel browser + CAPI em conjunto dão a melhor cobertura. A deduplicação garante que a conversão não será contada duas vezes.

Funciona com Instagram Ads também? Sim — a Conversions API é compartilhada entre Facebook e Instagram.

Como sei que está funcionando? No Meta Gerenciador de Eventos, em Testar eventos, você verá os eventos chegando com fonte "Server" além de "Browser".

Relacionado

Lançado sob a licença MIT.