Bruno.
Meta AdsCAPITracking

Meta Conversions API: guia prático para EMQ 8+

Como instalar Meta CAPI via Stape, Zapier ou servidor próprio. Parâmetros obrigatórios, hashing, deduplicação e como atingir Event Match Quality acima de 8.

Bruno Matos··12 min

O Meta Pixel sozinho já não chega. Em 2026, com iOS 17+, Firefox ITP e ad blockers cada vez mais agressivos, 30-50% dos eventos nem sequer saem do browser. A solução é o Conversions API (CAPI) — tracking server-side que envia eventos diretamente do teu servidor para a Meta.

Porque é que CAPI importa tanto

Além de recuperar sinal perdido, CAPI é a condição para o Event Match Quality (EMQ) alto — o score de 0-10 que a Meta dá a cada evento para saber quão bem o matcheia a uma pessoa. EMQ 8+ melhora:

  • Performance do Advantage+ Shopping e Advantage+ Leads
  • Precisão de Custom Audiences
  • Quality dos Lookalikes
  • Atribuição de conversões pós-iOS

3 formas de instalar CAPI

Opção A — Stape (mais fácil)

Stape é SaaS de server-side tagging focado em marketing. Setup:

  1. Conta em stape.io
  2. Criar um container (gratuito até certo volume)
  3. Ativar o "Meta Conversions API Tag"
  4. Colar Pixel ID, Access Token, Test Event Code
  5. Mapear eventos do Pixel → CAPI

Tempo: 30 minutos. Custo: gratuito até 10k eventos/mês, depois €20-50/mês.

Opção B — GTM server-side no Google Cloud

Mais controlo, custo mínimo a escala. Requer setup no Google Cloud Run (~€5-15/mês).

  1. GTM → Admin → Criar container server-side
  2. Google Cloud → Cloud Run → deploy container
  3. Configurar custom domain (ex: metrics.obruno.pt)
  4. Instalar tags client-side que enviam para o servidor
  5. No server, tags para GA4 + Meta CAPI + Google Ads

Opção C — Direct API (máximo controlo)

O teu backend envia eventos diretamente ao endpoint da Meta Graph API. Útil para apps e plataformas com alto volume.

Parâmetros que sobem o EMQ

Cada evento pode incluir parâmetros hashados (SHA256) do utilizador. Meter o máximo possível:

  • em — email hashado (+ alto impacto)
  • ph — telefone hashado em formato E.164
  • fn, ln — primeiro e último nome hashados
  • ct, st, zp, country — localização
  • client_ip_address — IP (não hashar)
  • client_user_agent — user agent
  • fbc, fbp — Facebook click ID e browser ID (do cookie)
  • external_id — ID interno do cliente (hashado)

Quanto mais parâmetros, mais alto o EMQ. Com email + phone + IP + user agent + fbp/fbc já estás em 7-8.

Deduplicação

Se o Pixel e o CAPI enviarem o mesmo evento, a Meta pode contar duplicado. Para evitar, envia o event_id igual nos dois:

  • Pixel client-side: fbq('track', 'Purchase', {...}, {eventID: uuid})
  • CAPI server-side: event_id: uuid

A Meta deduplica dentro de 7 dias.

Verificar EMQ

Events Manager → Data Sources → Pixel ID → Overview. Olha para "Event Match Quality" por evento. Objetivo: 8+.

Checklist de setup CAPI

  • Pixel + CAPI a enviar os mesmos eventos principais
  • event_id implementado para deduplicação
  • Pelo menos 6 parâmetros de utilizador por evento
  • EMQ acima de 7 em Events Manager
  • Test Event Code configurado para debugging
  • Consent Mode respeitado (não enviar dados sem consentimento)

CAPI bem feito é diferença dramática em contas Meta a partir de 2024. Se queres ajuda a implementar, vê o serviço de tracking ou pede auditoria.