La misurazione delle visualizzazioni di pagina consente di misurare il numero di visualizzazioni di una determinata pagina del tuo sito web. Spesso le pagine corrispondono a un intero documento HTML, ma possono anche rappresentare i contenuti caricati dinamicamente; questa operazione è nota 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 del tracker e un comando per inviare una visualizzazione di pagina a Google Analytics. Quando il tracker viene creato, molti dei campi vengono impostati in base al contesto di navigazione. Il campo title
è 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 tali valori per mostrare le pagine visitate dagli utenti.
Il tracker predefinito non imposta il campo page
, ma se lo imposti manualmente, quel 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 di pageview
. Il comando send
ha la seguente firma per il tipo di hit pageview
:
ga('send', 'pageview', [page], [fieldsObject]);
Campi di visualizzazione di pagina
La tabella seguente riepiloga 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 della documentazione sui 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
devono essere presenti, altrimenti il campo non sarà valido.
Esempi:
Il comando seguente 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 riportato sopra potrebbe essere riscritto come:
ga('send', {
hitType: 'pageview',
page: location.pathname
});
Modificare gli 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, prendi in considerazione un sito con alcune pagine in cui gli utenti possono accedere e visualizzare/modificare le proprie informazioni personali. Se questo 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, l'inclusione di un valore User-ID univoco negli URL renderà molto più difficile.
Per risolvere questo problema, puoi specificare un valore page
con lo User-ID 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);
}
I seguenti valori page
verranno inviati a tutti gli utenti:
/user/profile
/user/account
/user/notifications
Se la pagina corrente invia altri hit (come gli eventi), assicurati di inviare ogni hit con l'URL corretto. In questi casi, devi aggiornare il campo page
sul tracker invece di passarlo nel comando send
.
L'impostazione del 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
Molti siti web oggi caricano i contenuti in modo dinamico tramite AJAX senza richiedere il caricamento completo di ogni "pagina". Questi siti sono detti applicazioni a pagina singola (APS).
Se il tuo sito web carica i contenuti della pagina in modo dinamico e aggiorna l'URL del documento, di solito vuoi inviare visualizzazioni di pagina aggiuntive per misurare queste "visualizzazioni di pagina virtuali". Per informazioni dettagliate sull'implementazione, consulta la guida sul monitoraggio delle applicazioni a pagina singola con analytics.js.