La misurazione delle visualizzazioni di pagina ti consente di misurare il numero di visualizzazioni ricevute per una determinata pagina del tuo sito web. Le pagine spesso corrispondono a un intero documento HTML, ma possono anche rappresentare contenuti caricati dinamicamente; questo sistema è noto come "visualizzazioni di pagina virtuali".
Questa guida spiega come implementare la misurazione delle visualizzazioni di pagina con analytics.js.
Panoramica
Il tag JavaScript include un comando per creare un oggetto tracker e quindi un comando per inviare una visualizzazione di pagina a Google Analytics. Quando il tracker viene creato, diversi campi vengono impostati in base al contesto di navigazione. Il campo title viene impostato sul valore document.title, mentre il campo location viene impostato sul valore document.location, ignorando la parte di ancoraggio dell'URL.
Quando viene eseguito il comando send, i campi title e location memorizzati sul tracker vengono inviati e Google Analytics utilizza questi valori per mostrarti le pagine visitate dagli utenti.
Il tracker predefinito non imposta il campo page, ma se lo imposti manualmente, questo valore viene utilizzato come percorso pagina nei report, sostituendo il valore del campo location.
Implementazione
Gli hit di visualizzazione di pagina possono essere inviati utilizzando il comando send e specificando un hitType pari a pageview. Il comando send ha la seguente firma per il tipo di hit pageview:
ga('send', 'pageview', [page], [fieldsObject]);
Campi delle visualizzazioni di pagina
La seguente tabella riassume i campi principali pertinenti alla misurazione delle visualizzazioni di pagina. Per ulteriori dettagli e per alcuni campi aggiuntivi, consulta la sezione delle informazioni sui contenuti del riferimento dei campi.
| Nome campo | Tipo di valore | Obbligatorio | Descrizione |
|---|---|---|---|
title |
testo | no | Il titolo della pagina (ad es. home page) |
location |
testo | no * | URL della pagina. |
page |
testo | no * | La parte del percorso di un URL. Questo valore deve iniziare con una barra (/). |
*
Anche se né il campo page né il campo location sono obbligatori, uno dei due deve essere presente, altrimenti l'hit non sarà valido.
Esempi:
Il seguente comando invia un hit visualizzazione di pagina a Google Analytics e include il percorso della pagina corrente.
ga('send', 'pageview', location.pathname);
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: 'pageview',
page: location.pathname
});
Modifica degli URL delle pagine
In alcuni casi, l'URL che vuoi inviare a Google Analytics è diverso da quello visualizzato nella barra degli indirizzi del browser dell'utente. Ad esempio, prendiamo in considerazione un sito con alcune pagine in cui gli utenti possono eseguire l'accesso e visualizzare/modificare le loro informazioni personali. Se il sito ha pagine separate per le informazioni personali, i dati dell'account e le impostazioni di notifica, gli URL di queste pagine potrebbero avere il seguente aspetto:
/user/USER_ID/profile/user/USER_ID/account/user/USER_ID/notifications
Se vuoi sapere, in totale, quante persone visitano ciascuna di queste pagine, includendo un ID utente unico negli URL, la procedura risulterà molto più difficile.
Per risolvere il problema, puoi specificare un valore page con l'ID utente rimosso:
// Checks to see if the current user's userID is
// found in the URL, if it is, remove it.
// (Note, this assume the user ID is stored
// in a variable called `userID`)
if (document.location.pathname.indexOf('user/' + userID) > -1) {
var page = document.location.pathname.replace('user/' + userID, 'user');
ga('send', 'pageview', page);
}
Verranno inviati i seguenti valori page per tutti gli utenti:
/user/profile/user/account/user/notifications
Se la pagina corrente invia altri hit (ad esempio, eventi), assicurati che ogni hit venga inviato con l'URL corretto. In questi casi, devi aggiornare il campo page sul tracker invece di passarlo nel comando send.
L'impostazione sul tracker garantisce che il nuovo valore page venga utilizzato per tutti gli hit successivi:
if (document.location.pathname.indexOf('user/' + userID) > -1) {
var page = document.location.pathname.replace('user/' + userID, 'user');
// Sets the page value on the tracker.
ga('set', 'page', page);
// Sending the pageview no longer requires passing the page
// value since it's now stored on the tracker object.
ga('send', 'pageview');
}
Monitoraggio delle visualizzazioni di pagina virtuali
Oggi molti siti web caricano i contenuti in modo dinamico tramite AJAX senza richiedere il caricamento completo di ogni "pagina". Questi siti sono comunemente indicati come Applicazioni a pagina singola (APS).
Se il tuo sito web carica i contenuti della pagina in modo dinamico e aggiorna l'URL del documento, in genere ti consigliamo di inviare ulteriori visualizzazioni di pagina per misurare queste "visualizzazioni di pagina virtuali". Per informazioni dettagliate sull'implementazione, consulta la guida al monitoraggio delle applicazioni a pagina singola con analytics.js.