Misurazione degli eventi

Questa guida spiega come misurare gli eventi con analytics.js.

Panoramica

Gli eventi sono le interazioni degli utenti con i contenuti che possono essere misurate separatamente rispetto a una pagina web o al caricamento di una schermata. Download, clic su annunci per dispositivi mobili, gadget, elementi Flash, elementi incorporati AJAX e riproduzioni video sono tutti esempi di azioni che possono essere misurate come eventi.

Se non hai dimestichezza con gli eventi in Google Analytics, ti consigliamo di leggere prima l'articolo Informazioni sugli eventi nel Centro assistenza Analytics.

Implementazione

Gli hit da evento possono essere inviati utilizzando il comando send e specificando un hitType pari a event. Il comando send ha la seguente firma per il tipo di hit event:

ga('send', 'event', [eventCategory], [eventAction], [eventLabel], [eventValue], [fieldsObject]);

Campi evento

La tabella seguente riassume i campi evento:

Nome campo	Tipo di valore	Obbligatorio	Descrizione
eventCategory	testo	yes	In genere l'oggetto con cui è stata eseguita l'interazione (ad es. 'Video')
eventAction	testo	yes	Tipo di interazione (ad es. 'play')
eventLabel	testo	no	Utili per classificare gli eventi (ad es. 'Fall Campaign')
eventValue	numero intero	no	Un valore numerico associato all'evento (ad es. 42)

Per una descrizione più approfondita di ciascuno di questi campi, consulta Struttura di un evento nel Centro assistenza Analytics.

Esempi:

Il seguente comando invia a Google Analytics un evento che indica che è stato riprodotto il video promozionale della campagna autunnale:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign');

Tieni presente che, come per tutti i comandi send, i campi passati nei parametri di convenienza possono essere specificati anche in fieldsObject. Il comando precedente potrebbe essere riscritto come segue:

ga('send', {
  hitType: 'event',
  eventCategory: 'Videos',
  eventAction: 'play',
  eventLabel: 'Fall Campaign'
});

Per ulteriori dettagli, esempi e best practice per l'invio di hit, consulta la guida Invio di dati a Google Analytics. Per maggiori dettagli sulla firma di chiamata del comando send, consulta la sezione di riferimento sulla coda dei comandi.

Misurare i moduli e i link in uscita

Quando un utente fa clic su un link che rimanda a un'altra pagina del tuo sito, quella pagina in genere invia un hit visualizzazione di pagina all'arrivo dell'utente. Poiché è presente una serie di visualizzazioni di pagina, Google Analytics è in grado di determinare il backend dove l'utente è arrivato e da dove è stato. Tuttavia, se un utente fa clic su un link o invia un modulo a un dominio esterno, l'azione non viene acquisita, a meno che tu non indichi esplicitamente a Google Analytics cosa è successo.

La misurazione degli eventi dei moduli e dei link in uscita può essere eseguita inviando eventi e specificando l'URL di destinazione in uno dei campi evento. La seguente funzione gestore di eventi può essere utilizzata per inviare a Google Analytics gli eventi di clic sui link in uscita:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href
  });
}

La misurazione dei link e dei moduli in uscita può essere difficile perché la maggior parte dei browser interrompe l'esecuzione di JavaScript nella pagina corrente quando inizia il caricamento di una nuova pagina. Una soluzione a questo problema è impostare il campo transport su beacon:

function handleOutboundLinkClicks(event) {
  ga('send', 'event', {
    eventCategory: 'Outbound Link',
    eventAction: 'click',
    eventLabel: event.target.href,
    transport: 'beacon'
  });
}

Per i browser che non supportano il metodo di trasporto del beacon, devi posticipare la navigazione alla pagina successiva fino al termine dell'invio dell'evento. La sezione Sapere quando è stato inviato un hit della guida sull'invio di dati a Google Analytics spiega in dettaglio come farlo.

Nota: gli sviluppatori che vogliono misurare i moduli e i link in uscita possono utilizzare autotrack, che include i plug-in outboundLinkTracker ed outboundFormTracker, che gestiscono queste complessità per te. Per le istruzioni sull'utilizzo e sull'installazione, consulta la documentazione relativa al monitoraggio automatico.

Eventi non di interazione

In alcuni casi potresti voler inviare un evento come evento non interazione. Per farlo, specifica il campo nonInteraction come true nel fieldsObject del comando send:

ga('send', 'event', 'Videos', 'play', 'Fall Campaign', {
  nonInteraction: true
});

Per ulteriori informazioni sugli hit non di interazione e su quando utilizzarli, consulta le informazioni sugli eventi diversi dall'interazione nel Centro assistenza Analytics.