Meta CAPI para clínicas: como medir lead de verdade
O que é a API de Conversões da Meta, como ela se soma ao pixel, quais eventos medir numa clínica e como fazer isso respeitando a LGPD.
Muita clínica anuncia no Instagram, recebe mensagens no WhatsApp e, no fim do mês, não sabe dizer quantos pacientes vieram de cada campanha. O Gerenciador de Anúncios mostra um número, a recepção conta outro, e ninguém confia em nenhum dos dois. A API de Conversões da Meta (CAPI) não resolve tudo sozinha, mas é a peça que falta para o rastreamento parar de depender só do navegador do paciente.
Este texto explica o que muda, quais eventos fazem sentido para uma clínica e o que você não pode enviar de jeito nenhum. Serve para o dono da clínica entender o que está pagando e para quem opera o tráfego conferir se a configuração está certa.
O que é a API de Conversões
A API de Conversões é um jeito de enviar eventos para a Meta a partir do servidor, e não do navegador. Em vez de um script no site avisar o Facebook que alguém preencheu um formulário, quem avisa é o seu próprio servidor (ou um servidor de tags), numa chamada direta para a Meta. A documentação oficial da Conversions API no Meta for Developers descreve os campos aceitos e o formato de cada evento.
Na prática, isso quer dizer que o evento continua chegando mesmo quando o navegador bloqueia scripts de terceiros, quando o paciente usa bloqueador de anúncios ou quando a página fecha antes do pixel terminar de carregar. É o que chamamos de rastreamento server-side.
Pixel e CAPI: diferença e por que usar os dois
O pixel roda no navegador. Ele é fácil de instalar e enxerga bem o comportamento na página, mas depende de o script carregar e de o navegador permitir cookies e requisições para a Meta. A CAPI roda no servidor. Ela não sofre com bloqueadores e permite enviar eventos que nem acontecem no navegador, como um agendamento confirmado pela recepção no sistema da clínica.
A própria Meta recomenda a configuração redundante: pixel e CAPI enviando os mesmos eventos. Um cobre as falhas do outro. O cuidado é não contar o mesmo lead duas vezes, e é aí que entra a deduplicação.
Os eventos que importam numa clínica
Não adianta mandar dezenas de eventos. Para clínica, quase sempre três eventos padrão da Meta dão conta do que interessa:
- Lead: o paciente deixou nome e contato num formulário. É o evento principal de uma página de captação.
- Contact: o paciente clicou para falar no WhatsApp ou ligar. Esse clique não é um lead garantido, porque muita gente abre a conversa e não manda mensagem, então vale tratar como um sinal separado.
- Schedule: a consulta ou avaliação foi agendada. É o evento mais próximo do resultado real e costuma ser registrado depois, pela recepção ou pelo sistema de agenda, e enviado via servidor.
Com esses três separados, dá para ver quantos cliques viraram conversa, quantas conversas viraram cadastro e quantos cadastros viraram agenda. Otimizar a campanha para Schedule, quando há volume suficiente, aproxima o algoritmo do paciente que de fato aparece.
Deduplicação com event_id
Se o pixel e o servidor enviam o mesmo Lead, a Meta precisa saber que é um evento só. Para isso, os dois devem mandar o mesmo event_name e o mesmo event_id. No pixel, o identificador vai no parâmetro eventID; na CAPI, no campo event_id. Quando os dois batem, a Meta descarta a cópia.
O jeito mais simples é gerar um identificador único no navegador no momento do envio do formulário, usar no pixel e repassar o mesmo valor junto com os dados do formulário para o servidor. Sem isso, o painel mostra o dobro de leads e todas as métricas de custo ficam erradas.
Um evento enviado pela CAPI tem mais ou menos este formato:
{
"event_name": "Lead",
"event_time": 1793000000,
"event_id": "lead-8f3a2c",
"action_source": "website",
"event_source_url": "https://suaclinica.com.br/avaliacao",
"user_data": {
"em": ["<e-mail normalizado e com hash SHA-256>"],
"ph": ["<telefone com DDI, normalizado e com hash SHA-256>"],
"fbp": "fb.1.1700000000000.123456789",
"client_ip_address": "203.0.113.10",
"client_user_agent": "Mozilla/5.0 ..."
}
}Qualidade de correspondência e dados com hash
A Meta só consegue atribuir um evento a um anúncio se conseguir ligar esse evento a uma pessoa. O Gerenciador de Eventos mostra uma nota de qualidade de correspondência de eventos (Event Match Quality) para cada evento enviado pelo servidor. Quanto mais parâmetros de identificação corretos, melhor a correspondência.
Os principais são e-mail, telefone, nome, o identificador do navegador (fbp), o identificador do clique no anúncio (fbc), o IP e o user agent. Dados como e-mail, telefone e nome precisam ser normalizados (minúsculas, sem espaços, telefone com código do país) e convertidos em hash SHA-256 antes do envio. Os cookies fbp e fbc, o IP e o user agent vão sem hash.
Um ponto importante: hash não é anonimização. Um e-mail com hash continua sendo dado pessoal, porque pode ser comparado com a base da Meta. Por isso o envio precisa de base legal, e não só de técnica.
LGPD: consentimento e dado de saúde
Para clínica, este é o ponto que mais pesa. Dois cuidados não são opcionais:
- Só envie com consentimento. Se o visitante não aceitou cookies de marketing, nem o pixel nem a CAPI devem enviar eventos com dados dele. O servidor precisa receber e respeitar a escolha feita no banner de cookies.
- Nunca envie informação de saúde. Pela LGPD, dado referente à saúde é dado pessoal sensível. Não mande para a Meta o procedimento de interesse, a especialidade, a condição do paciente, o que ele escreveu no formulário nem uma URL que revele isso. Use nomes de evento genéricos e uma URL neutra.
Na prática, "Lead na página de avaliação" é aceitável. "Lead para tratamento de X" não é. Se a sua clínica tem uma página por tratamento, o evento enviado não deve carregar o nome do tratamento em nenhum campo, incluindo parâmetros personalizados e o endereço da página.
As regras de publicidade do CFM e do CFO continuam valendo no anúncio: medir bem não autoriza promessa de resultado, sensacionalismo nem qualquer peça que o conselho da sua área não permita.
Como conferir no Gerenciador de Eventos
Antes de confiar nos números, teste. O Gerenciador de Eventos tem a ferramenta de teste de eventos, que gera um código de teste. Com esse código no campo test_event_code das chamadas da CAPI, os eventos aparecem em tempo real na aba de teste, sem misturar com os dados de produção.
O que olhar no teste
- O evento aparece duas vezes, uma do navegador e uma do servidor, e a Meta indica que foi deduplicado.
- Os parâmetros de cliente esperados aparecem como recebidos.
- Nenhum campo traz nome de procedimento, especialidade ou texto livre do paciente.
- Recusar os cookies no banner faz os eventos pararem de chegar.
Depois de publicado, acompanhe a aba de visão geral do conjunto de dados por alguns dias: volume de eventos por origem, avisos de diagnóstico e a nota de correspondência de cada evento. E compare com a sua planilha ou CRM. Se o painel mostra muito mais leads do que a recepção recebeu, quase sempre é deduplicação quebrada.
Lead de verdade é o que chega na recepção
A CAPI melhora o sinal que a Meta recebe, mas o objetivo final é outro: saber quais campanhas trazem pacientes. Isso exige ligar o anúncio ao formulário, o formulário ao atendimento e o atendimento à agenda. Com os eventos certos, deduplicados e enviados com consentimento, a conversa sobre tráfego pago deixa de ser sobre cliques e passa a ser sobre agenda.
Se você não sabe hoje se o seu site envia eventos pelo servidor, se eles estão duplicados ou se algum dado de saúde está saindo junto, vale fazer essa revisão antes de aumentar a verba.
Quem escreveu
- Equipe RDG DevelopersTráfego, automação e sites
Leia também
- Tráfego e dadosPor que o pixel perde conversões e como resolver
- AutomaçãoAgendamento pelo WhatsApp com n8n e Evolution API
- Performance e sitesLCP de 4 segundos: como o servidor lento encarece o CPA
