Meta Pixel e Conversions API (Facebook/Instagram)

Integre o Meta Pixel para rastrear conversões e otimizar suas campanhas. Com a Conversions API (CAPI) ativada, suas conversões também são enviadas direto do servidor do FormGuru para a Meta, recuperando eventos que o navegador bloqueia.

O que é o Meta Pixel?

O Meta Pixel é um código de rastreamento do Facebook/Instagram que permite:

• Medir conversões de anúncios
• Criar públicos personalizados
• Otimizar campanhas automaticamente
• Fazer remarketing para quem interagiu com seus formulários

O que é a Conversions API (CAPI)?

A Conversions API é o rastreamento server-side da Meta: em vez de depender só do navegador do visitante, o servidor do FormGuru envia o evento de conversão diretamente para a Meta.

Por que isso importa:

• Sem CAPI, 30-50% das conversões podem se perder: iOS 14.5+, AdBlock e bloqueadores de rastreamento (ITP) impedem o pixel do navegador de disparar
• Melhor match rate: o evento vai com email e telefone do lead (hasheados), o que ajuda a Meta a atribuir a conversão à pessoa certa e melhora a otimização das campanhas
• Sem contagem duplicada: o FormGuru envia o mesmo event_id no pixel do navegador e na CAPI, e a Meta deduplica automaticamente

Privacidade e LGPD

• Email e telefone são hasheados com SHA-256 antes de sair do servidor, seguindo o padrão de advanced matching da Meta
• O envio segue a sua configuração de tracking: com Pixel + token CAPI salvos, o evento Lead vai para a Meta em todo envio do formulário. Como controlador dos dados, você é responsável pela base legal desse tratamento
• Para dar ao respondente a opção de recusar, adicione um bloco Legal marcado como "consentimento de marketing": se ele desmarcar esse bloco, email e telefone não são enviados. O aceite fica salvo como comprovante. O editor avisa quando você configurou Pixel/CAPI sem esse bloco

Disponibilidade

Esta integração está disponível nos planos Pro e Premium.

Configurando

Passo 1: Obter o ID do Pixel

1. Acesse o Meta Business Suite
2. Vá em Gerenciador de Eventos
3. Selecione seu Pixel
4. Copie o ID do Pixel (número de 15-16 dígitos)

Passo 2: Configurar no FormGuru

1. Abra seu formulário no editor
2. Clique em Configurações (ícone de engrenagem)
3. Vá na aba Integrações
4. Cole o ID do Pixel no campo "Pixel ID"
5. Clique em Salvar

Passo 3: Ativar a Conversions API (recomendado)

1. No Gerenciador de Eventos, selecione seu Pixel
2. Vá em Configurações e role até a seção Conversions API
3. Clique em Gerar token de acesso (o token começa com "EAA...")
4. No FormGuru, cole o token no campo Access Token CAPI, que aparece logo abaixo do Pixel ID
5. Clique em Salvar

O token fica oculto no painel (como uma senha) e é usado apenas pelo servidor do FormGuru.

Passo 4: Oferecer a opção de recusa (recomendado)

1. Adicione um bloco Legal ao seu formulário (ex: "Aceito receber comunicações e ofertas")
2. Nas propriedades do bloco, marque a opção de consentimento de marketing
3. Se o respondente desmarcar esse bloco, o Lead sai apenas pelo pixel do navegador, sem email/telefone e sem CAPI. Sem o bloco, ou com ele aceito, o envio segue a configuração dos passos anteriores. O aceite fica salvo junto com a resposta e pode ser exportado como comprovante LGPD

Eventos disparados automaticamente

O FormGuru dispara 5 eventos para rastreamento completo do funil:

Com a CAPI configurada, o evento Lead também é enviado server-side, com email/telefone hasheados, IP, user agent e os parâmetros UTM da visita. Os demais eventos continuam saindo pelo pixel do navegador.

Ponto de Conversão Personalizado

Você pode marcar perguntas específicas como "Ponto de Conversão" para disparar o evento FormGuruConversion quando o usuário responder aquela pergunta.

Como configurar:

1. No editor, selecione a pergunta desejada
2. No painel de propriedades (direita), ative "Ponto de Conversão"
3. Quando o usuário responder essa pergunta, o evento será disparado

Casos de uso:

• Marcar "Deseja receber orçamento?" como conversão
• Rastrear quando o usuário chega em uma pergunta específica do funil
• Criar audiências segmentadas no Meta Ads

Criando conversões personalizadas no Meta

1. Acesse o Gerenciador de Eventos
2. Vá em Conversões personalizadas
3. Crie uma conversão com:
   • Evento: FormGuruConversion
   • Regra: question_index = 5 (ou o número desejado)
4. Use essa conversão para otimizar campanhas

Testando a integração

Usando o Código de Teste

1. No Meta Business Suite, vá em Gerenciador de Eventos → Testar eventos e copie o código de teste (ex: TEST12345)
2. Confirme que o Pixel ID e o Access Token CAPI foram salvos no formulário
3. No FormGuru, cole no campo Código de Teste e clique em Testar eventos
4. O FormGuru envia uma suíte completa (PageView, StartForm, SubmitAnswer, Conversion e Lead) e ela aparece com origem Servidor na tela "Testar eventos"
5. O código é temporário e não é salvo nem enviado nas submissões reais

Esse botão valida as credenciais e a recepção da suíte pela CAPI. Para validar os disparos reais enquanto alguém preenche o formulário, use o Meta Pixel Helper no próprio formulário.

Usando o Meta Pixel Helper

1. Instale a extensão Meta Pixel Helper no Chrome
2. Acesse seu formulário
3. Interaja com o formulário e verifique os eventos:
   • PageView ao carregar
   • StartForm ao clicar em "Começar"
   • SubmitAnswer ao responder cada pergunta
   • Lead ao finalizar

Observação: o Pixel Helper só enxerga os eventos do navegador. Para conferir os eventos da CAPI, use a tela "Testar eventos" do Gerenciador de Eventos, que mostra a origem de cada evento (Navegador ou Servidor).

Conferindo a deduplicação

No Gerenciador de Eventos, abra o evento Lead: com Pixel + CAPI ativos, ele deve aparecer com as duas origens (Navegador e Servidor) e ser contado uma única vez, graças ao event_id compartilhado.

Dicas

• Configure o Pixel antes de lançar campanhas
• Ative a CAPI: com iOS 14.5+ e AdBlock, só o pixel do navegador deixa conversão na mesa
• Considere o bloco Legal de consentimento de marketing: ele dá ao respondente a opção de recusar e registra o aceite como comprovante LGPD
• Use StartForm para remarketing de abandonos
• Use SubmitAnswer para analisar onde usuários desistem
• Use FormGuruConversion para conversões de meio de funil
• Combine com UTM parameters para melhor atribuição: com CAPI, os UTMs vão junto com o evento server-side