Mesurer la réussite du formulaire plutôt que les clics sur le bouton

Cliquer sur un bouton d'envoi, envoyer un formulaire et terminer son traitement sont des événements différents. Un clic peut être suivi d'une erreur de validation, d'une requête échouée ou d'un refus du serveur. Stats4U propose des catégories de contact automatiques, des envois marqués et des événements explicites de réussite du formulaire ; le choix détermine la signification réelle du rapport.

Activer uniquement les mesures nécessaires

1. Ouvrir le compteur détenu par Mes compteurs, puis ouvrir Tableau de bord et outils et Actions de contact.
2. Dans Paramètres de mesure, activer Compter automatiquement les clics sur les liens de téléphone, d’e-mail et de téléchargement pour ces catégories de clics, ou Compter les envois de formulaires marqués et les réussites de formulaires confirmées pour les envois marqués et les réussites confirmées.
3. Choisir Enregistrer et vérifier que le site utilise l'intégration JavaScript générée.

Les catégories de contact automatiques utilisent des noms d'action comme contact-email, contact-phone et download. Elles décrivent un clic, pas un courriel livré, un appel décroché ou un téléchargement terminé. L'événement ne transmet ni l'adresse, ni le numéro de téléphone, ni le contenu des champs du formulaire.

Marquer l'envoi d'un formulaire

Ajouter au formulaire un nom stable et non personnel. Le nom doit décrire sa fonction plutôt qu'identifier un visiteur. Cet exemple marque un formulaire de contact :

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

Le marqueur produit form-submitted-contact lorsque le navigateur envoie le formulaire. Il ne prouve pas que le serveur l'a accepté ou traité. Conserver le code existant de validation et de traitement du formulaire ; ajouter un marqueur de mesure ne met pas en œuvre la gestion du formulaire.

Confirmer la réussite au point où elle se produit réellement

Pour un formulaire personnalisé, appeler la fonction de réussite uniquement après confirmation du traitement réussi par l'application. La réception d'une réponse HTTP, un clic sur un bouton ou la résolution d'une promesse fetch ne suffit pas en soi : l'application doit interpréter sa propre réponse du serveur et son état d'erreur.

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

Cet appel produit form-success-contact lorsque la mesure des formulaires est activée et que le traceur est disponible. Le placer dans la branche existante de réussite confirmée, pas avant la requête ni dans un gestionnaire de fin inconditionnel. Contact Form 7 peut utiliser son intégration prise en charge de l'événement d'envoi réussi du courriel ; un formulaire générique nécessite un signal explicite de réussite de l'application.

Vérifier la réussite comme l'échec

1. Sur une installation de test détenue, essayer un envoi valide et un envoi refusé par l'application. Seule la réussite confirmée doit envoyer l'événement de réussite.
2. Utiliser Débogueur de mesures pour vérifier si la catégorie et le nom d'événement attendus seraient acceptés, sans compter un événement réel.
3. Comparer les noms d'événement obtenus dans le rapport. Un nombre d'envois supérieur au nombre de réussites peut être un signal utile, mais ne prouve pas une erreur précise.

Le débogueur vérifie l'admissibilité, pas la transmission réussie d'un véritable formulaire. Examiner séparément la réponse de l'application et les requêtes normales du traceur. Ne pas inclure de noms ni de contenus de formulaires dans les libellés d'événement et les propriétés de diagnostic.

Étape suivante

Consulter le guide d'intégration avant d'ajouter l'appel de réussite à l'application.

Ouvrir le guide d'installation