Questa guida descrive come utilizzare analytics.js per misurare l'attività delle pagine sui siti i cui contenuti vengono caricati in modo dinamico senza il tradizionale caricamento di pagine complete.
Panoramica
Un'applicazione a pagina singola (APS) è un'applicazione web o un sito web che carica tutte le risorse necessarie per navigare nel sito al primo caricamento della pagina. Quando l'utente fa clic sui link e interagisce con la pagina, i contenuti successivi vengono caricati in modo dinamico. L'applicazione aggiorna spesso l'URL nella barra degli indirizzi per emulare la navigazione tradizionale nelle pagine, ma non viene mai effettuata un'altra richiesta di pagina intera.
Il tag di Google Analytics predefinito funziona bene con i siti web tradizionali perché il codice snippet viene eseguito ogni volta che gli utenti caricano una nuova pagina. Tuttavia, per un'applicazione a pagina singola in cui il sito carica dinamicamente i nuovi contenuti della pagina anziché l'intera pagina, il codice dello snippet analytics.js viene eseguito una sola volta. Ciò significa che le successive visualizzazioni di pagina (virtuali) devono essere acquisite manualmente man mano che vengono caricati nuovi contenuti.
Monitoraggio delle visualizzazioni di pagina virtuali
Quando la tua applicazione carica i contenuti in modo dinamico e aggiorna l'URL nella barra degli indirizzi, dovrebbero essere aggiornati anche i dati memorizzati sul tuo tracker.
Per aggiornare il tracker, utilizza il comando set e fornisci il nuovo valore page:
ga('set', 'page', '/new-page.html');
Dopo aver impostato il nuovo valore della pagina, tutti gli hit successivi inviati utilizzeranno quel nuovo valore. Per registrare una visualizzazione di pagina, invia un hit visualizzazione di pagina subito dopo l'aggiornamento del tracker.
ga('set', 'page', '/new-page.html');
ga('send', 'pageview');
Anche se tecnicamente il comando send per gli hit da visualizzazione di pagina accetta un campo page facoltativo come terzo parametro, non è consigliabile trasmettere in questo modo il campo page quando si misurano le applicazioni a pagina singola. Questo perché i campi trasmessi tramite il comando send non vengono impostati nel tracker, ma si applicano solo all'hit corrente. Il mancato aggiornamento del tracker causa problemi se l'applicazione invia hit non relativi alla visualizzazione di pagina (ad esempio, eventi o interazioni social), poiché questi hit verranno associati a qualsiasi valore page del tracker al momento della creazione.
Gestione di più URL per la stessa risorsa
Alcune APS aggiornano solo la parte hash dell'URL durante il caricamento dinamico dei contenuti. Questa prassi può portare a situazioni in cui molti percorsi pagina diversi puntano alla stessa risorsa. In questi casi, è preferibile scegliere un URL canonico e inviare sempre quel valore page a Google Analytics.
Ad esempio, prendiamo in considerazione un sito web la cui pagina "Chi siamo" può essere raggiunta tramite uno dei seguenti URL:
/about.html/#about.html/home.html#about.html
Per evitare duplicati nei report, ti consigliamo di acquisire tutte queste visualizzazioni di pagina come /about.html.
Considerazioni importanti
Non aggiornare il referrer del documento
Quando crei un oggetto tracker utilizzando il comando create, il valore di document.referrer viene memorizzato nel campo referrer del tracker. Nel contesto di un'applicazione a pagina singola che non utilizza i caricamenti completi delle pagine, il campo referrer rimarrà sempre invariato.
Nonostante ciò, non è necessario aggiornare manualmente il campo del referrer prima di inviare gli hit di visualizzazione di pagina. Google Analytics è in grado di determinare automaticamente il percorso di navigazione corretto.
Non aggiornare la posizione del documento
Allo stesso modo in cui il tracker utilizza document.referrer per il campo referrer, utilizza document.location per il campo location, che può contenere dati della campagna o altri metadati sotto forma di parametri di query aggiunti alla fine dell'URL.
L'aggiornamento di uno dei campi della campagna o di altri metadati controllati da Google Analytics potrebbe causare la fine della sessione corrente e l'inizio di una nuova. Per evitare questo problema, non aggiornare il campo location quando misuri le visualizzazioni di pagina virtuali in un'applicazione a pagina singola. Utilizza invece il campo page.
Non creare nuovi tracker
Non creare nuovi tracker in un'app su una sola pagina nel tentativo di imitare ciò che fa lo snippet di monitoraggio JavaScript per i siti web tradizionali. Così facendo, si corre il rischio di inviare un referrer e dati della campagna non corretti, come descritto sopra.