Medir o sucesso do formulário em vez dos cliques no botão

Clicar num botão de envio, submeter um formulário e concluir o seu processamento são eventos diferentes. Um clique pode ser seguido por um erro de validação, um pedido falhado ou uma rejeição do servidor. O Stats4U disponibiliza categorias de contacto automáticas, submissões marcadas e eventos explícitos de sucesso do formulário; a escolha determina o que o relatório realmente significa.

Ativar apenas as medições necessárias

1. Abrir o contador próprio através de Os meus contadores e abrir depois Painel e ferramentas e Ações de contacto.
2. Em Definições de medição, ativar Contar automaticamente os cliques em telefone, e-mail e transferências para essas categorias de cliques ou Contar os envios de formulários marcados e os resultados bem-sucedidos confirmados dos formulários para submissões marcadas e sucessos confirmados.
3. Escolher Guardar e verificar se o sítio Web utiliza a integração JavaScript gerada.

As categorias de contacto automáticas utilizam nomes de ação como contact-email, contact-phone e download. Descrevem um clique, não um email entregue, uma chamada atendida ou uma transferência concluída. O evento não envia o endereço, o número de telefone nem o conteúdo dos campos do formulário.

Marcar uma submissão de formulário

Acrescentar ao elemento do formulário um nome estável que não contenha dados pessoais. O nome deve descrever a finalidade, em vez de identificar um visitante. Este exemplo marca um formulário de contacto:

<form data-s4u-form="contact">
  <!-- Existing form controls and submission handling -->
</form>

O marcador produz form-submitted-contact quando o navegador submete o formulário. Não prova que o servidor o aceitou ou processou. Manter o código de validação e processamento existente no formulário; acrescentar um marcador de medição não implementa o tratamento do formulário.

Confirmar o sucesso no ponto em que realmente ocorre

Num formulário personalizado, chamar a função de sucesso apenas depois de a aplicação confirmar o processamento bem-sucedido. A chegada de uma resposta HTTP, um clique num botão ou a resolução de uma promessa fetch não são suficientes por si só: a aplicação tem de interpretar a sua própria resposta do servidor e o estado de erro.

if (window.s4u && typeof window.s4u.formSuccess === 'function') {
  window.s4u.formSuccess('contact');
}

Esta chamada produz form-success-contact quando a medição de formulários está ativada e o rastreador está disponível. Colocá-la no ramo existente de sucesso confirmado, não antes do pedido nem num tratamento de conclusão incondicional. O Contact Form 7 pode utilizar a integração suportada do evento de envio de email bem-sucedido; um formulário genérico exige um sinal explícito de sucesso da aplicação.

Verificar tanto o sucesso como a falha

1. Numa instalação de teste própria, experimentar uma submissão válida e uma submissão rejeitada pela aplicação. Apenas o sucesso confirmado deve enviar o evento de sucesso.
2. Utilizar Depurador de medições para verificar se a categoria e o nome de evento esperados seriam aceites, sem contar um evento real.
3. Comparar os nomes dos eventos resultantes no relatório. Uma contagem de submissões maior do que a de sucessos pode ser um sinal útil, mas não prova um erro específico.

O depurador verifica a admissibilidade, não a entrega bem-sucedida de um formulário real. Inspecionar separadamente a resposta da aplicação e os pedidos normais do rastreador. Manter nomes e conteúdos de formulários fora das etiquetas de eventos e das propriedades de diagnóstico.

Próximo passo

Consultar o guia de integração antes de acrescentar a chamada de sucesso à aplicação.

Abrir o guia de instalação