Biblioteca·SOP·Analytics
Conte apenas os envios bem-sucedidos do formulário escolhido como leads, sem transmitir o conteúdo digitado pelos visitantes.
Ú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.
Use o Google Analytics 4 (GA4) para contar uma resposta bem-sucedida do Contact Form 7 como lead. O plugin WordPress GTM4WP envia ao Google Tag Manager uma pequena mensagem sobre o resultado e o ID do formulário; mantenha fora dela o que os visitantes digitaram.
Este SOP abrange:
Não abrange:
O GTM4WP insere uma pequena mensagem sobre o resultado do formulário no data layer da página, uma mensagem de bastidores que o GTM consegue ler. Este guia usa a mensagem de envio bem-sucedido para o lead, sem os valores digitados.
Crie a nota Rastreamento Contact Form 7 no GA4, com os títulos Formulário e página, Tag Manager, Verificações Preview e Verificação Live. Guarde nela os dados do site, contêiner e fluxo.
Crie ou abra a nota e adicione os quatro títulos. Em Formulário e página, registre nome do formulário e endereço completo da página. Deixe o ID numérico em branco até o passo 2.1.
Abra o Google Analytics, selecione a propriedade, acesse Admin > Data streams e escolha o fluxo Web do site. Confira o endereço e copie o Measurement ID completo, iniciado por G-, para Tag Manager na nota.
Abra o Google Tag Manager e selecione a conta e o contêiner Web existente no site. Copie seu ID GTM- para Tag Manager na nota. Na página do formulário, confirme pelo Tag Assistant a detecção do mesmo ID. Se forem diferentes ou não conseguir identificar o contêiner carregado, pergunte ao mantenedor antes de editar ou publicar.
Ative a mensagem de data layer do Contact Form 7 no GTM4WP, mantendo fora dela os valores digitados.
No WordPress, abra Plugins > Installed Plugins e localize Google Tag Manager for WordPress (GTM4WP). Se estiver Inactive, selecione Activate; só então Settings > Google Tag Manager ficará disponível. Se não estiver listado, peça ao administrador que o instale antes de continuar.
Antes de alterar Container code placement, confirme qual ferramenta WordPress adiciona o contêiner GTM- detectado. Verifique plugins ativos ou configurações de Site Kit, GTM4WP ou snippet de cabeçalho/rodapé. Se não conseguir confirmar quem adiciona esse ID exato, pergunte ao mantenedor; não desligue um carregador que pode ser o único.
Abra Settings > Google Tag Manager > Contact Form 7. Ative a integração Contact Form 7. Defina Submitted field values in the data layer como None e deixe Also push GA4 recommended events desligado. Este guia envia sua própria tag filtrada generate_lead; ambas as fontes ativas podem contar o mesmo envio duas vezes. Salve.
Mantenha exatamente uma ferramenta carregando o contêiner conectado. Se Site Kit ou outra ferramenta confirmada já adiciona o mesmo contêiner, defina Container code placement do GTM4WP como Off – container code turned off, data layer only. Se GTM4WP for o único carregador, mantenha a inclusão ativada e confira o ID com a nota. Não adicione outro carregador.
Nas configurações Google Tag Manager do GTM4WP, deixe Advanced data layer variable name vazio para usar dataLayer. Se o site usar nome personalizado, pergunte ao mantenedor antes de mudá-lo.
Inspecione também as regras Custom events do fluxo GA4 antes de criar a tag. Uma regra que deriva generate_lead da página de agradecimento pode se sobrepor à tag de sucesso do formulário. Registre o remetente escolhido e desative uma regra sobreposta apenas com aprovação do responsável pela mensuração. Marcar generate_lead como principal vale para todos os eventos desse nome na propriedade, inclusive de outros formulários; liste-os na entrega.
Use a mensagem específica que segue o envio bem-sucedido. A mensagem genérica de envio também ocorre em tentativas malsucedidas; por isso, combine a mensagem de sucesso com o ID escolhido.
No WordPress, abra Contact > Contact Forms, localize o formulário da página registrada e selecione Edit. Na barra de endereço do editor, copie os dígitos após post= (por exemplo, post=274) para Formulário e página. Use esses dígitos como ID; o shortcode pode mostrar outro hash.
formid corresponde ao ID do formulário.)Crie um acionador GTM que corresponda ao evento de envio bem-sucedido e ao ID do formulário.
Em Variables > User-Defined Variables, selecione New > Data Layer Variable. Em Data Layer Variable Name, digite formid, mantenha a versão padrão do data layer e nomeie a variável DLV - formid. Salve.
Em Triggers, crie um acionador Custom Event. Use gtm4wp.contactForm7MailSent em Event name. Selecione Some Custom Events e a condição DLV - formid equals o ID numérico da nota. Salve com nome identificável, como CF7 - successful send - [form name].
Antes de adicionar a tag, abra as tags Google Analytics: GA4 Event existentes no contêiner. Verifique Event Name e Measurement ID, procurando generate_lead enviado ao fluxo G- da nota. Em Plugins > Installed Plugins, veja se outro plugin de formulário ou Analytics envia eventos GA4. Se houver outra fonte possível, pergunte ao mantenedor: “Qual fonte única deve enviar generate_lead para este formulário?”. Mantenha uma fonte para evitar duplicidade.
Crie uma tag Google Analytics: GA4 Event para o envio bem-sucedido do formulário escolhido.
G- da nota, defina Event Name como generate_lead e adicione o parâmetro form_id. Para o valor, abra o seletor de variáveis e escolha DLV - formid; não digite seu nome como texto simples. Selecione o acionador de sucesso e salve.No Google Analytics, abra Admin > Data display > Events. Um evento principal é uma ação destacada como importante nos relatórios. A configuração vale para o nome generate_lead; o acionador GTM continua limitando esta tag ao formulário escolhido.
Em Recent events, encontre generate_lead. Se a estrela estiver desligada, clique para marcá-lo como principal. Em Key events, abra Action menu > Change counting method, escolha Once per event e salve se houver mudança. Depois, Action menu > Set default key event value > Don’t set a default key event value; salve se mudar. Se as opções já estiverem selecionadas, mantenha-as.
Somente se generate_lead não aparecer em Recent events, escolha + Create event, insira generate_lead, ative Mark as key event, selecione Once per event e Don’t set a default key event value, depois Create with code e crie. Isso registra o evento enviado pela tag GTM; não crie regra de page-view nem segunda fonte.
Use Preview primeiro para distinguir falhas de sucesso. Publique somente quando o formulário enviar o evento GA4 uma vez por sucesso e nenhuma em tentativa malsucedida.
No Preview do GTM, teste uma tentativa malsucedida e um envio bem-sucedido.
No workspace, selecione Preview, informe a página da nota e conecte Tag Assistant. Deixe um campo obrigatório vazio e selecione Submit. No Tag Assistant, escolha gtm4wp.contactForm7InvalidInput e confirme que a tag generate_lead não disparou.
Faça um envio válido com seus dados de teste. No Tag Assistant, escolha gtm4wp.contactForm7MailSent; confira DLV - formid e confirme um único disparo da tag GA4. Se surgir em seguida gtm4wp.contactForm7Submitted, confirme que não houve novo disparo.
No GTM, revise as alterações e selecione Submit > Publish and Create Version. Adicione nome e descrição curta para o evento Contact Form 7, revise a lista de alterações e publique a versão testada.
Após publicar e aplicar a configuração de evento principal, faça novo envio válido e confira recebimento Live no Tag Assistant e GA4 Realtime.
Se acabou de marcar generate_lead, o Google informa que a aplicação pode levar minutos a horas. Confira Admin > Data display > Events > Key events até ficar ativo. Então faça novo envio; recarregar um resultado anterior não envia novo evento.
Na janela conectada do Tag Assistant, abra detalhes do contêiner e Change container environment or version. Escolha Environment ID 1 / Live e seu link Debug. Quando informar atualização para depuração, selecione Reload page. Antes do teste, confirme Container Version Live no ID GTM- da nota.
Envie novamente o formulário com dados sob seu controle. No Tag Assistant, confirme um disparo GA4 em gtm4wp.contactForm7MailSent. No Analytics, Reports > Realtime, procure o novo generate_lead em Event count by Event name. Abra os detalhes e confira form_id com o ID numérico. Veja o evento novo também em Key events by Event name.
Registre data do teste, novo generate_lead, form_id correspondente, estado de evento principal e versão Live do GTM em Verificação Live. Se Realtime recebe o evento, mas o cartão de principal ainda não atualizou, espere aplicar e faça outro envio válido novo. Se o evento não aparecer, peça ao mantenedor revisão do contêiner, ID do fluxo e acionador.