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.

Confronti di sintassi

Questo documento mostra illustrazioni del codice di monitoraggio per una serie di personalizzazioni di monitoraggio più comuni. Se lo snippet di monitoraggio di Google Analytics contiene il markup urchin.js o la sintassi ga.js tradizionale, utilizza questa guida per eseguire la migrazione del monitoraggio allo snippet asincrono migliorato.

Migrazione al monitoraggio asincrono

Come best practice, prima copia e salva le personalizzazioni esistenti del codice di monitoraggio in un file di testo (non in un documento di elaboratore di testi). Con una copia di backup, puoi assicurarti di aver eseguito la migrazione di tutte le personalizzazioni del sito.

Per convertire le tue pagine in modo da utilizzare lo snippet asincrono:

Rimuovi lo snippet di codice di monitoraggio esistente ed eventuali personalizzazioni che hai apportato.
Per ridurre gli errori, ti consigliamo di rimuovere lo snippet di codice di monitoraggio esistente dal file di inclusione o dal meccanismo che lo inserisce nelle pagine web. Puoi incollare lo snippet di codice di monitoraggio esistente in un file di testo per monitorare i metodi personalizzati utilizzati.
Inserisci lo snippet asincrono nella parte inferiore della sezione <head> delle pagine, dopo qualsiasi altro script eventualmente utilizzato dalla pagina o dal modello.
Uno dei principali vantaggi dello snippet asincrono è la possibilità di posizionarlo nella parte superiore del documento HTML. Ciò aumenta le probabilità che il beacon di monitoraggio venga inviato prima che l'utente lasci la pagina. Abbiamo stabilito che nella maggior parte delle pagine la posizione ottimale per lo snippet asincrono si trova in fondo alla sezione <head>, subito prima del tag di chiusura </head>.
Modifica il metodo _setAccount con il tuo ID proprietà web.

Per ulteriori informazioni sugli ID proprietà web, consulta la sezione "Proprietà web" nel documento Account e viste (profili).
Aggiungi di nuovo le personalizzazioni utilizzando la sintassi asincrona. Utilizza le personalizzazioni descritte nel resto di questa guida. Per informazioni dettagliate sul codice di monitoraggio asincrono, consulta la guida all'utilizzo del monitoraggio asincrono.

Nota:per garantire il funzionamento più semplice dello snippet asincrono rispetto ad altri script, ti consigliamo di posizionare gli altri script nel sito procedendo in uno dei seguenti modi:

Prima dello snippet del codice di monitoraggio nella sezione <head> del codice HTML
Dopo lo snippet del codice di monitoraggio e i contenuti di tutti i contenuti della pagina (ad es. nella parte inferiore del corpo HTML)

Se non è possibile, puoi comunque inserire lo snippet asincrono in fondo alla pagina. Puoi anche suddividere lo snippet per conservare alcuni dei vantaggi del monitoraggio asincrono.

Monitoraggio pagine di base

Il monitoraggio di base delle pagine è lo strumento migliore per acquisire familiarità con la sintassi asincrona. Questi esempi impostano l'oggetto di monitoraggio con l'account corretto e richiamano il metodo di monitoraggio della pagina.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-XXXXX-X";
urchinTracker();

Torna all'inizio

Rilevamento delle impostazioni del browser

Questi esempi illustrano le personalizzazioni delle impostazioni del browser, come la disattivazione del rilevamento Flash, la disattivazione del rilevamento di nome/versione del browser e così via.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setClientInfo', false]);
_gaq.push(['_setAllowHash', false]);
_gaq.push(['_setDetectFlash', false]);
_gaq.push(['_setDetectTitle', false]);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setClientInfo(false);
pageTracker._setAllowHash(false);
pageTracker._setDetectFlash(false);
pageTracker._setDetectTitle(false);
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-XXXXX-X";
_ufsc = 0;    // track browser info
_uhash = "on"; // (on|off) unique domain hash for cookies
_uflash = 0;  // detect Flash version
_utitle = 0;  // track title in reports
urchinTracker();

Torna all'inizio

Durata campagna

Per impostazione predefinita, la durata di una campagna Google Ads è impostata su 6 mesi. Puoi modificare la durata delle campagne utilizzando il metodo _setCampaignCookieTimeout().

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignCookieTimeout', 31536000000]);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignCookieTimeout(31536000000);
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-XXXXX-X";
_ucto = "31536000"; // the number of seconds in 1 year
urchinTracker();
</script>

Torna all'inizio

Campi campagna - Personalizzato

Google Analytics raccoglie automaticamente i dati Google Ads se hai collegato l'account Google Ads all'account Analytics. Per monitorare i link alle parole chiave provenienti da altre fonti pubblicitarie o da campagne email o simili, puoi creare campi di campagne personalizzate utilizzando i metodi indicati di seguito. Per ulteriori dettagli, consulta la sezione "Monitoraggio delle campagne" nella guida Sorgenti di traffico.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampNameKey', 'ga_campaign']);    // name
_gaq.push(['_setCampMediumKey', 'ga_medium']);    // medium
_gaq.push(['_setCampSourceKey', 'ga_source']);    // source
_gaq.push(['_setCampTermKey', 'ga_term']);        // term/keyword
_gaq.push(['_setCampContentKey', 'ga_content']);  // content
_gaq.push(['_setCampNOKey', 'ga_nooverride']);    // don't override
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampNameKey('ga_campaign');       // name
pageTracker._setCampMediumKey('ga_medium');       // medium
pageTracker._setCampSourceKey('ga_source');       // source
pageTracker._setCampTermKey('ga_term');           // term/keyword
pageTracker._setCampContentKey('ga_content');     // content
pageTracker._setCampNOKey('ga_nooverride');       // don't override
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_uccn = "ga_campaign"; // name [default: utm_campaign]
_ucmd = "ga_medium"; // medium [default: utm_medium]
_ucsr = "ga_source"; // source [default: utm_source]
_uctr = "ga_term"; // term/keyword [default: utm_term]
_ucct = "ga_content"; // content [default: utm_content]
_ucid = "ga_id"; // id number [default: utm_id]
_ucno = "ga_nooverride"; // don't override [default: utm_nooverride]
urchinTracker();

Torna all'inizio

Monitoraggio campagna - Disattivato

Google Analytics attiva automaticamente il monitoraggio delle campagne, ma puoi disattivarlo utilizzando il metodo _setCampaignTrack().

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCampaignTrack', false]);    // Turn off campaign tracking
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCampaignTrack(false);       // Turn off campaign tracking
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_uctm = "disable";
urchinTracker();

Torna all'inizio

Collegamento interdominio

Per monitorare il traffico tra due domini, puoi utilizzare la funzione _setAllowLinker() per monitorare i clic degli utenti tra due domini. Per maggiori dettagli sulla configurazione del monitoraggio interdominio, consulta Monitoraggio interdominio.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<a href="http://example.com/test.html"
onclick="pageTracker._link('http://example.com/test.html'); return false;">click me</a>

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();

...
<a href="http://newsite.com/test.html"
onclick="__utmLinker('http://newsite.com/test.html'); return false;">click me</a>

Torna all'inizio

Dati dei moduli interdominio

Puoi utilizzare il metodo _linkByPost() per passare i dati utente da un dominio a un altro se il monitoraggio interdominio è abilitato per entrambi i domini. Per maggiori dettagli sulla configurazione del monitoraggio interdominio, consulta Monitoraggio interdominio.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
...
<form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setDomainName('none');
pageTracker._setAllowLinker(true);
pageTracker._trackPageview();
...
<form name="f" method="post" onsubmit="pageTracker._linkByPost(this);">
...
</form>

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_udn = "none";
_ulink = 1;
urchinTracker();
...
<form name="f" method="post" onsubmit="__utmLinkPost(this)">
...
</form>

Torna all'inizio

Monitoraggio e-commerce

Il monitoraggio e-commerce comporta la chiamata di tre metodi principali nella configurazione del monitoraggio. Per informazioni dettagliate, consulta Monitoraggio e-commerce.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
_gaq.push(['_addTrans',
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
]);
_gaq.push(['_addItem',
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
]);
_gaq.push(['_trackTrans']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
pageTracker._addTrans(
  '1234',           // order ID - required
  'Mountain View',  // affiliation or store name
  '11.99',          // total - required
  '1.29',           // tax
  '5',              // shipping
  'San Jose',       // city
  'California',     // state or province
  'USA'             // country
);
pageTracker._addItem(
  '1234',           // order ID - required
  'DD44',           // SKU/code
  'T-Shirt',        // product name
  'Green Medium',   // category or variation
  '11.99',          // unit price - required
  '1'               // quantity - required
);
pageTracker._trackTrans();

Monitoraggio urchin.js

_uacct = "UA-12345-1";
urchinTracker();
</script>
<form name="utmform" id="utmform">
<textarea name="utmtrans" id="utmtrans" style="display:none">
UTM:T|1234|Mountain View|11.99|1.29|5|San Jose|California|USA
UTM:I|1234|DD44|T-Shirt|Green Medium|11.99|1
</textarea>
</form>
<script type="text/javascript">
__utmSetTrans();

Torna all'inizio

Monitoraggio eventi

Il monitoraggio eventi comporta l'esecuzione di una chiamata a un evento nel punto appropriato delle pagine, ad esempio in un gestore onclick. Per ulteriori informazioni sul monitoraggio eventi, consulta la Guida al monitoraggio eventi. Nota: il monitoraggio eventi non è disponibile con il codice di monitoraggio urchin.js.

Snippet asinc (consigliato)

Questa sezione mostra due modi per impostare il monitoraggio utilizzando la sintassi asincrona. Con il monitoraggio eventi, il gestore onclick utilizza la stessa sintassi.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_trackPageview']);
...
<a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview();
...
<a onclick="pageTracker._trackEvent('category', 'action', 'opt_label', opt_value);">click me</a>

Torna all'inizio

Timeout sessione

Per impostazione predefinita, le sessioni utente scadono dopo 30 minuti di inattività sul tuo sito. Questi esempi mostrano come è possibile modificare questo valore utilizzando il metodo _setSessionCookieTimeout().

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setSessionCookieTimeout', 3600000]);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setSessionCookieTimeout(3600000);
pageTracker._trackPageview();

Monitoraggio urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utimeout = "3600"; // the number of seconds in 1 hour
urchinTracker();
</script>

Torna all'inizio

Sorgenti: motori di ricerca, parole chiave, referrer

Per impostazione predefinita, Google Analytics identifica un elenco di siti web come referral dei motori di ricerca nei report. Puoi utilizzare questi metodi per modificare l'elenco dei motori di ricerca. Per ulteriori informazioni, consulta "Motori di ricerca" nella guida Sorgenti di traffico. Puoi anche configurare Google Analytics in modo da ignorare i referral provenienti da determinati domini o per trattare specifiche ricerche di parole chiave come traffico diretto.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_addIgnoredOrganic', 'ignore']);
_gaq.push(['_addIgnoredRef', 'urchin.com']);
_gaq.push(['_addOrganic', 'new_search_engine', 'q']);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._addIgnoredOrganic('ignore');
pageTracker._addIgnoredRef('urchin.com');
pageTracker._addOrganic('new_search_engine','q');
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_uOno[0] = "ignore"; // keyword to treat as referral
_uRno[0] = "urchin.com"; // referral to treat as direct
_uOsr[41] = "new_search_engine"; // new search engine to treat as referral
_uOkw[41] = "query"; // keyword query parameter for new search engine

urchinTracker();

Torna all'inizio

Monitoraggio limitato a una directory secondaria

Utilizza il metodo _setCookiePath() per impostare una sottodirectory come percorso predefinito per tutto il monitoraggio. Questa opzione ti consente di limitare il monitoraggio a una sottodirectory di un sito.

Snippet asinc (consigliato)

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setCookiePath', '/path/of/cookie/']);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setCookiePath('/path/of/cookie/');
pageTracker._trackPageview();

Monitoraggio urchin.js

<script type="text/javascript">
_uacct = "UA-12345-1";
_utcp = "/path/of/cookie/";
urchinTracker();
</script>

Torna all'inizio

Utilizzo di un server locale

Utilizza questi metodi se stai monitorando il tuo sito web con il software autonomo Looker e anche con Google Analytics. Per maggiori dettagli, consulta la sezione Server Urchin nel riferimento dell'API di monitoraggio.

Snippet asincrono

_gaq.push(['_setAccount', 'UA-XXXXX-X']);
_gaq.push(['_setLocalRemoteServerMode']);
_gaq.push(['_trackPageview']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._setLocalRemoteServerMode();
pageTracker._trackPageview();

Monitoraggio urchin.js

_uacct = "UA-12345-1";
_userv = 0;
urchinTracker();

Torna all'inizio

Visualizzazioni di pagina virtuali

Utilizza il metodo _trackPageview() insieme a un URL creato da te per monitorare i clic degli utenti che non rimandano a pagine vere e proprie del sito web. In generale, ti consigliamo di utilizzare il monitoraggio degli eventi per monitorare download, link in uscita, PDF o tipi di interazioni simili degli utenti. Infatti, le visualizzazioni di pagina virtuali si aggiungono al numero totale di visualizzazioni di pagina.

Snippet asincrono

_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);

Snippet tradizionale (ga.js)

var pageTracker = _gat._getTracker('UA-XXXXX-X');
pageTracker._trackPageview('/downloads/pdfs/corporateBrief.pdf');

Monitoraggio urchin.js

urchinTracker('/downloads/pdfs/corporateBrief.pdf');

Torna all'inizio