Rastrear leads do Contact Form 7 com OpenAI Ads

Rastreie leads confirmados do Contact Form 7 como eventos de conversão do OpenAI Ads sem JavaScript personalizado quando a integração do PixelBridge for lançada. Em breve.

Última atualização: 8 de setembro de 2026. Escrito por PixelBridge team.

Envios confirmados do Contact Form 7 devem ser rastreados como eventos de lead do OpenAI Ads depois que o formulário reportar um envio bem-sucedido, não quando a página carrega ou quando o botão de envio é clicado. Quando a integração do PixelBridge for lançada, esse mapeamento deve funcionar sem JavaScript personalizado. O conector ainda não está disponível.

Para que serve esta integração

Contact Form 7 é um formulário de lead comum no WordPress. Uma conversão típica é uma mensagem que foi aceita e enviada por e-mail ou armazenada, com a resposta de sucesso do plugin mostrada ao visitante.

A medição do OpenAI Ads deve registrar esse sucesso como lead_created. O PixelBridge foi pensado para escutar o caminho de sucesso documentado do plugin, em vez de pedir que você cole um snippet on_sent_ok ou um script no rodapé do tema. Esse hook nativo é o ponto da integração. Ele ainda não foi lançado.

O PixelBridge é independente da OpenAI e do Contact Form 7. Ele não substitui os recursos de e-mail, spam ou configurações adicionais do Contact Form 7. Configure o formulário no Contact Form 7 primeiro e depois planeje a medição por cima.

Leads confirmados versus cliques no botão

O Contact Form 7 valida no servidor e devolve uma resposta à página. O visitante pode ver uma mensagem de sucesso, um erro ou uma falha de spam. Só a resposta de sucesso é um lead.

Não trate estes como conversões:

  • Abrir a página de contato
  • Preencher um campo
  • Clicar em Enviar
  • Uma classe wpcf7-mail-sent-ok que você adiciona você mesmo antes da requisição terminar
  • Uma resposta 200 que ainda contém um erro de validação

Se você usa um redirecionamento para uma página de agradecimento, a conversão continua sendo o envio bem-sucedido. Medir só a URL de agradecimento também conta pessoas que salvam essa página nos favoritos.

Veja eventos de conversão.

Por que a integração deve remover JavaScript personalizado

Muitos sites com Contact Form 7 já têm snippets de rastreamento sobrando: configurações extras antigas de on_sent_ok, eventos do Google Ads ou Meta no tema, ou uma regra de tag manager em .wpcf7-mail-sent-ok. Esses snippets envelhecem, disparam duas vezes ou disparam na resposta errada.

O conector planejado do PixelBridge deve:

  1. Detectar que o Contact Form 7 está ativo.
  2. Ligar-se a um evento de sucesso confirmado.
  3. Enviar lead_created pelo OpenAI Ads Pixel quando o consentimento permitir.
  4. Opcionalmente enviar a mesma conversão pela Conversions API com um ID de evento compartilhado.

Você não deve precisar de um script personalizado em Additional Settings para o OpenAI Ads quando isso for lançado. Até lá, JavaScript extra não é o caminho suportado do produto.

Eventos no navegador e no servidor

O evento no navegador pertence depois da resposta de sucesso. O Contact Form 7 é baseado em AJAX na maioria dos temas, então pode não haver um recarregamento completo da página. Um script que só roda em DOMContentLoaded vai perder o lead ou disparar cedo demais.

Um evento de servidor ainda pode registrar o lead depois que o WordPress aceitou o envio, o que ajuda quando o pixel é bloqueado. Os dois eventos precisam do mesmo ID de evento. Veja Conversions API. A conexão no servidor é funcionalidade Pro planejada e não foi lançada.

Consentimento, spam e duplicatas

O consentimento de medição precisa ser concedido antes que um lead do Contact Form 7 seja enviado ao OpenAI Ads. O formulário ainda pode ser enviado. O evento publicitário deve esperar. Veja consentimento.

Spam e e-mail que falhou não devem virar leads. Se o Contact Form 7 marcar a mensagem como spam ou não conseguir enviar o e-mail, não há lead confirmado para medir.

Um envio equivale a um evento. Novas tentativas depois de um erro de rede não devem criar duas conversões para a mesma mensagem bem-sucedida. Um segundo envio genuíno da mesma pessoa pode ser um segundo lead se o seu negócio tratar assim. Não faça debounce de todos os envios de um IP como substituto de um ID de evento real.

Configuração planejada

Quando a integração estiver disponível:

  1. Instale o PixelBridge quando o plugin público existir. Ele ainda não foi lançado.
  2. Adicione o Pixel ID do OpenAI Ads.
  3. Ative o rastreamento de leads do Contact Form 7.
  4. Selecione os formulários que devem contar, se existir mais de um formulário.
  5. Envie uma mensagem de teste e confirme um único evento lead_created no diagnóstico.

Até o lançamento, entre no acesso antecipado pela página inicial. Não copie zips não oficiais do plugin.

Resolução de problemas

  1. A integração ainda está marcada como em breve, então o rastreamento nativo não vai rodar.
  2. Confirme que o Contact Form 7 mostra a mensagem de sucesso, não um erro de validação.
  3. Confirme que o e-mail realmente envia se a sua definição de lead exigir a entrega do e-mail.
  4. Conceda o consentimento de medição.
  5. Remova snippets personalizados de rastreamento do CF7 antes de testar um hook nativo futuro, ou você pode ver duplicatas depois.
  6. Veja a resolução de problemas se o pixel nunca carregar.

Relacionado

Guias relacionados