Le proprietà Universal Analytics (UA) standard hanno smesso di elaborare i dati il 1° luglio 2023. Il 1° luglio 2024 verrà interrotta l'elaborazione dei dati per le proprietà UA 360 e alcune funzionalità di UA 360 verranno ritirate prima, durante la migrazione a Google Analytics 4. Aggiungi Google Analytics 4 all'implementazione esistente.

Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi legati al codice di monitoraggio

Se vuoi risolvere problemi relativi al monitoraggio di Google Analytics, assicurati innanzitutto che la configurazione di base sia corretta, come descritto nella sezione Verificare la configurazione del Centro assistenza.

La risoluzione dei problemi legati al monitoraggio di Analytics riguarda due problemi principali:

Errori/errori di ortografia nella sintassi del codice di monitoraggio (ad es. spazio vuoto, personalizzazioni scritte in modo errato, nomi di parametri errati)
Dati mancanti nei report

Il resto del documento spiega come utilizzare gli strumenti per la risoluzione dei problemi per identificare e risolvere questi due problemi di base.

Errori comuni del codice di monitoraggio

A prescindere dal fatto che utilizzi la sintassi asincrona o tradizionale, tieni presente quanto segue per evitare gli errori più comuni durante la personalizzazione o l'aggiustamento del codice di monitoraggio. Per scoprire come verificare facilmente questi errori, consulta Eseguire il debug con ga_debug.js.

I nomi dei metodi utilizzano lettere maiuscole e minuscole non corrette.
Ricorda che i metodi sono sensibili alle maiuscole. Se utilizzi un nome di metodo senza utilizzare le maiuscole e le minuscole correttamente, le chiamate al metodo non funzioneranno. Esempi:
```
  _gaq.push(['_trackpageview']);   // wrong
  _gaq.push(['_trackPageView']);   // wrong
  _gaq.push(['_trackPageview']);   // correct
```
Nomi dei metodi non corretti.
Se il monitoraggio non funziona correttamente, accertati di utilizzare il nome del metodo corretto. Esempi:
```
  _gaq.push(['_setDomain', 'example.com']);       // wrong
  _gaq.push(['_setDomainName', 'example.com']);   // correct
```
Trasmettere un valore non stringa tramite virgolette.
Devono essere inserite solo le stringhe tra virgolette. Tutti gli altri tipi non devono essere tra virgolette.
Qualsiasi valore che non sia una stringa, come valori booleani, valori letterali oggetto, funzioni o array, deve essere trasmesso senza virgolette. Utilizza solo le virgolette quando trasmetti qualcosa che deve essere interpretato come una stringa. Se stai eseguendo la migrazione dalla sintassi tradizionale, qualsiasi parametro della funzione passato senza virgolette deve rimanere senza virgolette nella sintassi asincrona. Esempi:
```
  _gaq.push(['_setAllowLinker', 'false']);    // wrong
  _gaq.push(['_setAllowLinker', false]);      // correct
```

Le stringhe contengono spazi vuoti iniziali o finali.
Esempi:

  _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
  _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

Torna all'inizio

Problemi comuni relativi ai dati dei report

Se nei tuoi report mancano dati, leggi questa sezione per identificare gli errori più comuni e le azioni consigliate.

Impostazione o modifica del codice di monitoraggio non rilevata

Quando installi il codice di monitoraggio per la prima volta su una pagina o aggiungi altre funzionalità del codice di monitoraggio (ad esempio per l'e-commerce), puoi verificare facilmente che la richiesta di pagina sia impostata correttamente verificando i seguenti elementi:

La pagina richiede il codice JavaScript ga.js
La pagina richiede __utm.gif
Le variabili utmac e utmcc vengono inviate nella richiesta __utm.gif
Tutti i parametri di monitoraggio pertinenti sono disponibili per i dati aggiuntivi che ti aspetti di ricevere (consulta l'elenco dei parametri di richiesta GIF di seguito).

Se tutti questi elementi vengono inviati correttamente, i dati dovrebbero comparire nei report entro 24 ore al massimo. Tuttavia, puoi anche verificare se i dati vengono visualizzati prima modificando l'intervallo di date nei report impostandolo su "oggi".

Torna all'inizio

La pagina o l'evento non viene visualizzato nei report

Se una pagina che contiene il codice di monitoraggio non viene visualizzata nei report sui contenuti, verifica quanto segue:

Stai cercando la pagina corretta?

Google Analytics utilizza il valore del parametro utmp come la pagina richiesta. Di conseguenza, se l'URL della pagina è /test/myPage.html, assicurati di cercare myPage.html nei report Contenuti. Controlla il valore del parametro utmp per vedere quale richiesta di pagina viene inviata.

Stai cercando l'evento corretto?

Google Analytics utilizza il valore del parametro utme per monitorare gli eventi nel formato 5(object*action*label)(value):

5 è una costante
oggetto e azione sono obbligatori
etichette e valore sono opzioni

Per saperne di più, consulta la documentazione relativa agli eventi di monitoraggio.

Monitori più di 50.000 URL unici o pagine virtuali al giorno?

Google Analytics raccoglie tutti i dati inviati da un sito web e genera report sulle prime 50.000 pagine (ordinate per visualizzazioni di pagina) al giorno. Tutte le pagine rimanenti vengono aggregate in una sezione separata che avrà l'etichetta (other) nei report sui contenuti. Per visualizzare informazioni dettagliate sui report per le visualizzazioni di pagina con traffico più basso, puoi configurare una nuova vista (profilo) con un filtro per rimuovere tutte le visualizzazioni di pagina con traffico più elevato. In questo modo, le pagine rimanenti possono essere incluse nei primi 50.000 URL.

Assicurati di accedere all'account e alla vista (profilo) corretti nell'interfaccia utente di reporting.

Google Analytics distingue i diversi account in base agli ID dominio, che assumono la forma di UA-123456-1. Questo ID dominio viene inserito nel codice di monitoraggio, ovvero il modo in cui i dati di una pagina vengono associati a un determinato account. Assicurati che l'account e la vista (profilo) che stai esaminando (Impostazioni Analytics -> modifica -> verifica stato) abbiano lo stesso ID di dominio di quelli inviati nel parametro utmac per la richiesta GIF.

Torna all'inizio

Problemi di monitoraggio delle campagne

Affinché una campagna pubblicitaria venga monitorata in Google Analytics, ai link pubblicitari al tuo sito web devono essere aggiunti i parametri di monitoraggio. Il codice GATC utilizza quindi una combinazione di URL della pagina e parametri del referral per identificare la campagna inviata. Queste informazioni vengono quindi memorizzate nel cookie del tuo sito e inviate nel parametro utmcc della richiesta GIF. In molti casi, i reindirizzamenti dell'URL del sito web rimuoveranno i parametri di monitoraggio o i dati dei referral da questi link, generando report sulle campagne errati.

Per verificare se i reindirizzamenti causano problemi di monitoraggio della campagna, fai clic su un referral o su un link codificato che rimanda al tuo sito web e cerca i dati corretti della campagna nel parametro utmcc. Per scoprire di più su come trovare e leggere il parametro utmcc, consulta Parametri delle richieste GIF e Debug con ga_debug.js.

Attribuzione dell'obiettivo (conversione) non corretta

Una conversione è un obiettivo associato a una campagna specifica. Per assicurarti di aver associato correttamente un obiettivo a una determinata campagna o a un referral:

Fai clic su un referral che rimanda al tuo sito per impostare i cookie della campagna.
Fai clic sul tuo sito per accedere alla pagina della conversione o dell'obiettivo.
Controlla i dati inviati nel parametro utmcc per assicurarti che il cookie della campagna venga mantenuto.

Dopo che il codice di monitoraggio ha acquisito tutte le informazioni sulla campagna, viene memorizzato in un cookie che rimane insieme all'utente per più sessioni. Per ogni pagina che esegue le funzioni di monitoraggio, le informazioni sulla campagna vengono inviate nella richiesta GIF. Pertanto, a ogni visualizzazione di pagina sono associati dati sulla campagna/referral. Se una di queste visualizzazioni di pagina è configurata come obiettivo, la campagna di visualizzazioni di pagina associata viene associata all'obiettivo. Per scoprire di più su come trovare e leggere il parametro utmcc, consulta Parametri delle richieste GIF e Debug con ga_debug.js.

Torna all'inizio

Passaggi di debug di base

Ogni volta che viene eseguito, il codice di monitoraggio di Google Analytics richiede un'immagine GIF di un solo pixel ai server di raccolta di Google Analytics chiamati __utm.gif.Alla stringa di richiesta dell'immagine sono stati aggiunti tutti i parametri che Google acquisisce per una determinata richiesta di pagina, tra cui:

Informazioni sulle visualizzazioni di pagina dell'URL
Informazioni sulla campagna
Dati di e-commerce
Proprietà browser
ID client

I dati contenuti nella richiesta GIF corrispondono esattamente ai dati inviati ai server di Google Analytics, che poi vengono elaborati e inseriti nei report. Pertanto, visualizzando i dati inviati nella richiesta __utm.gif, puoi determinare se il codice di monitoraggio funziona e, soprattutto, se invia dati errati ai tuoi report.

Per eseguire il debug del codice di monitoraggio, segui questi passaggi di base:

Utilizza uno strumento di debug di terze parti per esaminare la richiesta GIF a Google Analytics facendo clic sul link pertinente nel tuo sito web.
Verifica che il codice di monitoraggio non contenga nessuno degli errori comuni del codice di monitoraggio.
Assicurati che sia presente il parametro utmp.
Assicurati che il parametro utmcc sia presente e non sia vuoto.
Nel caso di un parametro utmcc vuoto, non vengono inviati dati dei cookie e la richiesta viene ignorata.
Ripeti il test più volte per assicurarti che la richiesta GIF venga inviata ogni volta.

Torna all'inizio

Strumenti di debug

Alla richiesta GIF ha un numero di parametri nome/valore associati al suo URL. Anziché provare a esaminare la stringa nella sua interezza, puoi utilizzare uno strumento senza costi per visualizzare la richiesta GIF in un formato più leggibile. Nella tabella seguente sono elencati una serie di strumenti da utilizzare con i browser più comuni.

Per comodità, abbiamo sviluppato il debugger del codice di monitoraggio di Google Analytics, che consente di risolvere i problemi relativi al codice di monitoraggio senza richiedere modifiche da parte tua. Non devi fare altro che abilitare questa estensione e potrai controllare la presenza di eventuali errori nelle tue pagine di produzione. Scopri di più su ga_debug.js.

Browser	Strumento
Tutte	Firebug Lite
Chrome	Strumento di debug del codice di monitoraggio di Google Analytics Novità!
Chrome	Strumenti per sviluppatori integrati (ad es. Risorse)
Firefox	Intestazioni HTTP in tempo reale
Firefox	Firebug
Firefox	Carlo
Internet Explorer	Violoncello
Internet Explorer	Carlo
Safari	Finestra Attività integrata
Safari	Carlo

Dopo aver installato lo strumento e averlo configurato, puoi aprire la pagina web di cui vuoi risolvere i problemi e visualizzare l'analisi della GIF nello strumento. Innanzitutto devi assicurarti che la pagina in questione stia effettivamente inviando una richiesta __utm.gif. Finché visualizzi la richiesta, hai la certezza che i server di Google Analytics stiano raccogliendo i dati da quella pagina. Il resto di questa sezione fornisce istruzioni di base per l'utilizzo di Live HTTP Header e Firebug per darti un'idea di quanto sia facile usare componenti aggiuntivi o strumenti integrati con il tuo browser web.

Utilizzo delle intestazioni HTTP live

Scarica e installa LiveHTTPHeaders per Firefox; riavvia il browser.
Apri le intestazioni HTTP Live (Strumenti > LiveHTTPHeaders).
Fai clic sulla scheda Generatore.
Accedi al tuo sito (o a qualsiasi pagina in cui è installato il codice di monitoraggio di Google Analytics).
Verifica che sia stata effettuata una richiesta per urchin.js o ga.js
Verifica che venga effettuata una richiesta per __utm.gif.

Utilizzo di Firebug

L'estensione Firebug offre una visualizzazione più strutturata sia della richiesta del codice di monitoraggio (urchin.js o ga.js) che della richiesta GIF (__utm.gif). Questi passaggi mostrano come utilizzare Firebug per visualizzare i dettagli della richiesta GIF.

Scarica e installa Firebug per Firefox; riavvia il browser.
Accedi al sito.
In Firefox, seleziona Strumenti> Firebug > Apri Firebug > "Attiva Firebug per questo sito web".
Fai clic su Rete e poi su Immagini.
Ricarica la pagina e controlla che nell'elenco venga visualizzata una nuova richiesta per __utm.gif.
Verifica i componenti della richiesta nella scheda Parametri.

Torna all'inizio

Debug con ga_debug.js

Oltre allo standard ga.js, il team di Analytics ha eseguito il deployment di una versione alternativa del codice JavaScript di Google Analytics chiamata ga_debug.js. Lo scopo di questo script è aiutare gli utenti di Analytics a risolvere i problemi delle loro installazioni. È particolarmente utile se non hai mai utilizzato Analytics o se stai eseguendo la migrazione del tuo sito alla nuova sintassi asincrona.

Lo script fornisce dettagli su ogni richiesta GIF e registra messaggi di avviso ed errore quando rileva problemi nel codice di monitoraggio. Per farlo, stampa i messaggi nell'oggetto window.console. Puoi quindi utilizzare uno dei seguenti strumenti per visualizzare questi errori:

Firebug (per Firefox)
Strumenti integrati per Chrome e/o Safari
Firebug Lite (per altri browser)

Per utilizzare lo script ga_debug.js, puoi modificare il riferimento del codice di monitoraggio per una pagina web a cui hai accesso e che puoi modificare. A questo scopo, sostituisci tutti i riferimenti a /ga.js con /u/ga_debug.js nel codice di monitoraggio della pagina. Se utilizzi lo script di debug per un sito web su larga scala, ti consigliamo di utilizzarlo solo nel tuo ambiente di test. In alternativa, se stai eseguendo il debug di un sito di piccole dimensioni, ti consigliamo di verificare solo determinate pagine anziché l'intero sito in questo modo.

Importante: non modificare il tuo sito di produzione per utilizzare questa versione di JavaScript. Lo script ga_debug.js è più grande del codice di monitoraggio ga.js e in genere non viene memorizzato nella cache. Pertanto, il suo utilizzo in tutto il sito di produzione rallenterà il sito per tutti gli utenti. Anche in questo caso, l'utilizzo è riservato ai test.

Se utilizzi Universal Analytics (analytics.js) per monitorare i siti, puoi attivare analytics_debug.js, la versione di debug di analytics.js, per risolvere i problemi relativi al codice di monitoraggio. Per maggiori informazioni su analytics_debug.js, consulta la pagina relativa al debug.

Utilizzo del debugger del codice di monitoraggio di Google Analytics

Google Analytics Tracking Code Debugger è un'estensione del browser Chrome che attiva ga_debug.js per te senza richiedere modifiche al codice da parte tua. Probabilmente, è il modo più semplice per utilizzare ga_debug.js consiste nel risolvere i problemi e analizzare il comportamento del monitoraggio per il tuo sito web. Attivando questa estensione, potrai verificare la presenza di errori nelle pagine di produzione senza dover modificare i riferimenti di monitoraggio nel codice stesso.

Per utilizzare questa estensione, attivala facendo clic sulla relativa icona a destra della barra degli indirizzi. Quindi, apri la console JavaScript di Chrome per visualizzare i messaggi al suo interno.

Su Windows e Linux, fai clic su [Icona pagina] -> Sviluppatore -> Console JavaScript oppure premi Ctrl-Maiusc-J.
Su Mac, fai clic su Visualizza -> Sviluppatore -> Console JavaScript oppure premi Comando-Opzione-J.

Torna all'inizio

Parametri delle richieste GIF

La richiesta GIF è piuttosto lunga. Ecco un esempio di una sola parte di una richiesta GIF:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...

Questa tabella contiene un elenco dei molti parametri trasmessi tramite la richiesta GIF. Non tutti i parametri vengono trasmessi a ogni esecuzione del codice di monitoraggio, poiché alcuni si applicano solo a determinate condizioni, come i referral della campagna o i carrelli degli acquisti. Quando utilizzi questo riferimento, tieni presente che dovrai cercare le variabili che si applicano più di frequente alla pagina/richiesta che stai esaminando.

Variabile	Descrizione	Valore di esempio
utmac	Stringa account. Viene visualizzato per tutte le richieste.	utmac=UA-2202604-2
utmcc	Valori dei cookie. Questo parametro di richiesta invia tutti i cookie richiesti dalla pagina.	utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(referral)%7C%3dreferral%7C
utmcn	Avvia una nuova sessione della campagna. Per ogni richiesta è presente utmcn o utmcr. Modifica i dati di monitoraggio della campagna, ma non avvia una nuova sessione	utmcn=1
utmcr	Indica una visita ripetuta alla campagna. Viene impostato quando eventuali clic successivi si verificano sullo stesso link. Per ogni richiesta è presente utmcn o utmcr.	utmcr=1
utmcs	Codifica della lingua per il browser. Alcuni browser non la impostano, nel qual caso il valore è impostato su "-"	utmcs=ISO-8859-1
utmdt	Titolo della pagina, che è una stringa con codifica URL.	utmdt=test%20pagina%20di%20analisi
utm	Parametro estensibile	Il valore è codificato. Utilizzato per eventi e variabili personalizzate.
utmfl	Versione Flash	utmfl=9,0%20r48&
utmhn	Host Name, ovvero una stringa con codifica URL.	utmhn=x343.gmodules.com
utmhid	Un numero casuale utilizzato per collegare le richieste GIF di Analytics con Google AdSense.	utmhid=2059107202
utmipc	Codice prodotto. Si tratta del codice SKU per un determinato prodotto.	utmipc=989898ajssi
utmipn	Nome prodotto, che è una stringa con codifica URL.	utmipn=camicia%20tee
utmipr	Prezzo unitario. Impostata a livello di articolo. Il valore è impostato su numeri solo nel formato di valuta statunitense.	utmipr=17100,32
utmiqt	Quantità.	utmiqt=4
utmiva	Varianti di un elemento. Ad esempio: grande, medio, piccolo, rosa, bianco, nero, verde. La stringa è codificata nell'URL.	utmiva=rosso;
utmje	Indica se il browser è abilitato per Java. 1 è vero.	utmje=1
utmn	ID univoco generato per ogni richiesta GIF per impedire la memorizzazione nella cache dell'immagine GIF.	utmn=1142651215
utmp	Richiesta di pagina della pagina corrente.	utmp=/testDirectory/myPage.html
utmr	Referral, URL completo.	utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc	Profondità di colore dello schermo	utmsc=24-bit
utmsr	Risoluzione dello schermo	utmsr=2400x1920
utmt	Indica il tipo di richiesta, che può essere event, transaction, item o variabile personalizzata. Se questo valore non è presente nella richiesta GIF, la richiesta viene digitata come page.	utmt=evento
utmtci	Città di fatturazione	utmtci=San%20Diego
utmtco	Paese di fatturazione	utmtco=Regno%20Regno Unito
utmtid	ID ordine, stringa con codifica URL.	utmtid=a2343898
utmtrg	Regione di fatturazione, stringa con codifica URL.	utmtrg=Nuovo%20Brunswick
utmtsp	Costo di spedizione. Valori per unità e prezzo.	utmtsp=23,95
utmtst	Affiliazione. Generalmente utilizzato per applicazioni fisiche nell'e-commerce.	utmtst=negozio%20mtv%20google
utmtto	Totale. Valori per unità e prezzo.	utmtto=334,56
utmttx	Tasse. Valori per unità e prezzo.	utmttx=29,16
utmul	Lingua del browser.	utmul=pt-br
utmwv	Versione del codice di monitoraggio	utmwv=1

Torna all'inizio