Questa guida descrive come misurare i periodi di tempo utilizzando analytics.js.
Panoramica
Alcuni studi hanno dimostrato che ridurre il tempo di caricamento delle pagine migliora l'esperienza utente complessiva di un sito. Google Analytics offre una serie di report utili che misurano e registrano automaticamente i tempi di caricamento delle pagine. Tuttavia, ti consente anche di misurare le informazioni personalizzate sulle tempistiche per misurare le prestazioni specifiche del tuo sito.
I tempi utente consentono agli sviluppatori di misurare i periodi di tempo utilizzando la libreria analytics.js. Ciò è particolarmente utile per gli sviluppatori per misurare la latenza, o il tempo trascorso, a effettuare richieste AJAX e a caricare risorse web.
Implementazione
Gli hit dei tempi utente possono essere inviati utilizzando il comando send e specificando un hitType pari a timing. Il comando send ha la seguente firma per il tipo di hit timing:
ga('send', 'timing', [timingCategory], [timingVar], [timingValue], [timingLabel], [fieldsObject]);
Campi dei tempi utente
La tabella seguente riassume i campi dei tempi utente:
| Nome campo | Tipo di valore | Obbligatorio | Descrizione |
|---|---|---|---|
timingCategory |
testo | yes | Una stringa per classificare tutte le variabili dei tempi utente in gruppi logici (ad es. 'JS Dependencies'). |
timingVar |
testo | yes | Una stringa per identificare la variabile registrata (ad es. 'load'). |
timingValue |
numero intero | yes | Il numero di millisecondi nel tempo trascorso per la segnalazione a Google Analytics (ad es. 20). |
timingLabel |
testo | no | Una stringa che può essere utilizzata per una maggiore flessibilità nella visualizzazione dei tempi utente nei report (ad es. 'Google CDN'). |
Esempi:
Il seguente comando invia un hit di tempo utente a Google Analytics, a indicare che la pagina web corrente ha impiegato 3549 millisecondi per caricare tutte le dipendenze JavaScript esterne:
ga('send', 'timing', 'JS Dependencies', 'load', 3549);
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: 'timing',
timingCategory: 'JS Dependencies',
timingVar: 'load',
timingValue: 3549
});
Misurazione del tempo
Quando invii i dati relativi al tempo utente, specifichi la quantità di millisecondi spesi nel parametro timingValue. Spetta a te scrivere codice per acquisire questo periodo di tempo.
Il modo più semplice per farlo è creare un timestamp all'inizio di un periodo di tempo e un altro timestamp alla fine del periodo. Quindi puoi prendere la differenza tra i due timestamp per calcolare il tempo di utilizzo.
La maggior parte dei browser moderni supporta l'API Navigation Timing, che include metodi sull'oggetto window.performance per misurare le prestazioni delle pagine web tramite dati temporali ad alta risoluzione.
Nell'esempio seguente viene utilizzato il metodo performance.now(), che restituisce il tempo trascorso dall'inizio del caricamento della pagina:
// Feature detects Navigation Timing API support.
if (window.performance) {
// Gets the number of milliseconds since page load
// (and rounds the result since the value must be an integer).
var timeSincePageLoad = Math.round(performance.now());
// Sends the timing hit to Google Analytics.
ga('send', 'timing', 'JS Dependencies', 'load', timeSincePageLoad);
}
Considerazioni sul campionamento
Google Analytics campionerà gli hit di tempo durante l'elaborazione per garantire una distribuzione equa delle risorse di sistema per questa funzionalità.
La frequenza con cui vengono campionati gli hit temporali è determinata dal numero totale di hit da visualizzazione di pagina ricevuti durante il giorno precedente per la proprietà. La seguente tabella illustra come viene determinata la frequenza di campionamento dei tempi:
| Numero totale di hit visualizzazioni di pagina (giorno precedente) | Numero massimo di hit di tempo che verranno elaborati |
|---|---|
| 0-1000 | 100 |
| 1000 - 100.000 | 10% del numero totale di hit delle visualizzazioni di pagina |
| 100.000-1.000.000 | 10.000 |
| Oltre 1.000.000 | 1% del numero totale di hit di visualizzazioni di pagina |
Limitare il numero di hit inviati
Per evitare di inviare hit di Google Analytics che non verranno elaborati, analytics.js ti consente di controllare la percentuale di hit che vengono inviati tramite le opzioni di configurazione sampleRate e siteSpeedSampleRate. Per impostazione predefinita, questi campi sono impostati rispettivamente sul 100% e 1%. Puoi modificare questi valori per approssimare il numero di hit temporali elaborati da Google Analytics in base al numero medio di visualizzazioni di pagina giornaliere.