Medir el éxito del formulario en vez de los clics en el botón

Hacer clic en un botón de envío, enviar un formulario y completar su procesamiento son eventos distintos. Un clic puede ir seguido de un error de validación, una solicitud fallida o un rechazo del servidor. Stats4U ofrece categorías de contacto automáticas, envíos marcados y eventos explícitos de éxito de formulario; la elección determina lo que realmente significa el informe.

Activar solo las mediciones necesarias

1. Abrir el contador propio a través de Mis contadores y abrir después Panel y herramientas y Acciones de contacto.
2. En Configuración de las mediciones, activar Contar automáticamente los clics en teléfono, correo electrónico y descargas para esas categorías de clics, o Contar los envíos de formularios marcados y los éxitos confirmados de los formularios para los envíos marcados y los éxitos confirmados.
3. Seleccionar Guardar y verificar que el sitio web utiliza la integración de JavaScript generada.

Las categorías de contacto automáticas utilizan nombres de acción como contact-email, contact-phone y download. Describen un clic, no un correo entregado, una llamada atendida o una descarga completada. El evento no envía la dirección, el número de teléfono ni el contenido de los campos del formulario.

Marcar el envío de un formulario

Añadir al elemento del formulario un nombre estable que no contenga datos personales. El nombre debe describir su finalidad en vez de identificar a un visitante. Este ejemplo marca un formulario de contacto:

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

El marcador produce form-submitted-contact cuando el navegador envía el formulario. No demuestra que el servidor lo haya aceptado o procesado. Conservar el código existente de validación y procesamiento del formulario; añadir un marcador de medición no implementa la gestión del formulario.

Confirmar el éxito en el punto real de éxito

Para un formulario personalizado, llamar a la función de éxito solo después de que la aplicación haya confirmado el procesamiento correcto. La llegada de una respuesta HTTP, un clic en un botón o la resolución de una promesa fetch no bastan por sí solos: la aplicación debe interpretar su propia respuesta del servidor y su estado de error.

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

Esta llamada produce form-success-contact cuando la medición de formularios está activada y el rastreador está disponible. Colocarla en la rama existente de éxito confirmado, no antes de la solicitud ni en un manejador de finalización incondicional. Contact Form 7 puede utilizar su integración compatible del evento de correo enviado correctamente; un formulario genérico necesita una señal explícita de éxito de la aplicación.

Comprobar tanto el éxito como el fallo

1. En una instalación de prueba propia, probar un envío válido y otro que la aplicación rechace. Solo el éxito confirmado debe enviar el evento de éxito.
2. Utilizar Depurador de mediciones para comprobar si se aceptarían la categoría y el nombre de evento esperados, sin contar un evento real.
3. Comparar los nombres de evento resultantes en el informe. Un recuento de envíos superior al de éxitos puede ser una señal útil, pero no demuestra un error concreto.

El depurador comprueba la admisibilidad, no la entrega correcta de un formulario real. Examinar por separado la respuesta de la aplicación y las solicitudes normales del rastreador. Mantener los nombres y los contenidos de formularios fuera de las etiquetas de evento y las propiedades de diagnóstico.

Siguiente paso

Consultar la guía de integración antes de añadir la llamada de éxito a la aplicación.

Abrir la guía de instalación