Desde 2021, quando a Apple lançou o iOS 14.5 com App Tracking Transparency (ATT), os Pixel do Facebook deixaram de captar uma parte significativa das conversões nos iPhones — em alguns sectores, perdeu-se 30-50% dos eventos rastreáveis. Em 2026, com iOS 17+, Safari Intelligent Tracking Prevention e bloqueadores generalizados, instalar apenas o Pixel base no site da imobiliária é deixar dinheiro na mesa.
A solução oficial da Meta chama-se Conversion API (CAPI) — um canal de tracking server-side que complementa o Pixel browser-side e recupera grande parte dos eventos perdidos. Neste guia, ficas a saber: como instalar Pixel base corretamente num site WordPress, como adicionar CAPI sem código, como fazer deduplicação correcta e como validar que está tudo a funcionar.
1. Pixel vs Conversion API — A Diferença
| Aspecto | Meta Pixel | Conversion API |
|---|---|---|
| Onde corre | Browser (JavaScript) | Servidor (HTTP) |
| Afectado por iOS 14.5+ ATT | Sim | Não |
| Bloqueado por ad blockers | Sim | Não |
| Afectado por Safari ITP | Sim (cookies _fbp limitadas a 7 dias) | Não |
| Captura cookie de browser (_fbp, _fbc) | Sim | Sim (se reencaminhado pelo servidor) |
| Pode enviar dados hashed do utilizador (email, telefone) | Não recomendado | Sim (Advanced Matching) |
A recomendação oficial da Meta desde 2022 é instalar AMBOS com deduplicação correcta. Pixel sozinho perde demasiados eventos; CAPI sozinho perde dados de cookies de browser e contextuais.
2. Antes de Começar — O Que Precisas Ter
- Acesso de admin ao Meta Business Manager
- Pixel já criado em Events Manager (se ainda não tens, criar em business.facebook.com/events_manager → “Connect Data Sources” → “Web” → “Conexão Manual” → dá nome ex. “Site Imobiliária”)
- Pixel ID (15-16 dígitos) — vais precisar várias vezes
- Access Token do CAPI — Events Manager → Settings → “Generate access token”
- WordPress (ou outro CMS) com possibilidade de instalar plugin ou inserir código no <head>
3. Instalação do Pixel Base no Site (Browser-Side)
Há 3 formas, por ordem de simplicidade:
Opção A — Plugin oficial Meta “Facebook for WordPress”
Instalar plugin (Pluginstall procurando “Facebook for WordPress” — desenvolvido pela própria Meta). Configurar Pixel ID + Access Token. Activa Pixel + CAPI automaticamente.
Pro: setup em 10 min, deduplicação correcta de fábrica.
Contra: menos controlo sobre eventos custom.
Opção B — Plugin “PixelYourSite” ou similar
Plugins terceiros pagos (€69/ano edição Pro) com mais flexibilidade — eventos por URL, integração WooCommerce, eventos customizados sem código.
Opção C — Manual no <head> (mais controlo)
Inserir este código no <head> de todas as páginas do site (em WP, via plugin tipo “Code Snippets” ou no header.php do tema):
<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s){if(f.fbq)return;n=f.fbq=function(){
n.callMethod?n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;t.src=v;
s=b.getElementsByTagName(e)[0];s.parentNode.insertBefore(t,s)}(window,
document,'script','https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'PIXEL_ID_AQUI');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=PIXEL_ID_AQUI&ev=PageView&noscript=1"/></noscript>
Substitui PIXEL_ID_AQUI (2 vezes) pelo teu Pixel ID real.
4. Eventos Essenciais Para Imobiliária
Além do PageView automático, configurar estes eventos específicos do funil de venda imobiliário:
| Evento Meta Imobiliáriaard | Quando disparar | Função |
|---|---|---|
PageView | Auto em todas as páginas | Métrica base de tráfego |
ViewContent | Visita à página de uma imóvel específica | Sinal de interesse — alimenta retargeting |
Lead | Submit do formulário de contacto | Conversão primária — alvo de optimização da campanha |
Contact | Click em telefone, WhatsApp, email | Conversão alternativa — captura intent |
Schedule | Marcação de visita / visita ao imóvel | Conversão de alta intenção |
SubmitApplication | Pedido de financiamento | Conversão de muito alta intenção |
Para disparar um evento custom no submit do formulário (exemplo):
<script>
document.querySelector('form#contactForm').addEventListener('submit', function(){
fbq('track', 'Lead', { content_name: 'form_contacto' });
});
</script>
Não Tens Tempo Para Mexer em Código?
A Rafa instala Pixel + Conversion API + deduplicação completa no teu site em menos de uma hora. Diagnóstico gratuito de 30 minutos.
Pedir Diagnóstico Gratuito5. Conversion API — Como Activar
O CAPI envia eventos do servidor para a Meta, não do browser. Há 3 caminhos:
Caminho A — Plugin oficial “Facebook for WordPress”
O plugin oficial activa CAPI automaticamente quando configuras o Pixel ID + Access Token. Cada evento browser dispara ao mesmo tempo um evento server-side com o mesmo event_id (para deduplicar).
Caminho B — Conversions API Gateway (Meta hospedado)
Meta oferece um gateway próprio em capig.facebook.com que actua como intermediário. Setup mais complexo mas separa CAPI completamente do teu site.
Caminho C — Implementação custom (via webhook)
Cada vez que um evento acontece (form submit, etc.), o teu backend (WordPress, Node, etc.) faz POST directo a:
POST https://graph.facebook.com/v22.0/PIXEL_ID/events
Authorization: Bearer ACCESS_TOKEN
{
"data": [{
"event_name": "Lead",
"event_time": 1717920000,
"event_id": "lead_abc123",
"event_source_url": "https://imobiliária.pt/contacto/",
"action_source": "website",
"user_data": {
"em": ["[SHA-256 hash do email]"],
"ph": ["[SHA-256 hash do telefone]"],
"client_ip_address": "203.0.113.42",
"client_user_agent": "Mozilla/5.0...",
"fbp": "fb.1.1717920000.1234567890",
"fbc": "fb.1.1717920000.IwAR..."
}
}]
}
Importante: emails e telefones têm de estar em SHA-256 hash (lowercase, sem espaços) — nunca enviar em plain text. Meta rejeita.
6. Deduplicação — Não Contar o Mesmo Evento 2x
Se disparas o mesmo evento via Pixel browser-side E via CAPI server-side, a Meta vai contá-lo 2 vezes. Solução: event_id partilhado.
Como funciona:
- Quando um utilizador submete o formulário, gera-se um ID único (ex:
lead_a1b2c3d4) - O Pixel browser dispara o evento Lead com
eventID: 'lead_a1b2c3d4' - O servidor envia o evento CAPI com
event_id: 'lead_a1b2c3d4'(o mesmo) - Meta detecta o ID duplicado e conta apenas uma vez
Sem este ID partilhado, métricas duplicam e o algoritmo optimiza com base em dados errados.
7. Como Verificar Se Está Tudo a Funcionar
Ferramenta 1 — Meta Pixel Helper (Chrome extension)
Instalar gratuita no Chrome Web Store. Abre a tua página, deve aparecer ícone verde com o número de eventos detectados. Se ver vermelho ou amarelo, algo não está bem.
Ferramenta 2 — Test Events em Events Manager
Events Manager → Pixel → “Test Events”. Cola URL da página, vê eventos a chegar em tempo real. Aqui distingues:
- Browser events (vêm do Pixel)
- Server events (vêm de CAPI)
- Deduplicated (têm event_id partilhado)
Ferramenta 3 — Event Match Quality (EMQ)
Métrica 0-10 que avalia qualidade dos dados que envias. Para campanhas otimizadas, devias ter:
- EMQ ≥7 — saudável
- EMQ 5-6 — aceitável
- EMQ <5 — perdes eficiência de optimização. Reforça com Advanced Matching (email + telefone hashed) via CAPI.
8. Erros Comuns Que Vejo em Imobiliárias
Erro #1 — Pixel só no thank-you page, não em todas as páginas
O Pixel base deve estar em TODAS as páginas (gerais via <head> ou tag manager). Sem isto, não consegues fazer retargeting de visitantes.
Erro #2 — Pixel duplicado (instalado 2x)
Plugin + código manual no header = eventos contados em duplicado. Verifica com Pixel Helper que aparece apenas 1× por página.
Erro #3 — Eventos Lead em form que abre Thank You page via redirect
Se o form redirect-a para /obrigado/, o evento Lead pode disparar duas vezes (no submit + no PageView do thank you). Solução: usa apenas um lado.
Erro #4 — Email e telefone enviados sem hash via CAPI
Meta rejeita silenciosamente. Dados têm de ser SHA-256 lowercase trimmed.
Erro #5 — Não enviar fbp e fbc no CAPI
Se enviar só user_data sem cookies de browser, Meta tem menos contexto para correlacionar com utilizadores. Reduz EMQ.
Erro #6 — Não configurar Aggregated Event Measurement (AEM) para iOS
No Events Manager → “Aggregated Event Measurement”, tens de definir quais 8 eventos prioritários por domínio. Sem isto, conversões em iOS não contam para optimização. Configurar: Lead em #1, Contact em #2, etc.
9. Compliance — RGPD e Cookies
Antes de disparar qualquer evento Pixel ou CAPI, precisas:
- Banner de cookies com opt-in explícito para “cookies de marketing / publicidade”
- Política de privacidade que mencione explicitamente Meta Pixel + Conversion API + cookies
_fbp,_fbc,fbclid - Mecanismo de opt-out — link no rodapé “Definições de Cookies” que permita revogar
- Não disparar eventos antes do consentimento — configura o Pixel para esperar pela aceitação
Em Portugal, a fiscalização CNPD tem multado empresas que disparam tracking sem consentimento. Não vale a pena arriscar.
10. Próximo Passo
Pixel + CAPI bem configurados recuperam 20-40% dos eventos perdidos face a Pixel sozinho — o que se traduz em algoritmo Meta a tomar melhores decisões, melhor optimização de campanhas, e mais leads pelo mesmo budget.
Se queres que façamos a instalação completa no teu imobiliária (Pixel + CAPI + deduplicação + AEM + privacy), peçe análise gratuita de 30 minutos. Saímos com checklist + setup pronto para arrancar.
Pixel + Conversion API Configurados em Menos de 1 Hora
A Rafa instala Meta Pixel, Conversion API, deduplicação, Aggregated Event Measurement e compliance RGPD no seu site. 30 min de análise gratuita.
Pedir Análise Gratuita