Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi legati al codice di monitoraggio

Per risolvere i problemi relativi al monitoraggio di Google Analytics, assicurati che la configurazione di base sia corretta, come descritto nel Centro assistenza alla voce Verifica della configurazione.

La risoluzione dei problemi relativi al monitoraggio di Analytics riguarda due aspetti chiave:

Errori di errore/errori di battitura nel codice di monitoraggio (ad es. spazi vuoti, personalizzazioni scritte in modo errato, nomi di parametri sbagliati)
Dati non presenti nei report

Nella parte rimanente di questo documento viene spiegato come utilizzare gli strumenti per la risoluzione dei problemi per identificare e correggere questi due problemi di base.

Errori comuni del codice di monitoraggio

Se utilizzi la sintassi asincrona o tradizionale, tieni presente quanto segue per evitare gli errori più comuni quando personalizzi o modifichi il codice di monitoraggio. Per informazioni su come verificare facilmente questi errori, consulta la pagina Debug con ga_debug.js.

I nomi dei metodi utilizzano caratteri maiuscoli.
Ricorda che i metodi sono sensibili alle maiuscole. Se utilizzi un nome di metodo senza le maiuscole e le minuscole corrette, le chiamate metodo non funzioneranno. Esempi:
```
  _gaq.push(['_trackpageview']);   // wrong
  _gaq.push(['_trackPageView']);   // wrong
  _gaq.push(['_trackPageview']);   // correct
```
Nomi dei metodi errati.
Se il monitoraggio non funziona correttamente, assicurati di utilizzare il nome corretto del metodo. Esempi:
```
  _gaq.push(['_setDomain', 'example.com']);       // wrong
  _gaq.push(['_setDomainName', 'example.com']);   // correct
```
Trasmettere un valore non stringa utilizzando le virgolette.
Solo le stringhe devono essere passate con le virgolette. Tutti gli altri tipi non devono essere racchiusi tra virgolette.
Qualsiasi valore diverso da una stringa, come valori booleani, valori letterali di oggetti, funzioni o array, deve essere trasmesso senza virgolette. Utilizza le virgolette solo quando trasmetti qualcosa che deve essere interpretato come una stringa. Se esegui la migrazione dalla sintassi tradizionale, l'eventuale parametro della funzione passato senza virgolette deve rimanere non citato nella sintassi asincrona. Esempi:
```
  _gaq.push(['_setAllowLinker', 'false']);    // wrong
  _gaq.push(['_setAllowLinker', false]);      // correct
```

Le stringhe contengono spazi 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 mancano dati dai report, leggi questa sezione per identificare gli errori più comuni e le azioni consigliate.

Modifica o configurazione del codice di monitoraggio non rilevate

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

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

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

Torna all'inizio

La pagina o l'evento non compare 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 pagina richiesta; pertanto, se l'URL della pagina è /test/myPage.html, assicurati di cercare myPage.html nei report sui 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
l'oggetto e l'azione sono obbligatori
l'etichetta e il valore sono opzioni

Per ulteriori informazioni, consulta la documentazione relativa agli eventi di monitoraggio.

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

Google Analytics raccoglie tutto ciò che viene inviato da un sito web e genera rapporti sulle principali 50.000 pagine (ordinate per visualizzazioni di pagina) al giorno. Tutte le pagine rimanenti vengono aggregate in una sezione separata denominata (altro) nei report sui contenuti. Per visualizzare informazioni dettagliate sui report per le visualizzazioni di pagina con traffico più basso, puoi impostare una nuova vista (profilo) con un filtro per rimuovere tutte le visualizzazioni di pagina con traffico più elevato, il che consente di includere le pagine rimanenti nei primi 50.000 URL.

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

Google Analytics distingue i diversi account in base agli ID dominio, che assumono la forma di UA-123456-1. L'ID di questo dominio è 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 visualizzando (Impostazioni Analytics -> modifica -> controlla lo stato) abbiano lo stesso ID di dominio di quello inviato nel parametro utmac per la richiesta GIF.

Torna all'inizio

Problemi relativi al monitoraggio della campagna

Per effettuare il monitoraggio di una campagna pubblicitaria in Google Analytics, i link pubblicitari al tuo sito web devono contenere parametri di monitoraggio. Il codice GATC utilizza quindi una combinazione di parametri di pagina e URL di referral per identificare la campagna inviata. Queste informazioni vengono poi memorizzate nel cookie per il tuo sito e inviate nel parametro utmcc della richiesta GIF. In molti casi, i reindirizzamenti URL del sito web eliminano i parametri di monitoraggio o i dati sui referral da questi link e ciò porta a report sulle campagne errati.

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

Attribuzione 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 determinato referral:

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

Dopo aver acquisito tutte le informazioni sulla campagna, il codice di monitoraggio viene memorizzato in un cookie che persiste con l'utente in più sessioni. Per ogni pagina che esegue le funzioni di monitoraggio, le informazioni sulla campagna vengono inviate nella richiesta GIF. Di conseguenza, a ogni visualizzazione di pagina sono associati dati di campagna/referral. Se una di queste visualizzazioni di pagina è configurata come obiettivo, la campagna di visualizzazioni di pagina associata viene associata a tale obiettivo. Per scoprire di più su come trovare e leggere il parametro utmcc, consulta I parametri di richiesta GIF e Debug con ga_debug.js.

Torna all'inizio

Passaggi di debug di base

Ogni volta che il codice di monitoraggio di Google Analytics viene eseguito, richiede un'immagine GIF di un solo pixel ai server di raccolta di Google Analytics chiamati __utm.gif.All'interno della stringa di richiesta dell'immagine sono inclusi tutti i parametri che Google acquisisce in merito a una determinata richiesta di pagina, tra cui:

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

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

Per eseguire il debug del codice di monitoraggio:

Utilizza uno strumento di debug di terze parti per esaminare la richiesta GIF a Google Analytics facendo clic sul link pertinente sul tuo sito web.
Verifica che il codice di monitoraggio non contenga errori di codice di monitoraggio comuni.
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 diverse volte per assicurarti che la richiesta GIF sia inviata ogni volta.

Torna all'inizio

Strumenti di debug

La richiesta GIF contiene un numero di parametri nome/valore associati all'URL. Invece di provare a esaminare questa stringa nella sua interezza, puoi utilizzare uno strumento senza costi per visualizzare la richiesta GIF in una forma più leggibile. La seguente tabella riporta una serie di strumenti da utilizzare con i browser più comuni.

Per comodità, abbiamo sviluppato il coder di monitoraggio di Google Analytics, che aiuta a risolvere i problemi relativi al codice di monitoraggio senza richiedere modifiche da parte tua. È sufficiente attivare questa estensione e controllare che le pagine di produzione non contengano errori. Scopri di più su ga_debug.js.

Browser	Strumento
Tutte	Tensor Lite
Chrome	Debugger del codice di monitoraggio di Google Analytics Novità.
Chrome	Strumenti per sviluppatori incorporati (ad es. Risorse)
Firefox	Intestazioni HTTP pubblicate
Firefox	CompanyName
Firefox	Carlo
Internet Explorer	Orchestra
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 GIF nello strumento. Innanzitutto, assicurati che la pagina in questione stia effettivamente inviando una richiesta __utm.gif. Se vedi la richiesta, puoi assicurarti che i server di Google Analytics stiano raccogliendo dati da quella pagina. La parte restante di questa sezione fornisce le istruzioni di base per utilizzare l'intestazione HTTP Live e nginx, per darti un'idea di quanto sia facile utilizzare gli strumenti integrati o i componenti aggiuntivi con il tuo browser web.

Utilizzo delle intestazioni HTTP in tempo reale

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

Utilizzo di nginx

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

Scarica e installa PageSpeed per Firefox; riavvia il browser.
Vai al sito.
In Firefox, seleziona Strumenti> nginx > Apri nginx > "Attiva PageSpeed per questo sito web".
Fai clic su Netto, quindi su Immagini.
Ricarica la pagina e verifica che nell'elenco sia visualizzata una nuova richiesta per __utm.gif.
Verifica i componenti della richiesta nella scheda Params.

Torna all'inizio

Debug con ga_debug.js

Oltre alla versione standard di ga.js, il team di Analytics ha implementato 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 relativi alle 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 e di errore quando rileva problemi nel codice di monitoraggio. A questo scopo, stampa i messaggi nell'oggetto window.console. A questo punto, puoi utilizzare uno dei seguenti strumenti per visualizzare questi errori:

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

Per utilizzare lo script ga_debug.js, puoi modificare il riferimento al codice di monitoraggio di una pagina web a cui hai accesso e che puoi modificare. A tale scopo, sostituisci tutti i riferimenti a /ga.js con /u/ga_debug.js nel codice di monitoraggio di tale pagina. Se utilizzi lo script di debug per un sito web su larga scala, ti consigliamo di farlo solo nel tuo ambiente di test. In alternativa, se state eseguendo il debug di un sito più piccolo, vi consigliamo di testare solo le pagine selezionate, anziché l'intero sito.

Importante: non modificare il 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 nel sito di produzione rallenterà il sito per tutti gli utenti. Ribadiamo che questa procedura è finalizzata esclusivamente al test.

Se utilizzi Universal Analytics (analytics.js) per monitorare i tuoi 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 sezione Debug.

Utilizzare lo strumento per il debug del codice di monitoraggio di Google Analytics

Google Analytics Monitoring Code Debugger è un'estensione del browser Chrome che attiva ga_debug.js per te senza richiedere la modifica del codice da parte tua. Probabilmente il modo più semplice per utilizzare ga_debug.js è risolvere i problemi e analizzare il comportamento di monitoraggio per il tuo sito web. È sufficiente attivare questa estensione per verificare l'eventuale 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 [Page Icon] -> Developer -> JavaScript console o premi Ctrl-Maiusc-J.
Su Mac, fai clic su View -> Developer -> JavaScript console o premi Comando-Opzione-J.

Torna all'inizio

Parametri di richiesta GIF

La richiesta di GIF è molto lunga. Ecco un esempio solo di una 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 passati 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 usi questo riferimento, tieni presente che cercherai le variabili più comunemente applicabili alla pagina o alla 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)%75%utmC%3%
utmcn	Avvia una nuova sessione della campagna. In tutte le richieste è 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 si verificano clic successivi sullo stesso link. In tutte le richieste è presente utmcn o utmcr.	utmcr=1
utmcs	Codifica della lingua del browser. Alcuni browser non impostano questa impostazione, nel qual caso è impostata su "-"	utmcs=ISO-8859-1
utmdt	Titolo pagina, che è una stringa con codifica URL.	utmdt=analytics%20page%20test
Ula	Parametro estensibile	Il valore è codificato. Utilizzata per eventi e variabili personalizzate.
utmfl	Versione Flash	utmfl=9.0%20r48&
utmhn	Nome host, che è una stringa con codifica URL.	utmhn=x343.gmodules.com
utmhid	Un numero casuale utilizzato per collegare le richieste di GIF di Analytics a Google AdSense.	utmhid=2059107202
utmipc	Codice prodotto. Si tratta del codice SKU di un determinato prodotto.	utmipc=989898ajssi
utmipn	Nome del prodotto, che è una stringa con codifica URL.	utmipn=tee%20camicia
utmipr	Prezzo unitario. Impostata a livello di articolo. Il valore è impostato su numeri solo nel formato della valuta statunitense.	utmipr=17100.32
utmiqt	Quantità.	utmiqt=4
utmiva	Variazioni su un articolo. Ad esempio: grande, medio, piccolo, rosa, bianco, nero, verde. La stringa è codificata in URL.	utmiva=rosso;
utmje	Indica se il browser è abilitato per Java. 1 è vero.	utmje=1
utmn	ID univoco generato per ogni richiesta GIF per evitare 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=selezionato
utmsc	Profondità colore dello schermo	utmsc=24 bit
utmsr	Risoluzione dello schermo	utmsr=2400 x 1920
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 Unito%20Regno Unito
utmtid	ID ordine, stringa con codifica URL.	utmtid=a2343898
utmtrg	Regione di fatturazione, stringa con codifica URL.	utmtrg=Nuovo%20Brunswick
utmtp	Costo di spedizione. I valori si riferiscono sia all'unità che al prezzo.	utmtp=23,95
utmtst	Affiliazione. Solitamente utilizzato per applicazioni fisiche nell'e-commerce.	utmtst=google%20mtv%20negozio
utmtto	Totale. I valori si riferiscono sia all'unità che al prezzo.	utmtto=334,56
utmttx	Tasse. I valori si riferiscono sia all'unità che al prezzo.	utmttx=29.16
Logo utmul	Lingua del browser.	utmul=pt-br
utmwv	Versione codice di monitoraggio	utmwv=1

Torna all'inizio