Biblioteca·SOP·Analytics
Meça somente envios bem-sucedidos do Contact Form 7 com GTM4WP e Google Tag Manager, preservando a privacidade e testando tentativas inválidas e duplicidades.
Última revisão: · Revisão editorial
Clareza, estrutura e referências revisadas nesta versão. Não equivale a um teste em uma conta real.
Conte um envio bem-sucedido do Contact Form 7 como conversão de site no Google Ads usando o evento exclusivo de sucesso do GTM4WP na camada de dados. O método distingue sucesso de tentativas inválidas, spam e falhas na mesma página.
Este SOP abrange:
gtm4wp.contactForm7MailSent a um contêiner Web existenteNão abrange:
gtm4wp.contactForm7Submitted como leads concluídosO Contact Form 7 mantém o visitante na mesma página após o envio. O GTM4WP pode encaminhar seu evento específico de sucesso ao GTM, permitindo contar conclusões sem tratar cada clique em Enviar como lead.
Crie uma Nota de rastreamento do formulário, com os títulos Site e formulário, Google Ads, WordPress, Google Tag Manager, Preview, Live e Status no Ads. Em Site e formulário, registre a página em que aparece, o nome do formulário Contact Form 7, o ID numérico se exibido e o valor/moeda aprovados por lead concluído.
Ative a integração Contact Form 7 do GTM4WP e mantenha os valores preenchidos fora da camada de dados.
No WordPress, confirme que existe um contêiner Web GTM instalado e que é aquele que editará. Se outro plugin, como Site Kit, o instala, anote o ID GTM-. Se dois contêineres carregarem, pare e resolva a duplicidade primeiro.
No WordPress, abra Settings > Google Tag Manager e encontre as configurações de Contact Form 7. Se GTM4WP estiver instalado mas inativo, ative-o primeiro. Ative a integração. Em Submitted field values in the data layer, escolha None. Isso mantém nomes, e-mails, mensagens e demais valores preenchidos fora da camada de dados; ID e nome do formulário continuam disponíveis para o acionador.
Se Site Kit ou outro plugin já instala o contêiner, abra Google Tag Manager container do GTM4WP e defina Container code placement como Off. Preserve o carregador único existente. Off remove o código de contêiner do GTM4WP, mantendo a camada de dados ativa. Preserve o nome padrão dataLayer; não adicione outro ID para carregar.
Use o Preview para verificar sinais de falha e sucesso antes de criar o acionador.
No Google Tag Manager, selecione Preview, informe a URL registrada do formulário e selecione Connect. Volte ao Tag Assistant e aguarde o evento de página.
Na página conectada, deixe um campo obrigatório vazio e envie. Volte ao Tag Assistant e selecione gtm4wp.contactForm7InvalidInput na lista à esquerda. Esse é o sinal de tentativa inválida.
Envie um exemplo válido e aguarde a mensagem de sucesso. No Tag Assistant, selecione gtm4wp.contactForm7MailSent e abra Data Layer. Encontre formid e formname. Registre os dois em Site e formulário na nota.
Se o formulário não concluir ou gtm4wp.contactForm7MailSent não aparecer, encaminhe a URL e as mensagens de erro ao responsável pelo site. Peça que confira o envio e a ativação da integração GTM4WP. Repita após a correção e continue quando o evento aparecer. Não substitua por gtm4wp.contactForm7Submitted, que também aparece após tentativas sem sucesso.
Use formid numérico quando disponível. Se mostrar (not set), use formname. Nesse caso, confira Contact > Contact Forms no WordPress para garantir que nenhum outro formulário tenha o mesmo nome. Se tiver, peça um nome exclusivo ao responsável e repita a verificação do evento.
Informe ao Google Ads como contar esse lead concluído. Use valor fixo aprovado pela empresa; o formulário não envia receita de compras.
Crie no Google Ads uma conversão manual de site para o lead concluído do Contact Form 7.
Abra o Google Ads, acesse Goals > Conversions > Summary e selecione + Create conversion action. Escolha Conversions on a website. Em Edit data sources, informe o domínio e selecione Scan. Mantenha a origem de site selecionada e escolha Done, Save and continue ou o botão equivalente do fluxo atual.
Escolha Submit lead form. Selecione + Create conversion ou Create conversion e depois Manually using code, ou a opção equivalente de código manual. Isso cria a ação cujas tags serão configuradas no Tag Manager.
Selecione Done ou o botão que abre as configurações da ação selecionada.
Defina nome, função nos lances, valor fixo e regra de contagem antes de salvar.
Se necessário, selecione Edit settings e dê um nome claro à ação, como Contact Form 7 lead submitted. Defina Action optimization como Primary. Isso inclui leads concluídos no total principal de conversões e permite que campanhas que otimizam para esse objetivo os usem para ajustar lances. Use Primary somente após a confirmação do responsável de que o formulário representa um lead relevante para otimização.
Escolha Use the same value for each conversion e informe o valor e a moeda aprovados. Um valor fixo de lead é o mesmo montante atribuído a cada formulário concluído; é um valor de planejamento para relatórios e lances, não a receita real de cada lead.
Defina Count como One. Assim, o Google Ads conta no máximo uma conversão dessa ação após uma interação com anúncio, mesmo que a pessoa envie o formulário mais de uma vez a partir dela.
Mantenha a atribuição padrão, selecione Done e depois Save and continue.
Obtenha os identificadores correspondentes e registre a escolha de conversões otimizadas antes de ir ao Tag Manager.
No resumo da configuração, selecione Use Google Tag Manager. Se aparecer Set up in Google Tag Manager, abra o painel para ler os identificadores e continue com os passos manuais deste guia.
Copie o Conversion ID numérico e o Conversion label para Google Ads na nota. O ID identifica a conta; o rótulo identifica essa ação específica. Mantenha o par junto. Quando o Tag Manager pedir o ID da tag do Google, use AW- seguido do número. Quando a tag de conversão pedir Conversion ID, use o número sem AW-.
Confira se o Google Ads mostra Enhanced conversions ou User-provided data para a ação. Neste guia, deixe Off ou Not configured e registre o estado visível na nota. Se a configuração não aparecer, registre Not shown e continue. Esse recurso separado usa dados de clientes e exige configuração e revisão de políticas próprias.
Selecione Finish ou o botão que fecha o resumo. Mantenha a nota aberta para os próximos passos.
O GTM4WP envia o resultado do formulário à camada de dados. No GTM, o acionador de evento personalizado decide quando a tag Google Ads envia o lead concluído.
Verifique a cobertura existente da tag do Google antes de adicionar algo; reutilize uma tag correspondente em todo o site ou crie uma.
Abra o Google Tag Manager, selecione o contêiner Web instalado e abra Tags. Encontre tags do Google cujo Tag ID seja AW- seguido do Conversion ID da nota. Registre nome e acionador da tag correspondente em Google Tag Manager na nota.
Se uma tag correspondente ativada usar Initialization - All Pages, use-a. Se o acionador for diferente ou houver mais de uma correspondência ativada, peça ao responsável que mantenha uma tag correspondente com Initialization - All Pages antes de continuar. Isso evita adicionar uma segunda tag para a mesma conta Google Ads.
Se nenhuma tag correspondente estiver ativada, selecione New, escolha Google tag, informe AW- seguido do Conversion ID numérico, defina Triggering como Initialization - All Pages e salve com um nome claro, como Google tag — Google Ads. Initialization - All Pages carrega a tag base no início de cada página, cobrindo todo o site.
Abra a tag escolhida e registre nome, ID e acionador em Google Tag Manager na nota.
Verifique a cobertura de dados de clique do contêiner e mantenha um caminho válido para vincular o clique no anúncio à conversão posterior.
Em Tags, encontre as tags Conversion Linker ativadas. A tag do Google carrega a base de mensuração do Ads; o Conversion Linker armazena informações de clique presentes na URL de destino para vincular o clique a um lead posterior. A orientação atual do Google dispensa um linker separado quando a tag do Google carrega em todas as páginas; confira a cobertura existente primeiro.
Se um Conversion Linker ativado já disparar em All Pages, reutilize-o e registre Linker existente reutilizado na nota.
Se não houver linker em todas as páginas, abra Workspace > Overview no GTM e encontre Container quality. Selecione View [number] issues; quando o cartão indicar Good, selecione View recommendations. Se a lista indicar ausência de Conversion Linker, crie um no próximo subpasso. Se não indicar e a tag do Google usar Initialization - All Pages, registre A tag do Google cobre todas as páginas; linker separado não necessário na nota.
Se o diagnóstico indicar falta de linker, selecione New, escolha Conversion Linker, use All Pages e salve com um nome claro, como Conversion Linker — All Pages. Registre Linker adicionado na nota.
Crie um acionador que corresponda ao evento de sucesso deste único formulário Contact Form 7.
Se o teste anterior mostrou formid numérico, abra Variables e selecione New em User-Defined Variables. Escolha Data Layer Variable, nomeie DLV — Contact Form 7 form ID, defina Data Layer Variable Name como formid e Data Layer Version como Version 2. Salve. Se formid mostrou (not set), pule este subpasso e use a variável de nome abaixo.
Se o ID estava (not set) no teste, crie DLV — Contact Form 7 form name como Data Layer Variable, com Data Layer Variable Name igual a formname e Data Layer Version igual a Version 2. Salve. Se registrou ID numérico, pule: a variável de ID basta.
Em Triggers, selecione New, escolha Custom Event e defina Event name como gtm4wp.contactForm7MailSent. Escolha Some Custom Events. Se a nota contém formid numérico, adicione DLV — Contact Form 7 form ID equals esse número. Se está (not set), adicione DLV — Contact Form 7 form name equals o nome exclusivo exato registrado. Salve como CF7 success — [nome do formulário], ou outro nome claro.
gtm4wp.contactForm7Submitted: ele também dispara para dados inválidos, spam e falhas. Sem ID e com nome compartilhado, pare até ser possível identificar o formulário pretendido.Crie ou reutilize uma tag Google Ads Conversion Tracking com os IDs, valor fixo aprovado, moeda e acionador de sucesso do Contact Form 7 correspondentes.
Procure tags Google Ads Conversion Tracking ativadas no contêiner. Compare Conversion ID numérico, Conversion label e acionador de cada candidata com a nota. Reutilize uma correspondência exata somente se ela usar o acionador de sucesso do Contact Form 7. Duas tags ativadas se sobrepõem quando usam o mesmo ID e rótulo e podem disparar no mesmo evento de sucesso do Contact Form 7. IDs ou rótulos diferentes podem representar ações diferentes; antes de adicionar outra tag com o mesmo ID e rótulo, pergunte ao responsável qual manter.
Se não houver uma correspondência exata ativada, selecione New, escolha Google Ads Conversion Tracking e informe o Conversion ID numérico e o Conversion label correspondentes da nota. Informe o mesmo valor fixo e moeda usados no Google Ads e selecione o acionador de sucesso do Contact Form 7. Deixe Transaction ID vazio, pois IDs de transação estão fora desta configuração de formulário.
Salve com um nome claro, como Google Ads conversion — Contact Form 7 lead submitted. Reabra a tag e registre nome, identificadores, valor, moeda e acionador em Google Tag Manager na nota. Volte a Workspace > Overview e repita a verificação de Container quality: selecione View [number] issues ou View recommendations quando aparecer Good. Registre o resultado atual na nota.
Repita o teste de sucesso com consentimento aceito e recusado e compare tags e requisições com a implementação aprovada. Registre ambos. Não force Granted nem contorne o banner para fazer o teste passar.
O Preview deve mostrar que a tentativa inválida é ignorada e que um envio bem-sucedido dispara a conversão uma vez. Publique o contêiner testado, confira o mesmo comportamento em Live e leia o status Ads separadamente.
Use Preview para confirmar que uma tentativa inválida não envia a conversão Google Ads.
Na aba conectada, deixe um campo obrigatório vazio e envie. Volte ao Tag Assistant e selecione gtm4wp.contactForm7InvalidInput.
Confirme que a tag de conversão não disparou no evento inválido. Registre Tentativa inválida: nenhuma tag de conversão disparou na nota.
Use Preview para confirmar exatamente um disparo após um envio bem-sucedido.
Envie uma vez com dados fictícios seguros, como Alex Example e uma caixa de e-mail que controla, se exigida. Não use dados de clientes. Aguarde a mensagem de sucesso do Contact Form 7 e volte ao Tag Assistant.
Abra gtm4wp.contactForm7MailSent. Confirme que a tag pretendida disparou uma vez e que Conversion ID numérico e Conversion label correspondem à nota. Abra o evento seguinte gtm4wp.contactForm7Submitted e confirme que não houve segundo disparo. Registre ambos em Preview.
Publique o contêiner testado. A verificação Live confirma que o site continua enviando o evento; o status Ads é uma verificação separada e pode aguardar uma interação atribuída a anúncio.
Publique a versão testada e registre qual entrou em produção.
Volte ao GTM, revise as alterações do workspace e selecione Submit. Escolha Publish and Create Version, informe nome e descrição claros e selecione Publish.
Abra a confirmação ou histórico. Registre nome/número da versão e ID do contêiner na nota. Confirme que não há alterações pendentes antes do teste Live.
Repita as verificações de carregamento e de envio no contêiner publicado.
Inicie nova sessão do Tag Assistant com a URL registrada em Site e formulário. Se houver seletor de ambiente/versão, escolha Live publicado com nome/número e ID iguais à nota. Confirme que a sessão visível identifica o contêiner publicado antes de testar.
Antes do envio, abra o primeiro evento Live. Confirme o disparo da tag do Google correspondente, siga a decisão de linker registrada e confirme que a tag de lead não disparou.
Antes do teste positivo, envie o formulário uma vez com campo obrigatório inválido. Abra gtm4wp.contactForm7InvalidInput e confirme ausência de disparo da conversão. Registre Live inválido: nenhuma tag de conversão disparou na nota.
Na aba conectada, envie uma vez um exemplo seguro, aguarde sucesso e volte ao Tag Assistant. Confirme um disparo em gtm4wp.contactForm7MailSent com Conversion ID e rótulo registrados. Abra o evento seguinte gtm4wp.contactForm7Submitted e confirme ausência de segundo disparo. Registre resultados Live de carregamento, tentativa inválida, envio bem-sucedido e ausência de duplicidade.
Leia status e mensagem da ação no Google Ads e registre seu significado.
Volte a Google Ads > Goals > Conversions > Summary, encontre a ação Contact Form 7 e abra os detalhes. Registre status visível e mensagem na nota.
Se aparecer No recent conversions ou Awaiting conversions, registre em Status no Ads com a mensagem. Se o Google informar espera, adicione uma data de nova consulta, por exemplo dois dias a partir de hoje para uma mensagem de 48 horas. Trata-se de conferência posterior de relatório. O Tag Assistant confirma envio do sinal pelo site, não que um anúncio real gerou um lead.
Para Needs attention ou Misconfigured, abra os detalhes e leia o problema. Siga a correção sugerida quando clara; caso contrário, entregue a mensagem ao responsável pelo Ads antes de depender da ação.