Rastreamento de conversões WPForms no OpenAI Ads

Conecte envios do WPForms a eventos de conversão do OpenAI Ads com o PixelBridge. Rastreamento de leads planejado, consentimento, deduplicação e configuração. Em breve.

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

Os envios do WPForms devem se conectar ao OpenAI Ads como eventos de conversão depois que o WPForms confirmar que a entrada foi salva ou enviada. O evento padrão é lead_created. O PixelBridge foi pensado para mapear esse estado de sucesso sem um script personalizado na página de agradecimento. A integração não foi lançada.

Para que serve esta integração

O WPForms é usado para formulários de contato, orçamento, cadastros, pagamentos e formulários de várias páginas. A medição do OpenAI Ads só se importa com a ação concluída que você quer otimizar. Para a maioria dos formulários de marketing isso é um lead. Para um formulário que cria uma conta, registration_completed pode ser um encaixe melhor. Para um formulário que é de fato checkout, um caminho de compra como o WooCommerce costuma ser a integração certa.

PixelBridge é um plugin WordPress independente. Não é um produto oficial do WPForms nem da OpenAI. Listar o WPForms aqui significa que é um conector planejado, não um conector no ar.

Conectar envios ao evento certo

Mapeie a confirmação do WPForms, não a visualização do formulário.

Resultado do WPFormsEvento OpenAI Ads planejadoUse quando
Entrada de contato ou orçamento salvalead_createdA maioria dos formulários de marketing
Cadastro de usuário ou membershipregistration_completedO cadastro de conta ou de lista está confirmado
Formulário de agendamentoappointment_scheduledO agendamento existe, não só um pedido
Pagamento de produto por uma lojapurchasePrefira WooCommerce se esse for o sistema de pedidos

Se você não tiver certeza, comece com lead_created para formulários de solicitação bem-sucedidos. Confirme os nomes dos eventos na documentação do OpenAI Measurement Pixel antes de tratá-los como definitivos. Veja eventos de conversão.

Não dispare a conversão quando:

  • O formulário é exibido em um widget, popup ou bloco Gutenberg
  • Um formulário de várias páginas chega à página 2
  • O upload de arquivo começa
  • Pagamento ou campos obrigatórios falham
  • O WPForms mostra um erro

Páginas de confirmação versus o hook de sucesso

O WPForms pode mostrar uma mensagem, redirecionar para uma página ou ir para uma URL personalizada. Essas são escolhas de exibição. A conversão deve ser a entrada confirmada.

Uma confirmação por redirecionamento é uma fonte comum de medição duplicada ou vazia:

  • Se você mede só a página de agradecimento, perde o sucesso AJAX sem redirecionamento e conta visitas diretas a essa URL.
  • Se dispara no clique de envio e também na página de confirmação, você conta duas vezes.
  • Se um formulário de pagamento pode falhar depois do redirecionamento, a visualização de página não é uma conversão.

A integração planejada deve se conectar ao sucesso do WPForms no WordPress e depois, opcionalmente, enviar um evento correspondente no navegador. Visualizações de página da página de confirmação ainda podem ser page_viewed. Elas não substituem o lead.

Eventos no navegador, no servidor e deduplicação

Um evento no navegador precisa do pixel, do consentimento e de um único sucesso. Formulários conversacionais, popups e formulários incorporados do WPForms devem usar a mesma regra.

Um evento de servidor é útil quando a confirmação nunca é renderizada no navegador. O caminho da Conversions API está planejado e ainda não está disponível publicamente. Se os dois disparam, eles compartilham um ID de evento, o mesmo nome de evento e o mesmo Pixel ID. Veja Conversions API.

Não gere um ID de evento novo a cada atualização da página de confirmação. Guarde um ID por entrada do WPForms quando as duas camadas forem usadas.

Consentimento e campos

O WPForms pode coletar e-mail, telefone e texto da mensagem. A medição do OpenAI Ads não deve receber um evento de lead antes que o consentimento de medição necessário exista. Regras de hashing e correspondência no nível do campo pertencem à documentação oficial da OpenAI, não a um snippet personalizado de formulário. Veja consentimento.

O PixelBridge não deve contornar um plugin de consentimento só porque uma entrada do WPForms já armazenou um e-mail no WordPress. Armazenar uma entrada e enviar uma conversão publicitária são ações diferentes.

Configuração planejada

Quando o conector WPForms for lançado:

  1. Instale o PixelBridge quando estiver disponível publicamente. O plugin não foi lançado.
  2. Informe o Pixel ID do OpenAI Ads.
  3. Ative o rastreamento de conversões do WPForms.
  4. Escolha os formulários e o tipo de evento para cada formulário.
  5. Mantenha o consentimento ativo.
  6. Envie uma entrada de teste e confirme um evento no diagnóstico.

Até lá, não dependa de um bloco HTML na página de agradecimento do WPForms como configuração de longo prazo do OpenAI Ads. Ele vai divergir do modelo do plugin.

Resolução de problemas

  1. A integração nativa ainda está em breve.
  2. Confirme que o WPForms salvou a entrada ou mostrou a confirmação de sucesso.
  3. Confirme que o formulário selecionado é o que você enviou.
  4. Conceda o consentimento de medição.
  5. Verifique se uma confirmação por redirecionamento não está também disparando um segundo script personalizado.
  6. Veja a resolução de problemas para carregamento do pixel, cache e problemas de CSP.

Relacionado

Guias relacionados