Facebook (Meta)

Integração com Meta Pixel (client-side) — Conversions API (CAPI) server-side está no roadmap mas ainda não implementada. Esta página cobre o estado atual + o que falta pra CAPI completa.

Meta Pixel client-side

Carregado via useAnalytics hook (não via GTM diretamente — é um SDK próprio em app/utils/metrics/facebook.ts).

Configuração por brand

Em overrides/<brand>/app/config/analytics/analytics.ts:

{
  pixelId: undefined,                   // ← undefined = fallback API
  facebookDomainVerification: null,     // ← string ou null
}

Resolução do pixelId

Mesmo padrão do GTM:

• pixelId: undefined → fallback brand.settings.analytics.pixelId da API
• pixelId: "1234567890" → usa esse valor
• pixelId: null → desativa explicitamente

facebookDomainVerification

String que vai como <meta name="facebook-domain-verification" content="..."> no <head>. Obrigatória pra que o Pixel + Conversions API tenham total funcionalidade (especialmente Aggregated Event Measurement em iOS 14+).

Pra obter o valor: Meta Business Manager → Domain → Verify → "Use Meta Tag" → copia o valor do content.

Brand	facebookDomainVerification
Betpontobet	"a66iz0zi3kxc7rkamy3itfx0uyqap7"
Demais brands ativas	null (a confirmar com time deploy se devem ter)

Eventos enviados

O front emite eventos pro Pixel via dispatcher central (app/utils/metrics/index.ts):

Evento Front	Evento Meta	Payload
sign_up	CompleteRegistration	content_name, currency
first_deposit	Purchase	value, currency, content_name: "first_deposit"
purchase (rebill)	Purchase	value, currency

Por que first_deposit E purchase?

Paridade legado. Tanto first_deposit quanto purchase disparam Purchase no Pixel (são eventos Meta canônicos), mas com content_name diferente. Permite separar audiences "compraram pela primeira vez" vs "compraram em geral" no Meta Ads Manager.

Eventos NÃO enviados

Estes eventos não disparam pro Meta Pixel hoje (mesmo aparecendo no dispatcher):

• page_view — Pixel já injeta automaticamente no init
• view_game_page — não há equivalente Meta nativo (ViewContent poderia ser adicionado)
• withdraw — Meta não tem evento padrão de saque
• view_promotion / select_promotion — desabilitado intencionalmente (paridade legado)

Se marketing precisar adicionar, é mudança coordenada (back precisa aceitar evento custom no Meta Events Manager).

Conversions API (CAPI) — Roadmap

Status atual: NÃO implementado.

O que CAPI traz que o Pixel client-side não traz:

Cenário	Pixel client	CAPI
iOS 14+ ATT prompt	Pode bloquear	Funciona
User com ad blocker	Bloqueado	Funciona
Browser com ITP estrito (Safari)	Pode bloquear	Funciona
Cookie de terceiro bloqueado	Pixel sem matching	CAPI usa external_id first-party
Server-side conversion (compra confirmada no banco)	Não funciona	Funciona perfeitamente

Por que CAPI ainda não está implementada?

A integração CAPI exige trabalho coordenado de BFF + front. O front já tem o external_id pronto (cookie rmkvera, ver Remarketing) — falta:

1. BFF aceitar external_id no payload de signup/deposit
2. BFF chamar Meta CAPI após confirmar conversão (server-side, com hashed email/phone + external_id)
3. Configurar Dataset ID + Access Token no Meta Business Manager
4. Validar deduplicação (mesmo evento dispara via Pixel client + CAPI server; Meta dedup por event_id ou external_id)

Quando o time de back priorizar, o front habilita sendToBff: true no remarketingFeaturesConfig da brand correspondente (ver Remarketing).

Como debuggar

Meta Pixel Helper (Chrome extension)

Pixel Helper mostra todos os eventos disparados na página com payload completo e pixel ID.

1. Abre a página
2. Clica no ícone do Pixel Helper
3. Vê os eventos disparados ao vivo

Events Manager → Test Events

Meta Business → Events Manager → Test Events → cola o ID do test event no ?test_event_code=TEST... da URL ou setа no Pixel.

Eventos enviados aparecem em real-time com payload completo + status de match.

Cookies Meta

DevTools → Application → Cookies:

• _fbp — browser ID gerado pelo Pixel (90 dias TTL)
• _fbc — click ID (vem de fbclid na URL — 7 dias após primeiro clique)

Anti-patterns

1. Adicionar Pixel novo via GTM tag quando useAnalytics já carrega. Duplica eventos.
2. Esquecer facebookDomainVerification. Reduz match rate em iOS 14+.
3. Disparar Purchase antes de confirmação BFF (em deposit_initiated ao invés de pix_confirmado). Infla conversão com depósitos abandonados.
4. Mudar pixelId em produção sem reset de audiência. Audiences velhas ficam órfãs; reativar com pixel novo perde histórico de matching.