Misurare il successo del modulo anziché i clic sul pulsante

Fare clic su un pulsante di invio, inviare un modulo e completarne l'elaborazione sono eventi diversi. Un clic può essere seguito da un errore di convalida, una richiesta fallita o un rifiuto del server. Stats4U offre categorie di contatto automatiche, invii contrassegnati ed eventi espliciti di successo del modulo; la scelta determina il significato effettivo del report.

Abilitare solo le misurazioni necessarie

1. Aprire il contatore di proprietà tramite I miei contatori, quindi aprire Dashboard e strumenti e Azioni di contatto.
2. In Impostazioni di misurazione, abilitare Conta automaticamente i clic su telefono, e-mail e download per quelle categorie di clic, oppure Conta gli invii dei moduli contrassegnati e gli esiti positivi confermati dei moduli per gli invii contrassegnati e i successi confermati.
3. Scegliere Salva e verificare che il sito usi l'integrazione JavaScript generata.

Le categorie di contatto automatiche usano nomi di azione come contact-email, contact-phone e download. Descrivono un clic, non un'email consegnata, una chiamata con risposta o un download completato. L'evento non invia l'indirizzo, il numero di telefono o il contenuto dei campi del modulo.

Contrassegnare l'invio di un modulo

Aggiungere all'elemento del modulo un nome stabile e non personale. Il nome deve descriverne lo scopo anziché identificare un visitatore. Questo esempio contrassegna un modulo di contatto:

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

Il marcatore produce form-submitted-contact quando il browser invia il modulo. Non dimostra che il server lo abbia accettato o elaborato. Conservare il codice di convalida e di elaborazione già presente nel modulo; aggiungere un marcatore di misurazione non implementa la gestione del modulo.

Confermare il successo nel punto in cui avviene realmente

Per un modulo personalizzato, chiamare la funzione di successo solo dopo che l'applicazione ha confermato l'elaborazione riuscita. L'arrivo di una risposta HTTP, un clic su un pulsante o la risoluzione di una promise fetch non basta da solo: l'applicazione deve interpretare la propria risposta del server e lo stato di errore.

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

Questa chiamata produce form-success-contact quando la misurazione dei moduli è abilitata e il tracker è disponibile. Collocarla nel ramo esistente di successo confermato, non prima della richiesta né in un gestore di completamento incondizionato. Contact Form 7 può usare la sua integrazione supportata dell'evento di invio riuscito della mail; un modulo generico richiede un segnale esplicito di successo dell'applicazione.

Verificare sia il successo sia il fallimento

1. Su un'installazione di prova di proprietà, provare un invio valido e uno rifiutato dall'applicazione. Solo il successo confermato deve inviare l'evento di successo.
2. Usare Debugger delle misurazioni per verificare se la categoria e il nome dell'evento previsti sarebbero accettati, senza conteggiare un evento reale.
3. Confrontare i nomi degli eventi risultanti nel report. Un numero di invii superiore a quello dei successi può essere un segnale utile, ma non prova un errore specifico.

Il debugger verifica l'ammissibilità, non la consegna riuscita di un modulo reale. Esaminare separatamente la risposta dell'applicazione e le normali richieste del tracker. Tenere nomi e contenuti dei moduli fuori dalle etichette degli eventi e dalle proprietà diagnostiche.

Passaggio successivo

Consultare la guida di integrazione prima di aggiungere la chiamata di successo all'applicazione.

Aprire la guida di installazione