Configurare i parametri evento

Questa guida mostra come configurare i parametri per gli eventi consigliati e personalizzati sul tuo sito web in modo da poter raccogliere più informazioni dagli eventi. Per informazioni su come aggiungere parametri basati sugli articoli, consulta Misurare l'e-commerce.

Pubblico

Vuoi raccogliere ulteriori informazioni sull'attività dei tuoi utenti tramite gli eventi che hai già configurato.

Utilizzi il tag Google (gtag.js) o Google Tag Manager sul tuo sito web. Se vuoi configurare i parametri evento per un'app mobile, consulta Eventi dei log.


Prima di iniziare

Questa guida presuppone che tu abbia:

Si presume inoltre che tu disponga di quanto segue:

  • Accesso al codice sorgente del tuo sito web
  • Ruolo Editor (o superiore) per l'account Google Analytics

Prima di leggere questa guida, ti consigliamo di leggere anche Configurare gli eventi.

Informazioni sui parametri evento

I parametri forniscono informazioni aggiuntive sulle modalità di interazione degli utenti con il tuo sito web. Ad esempio, quando un utente visualizza un prodotto che vendi, puoi includere parametri che descrivono il prodotto che ha visualizzato, come nome, categoria e prezzo.

Gli eventi di misurazione avanzata e raccolti automaticamente includono parametri per impostazione predefinita. Google fornisce inoltre un insieme di parametri obbligatori e facoltativi da includere in ogni evento consigliato. Inoltre, puoi aggiungere altri parametri evento quando ti servono.

Configurare i parametri evento

Gli eventi hanno la seguente struttura, in cui <event_parameters> sono i parametri evento, scritti come coppie chiave/valore:

gtag('event', '<event_name>', {
  <event_parameters>
});

Considera l'esempio seguente:

gtag('event', 'screen_view', {
  'app_name': 'myAppName',
  'screen_name': 'Home'
});

In questo esempio:

  • app_name e screen_name sono nomi di parametri evento
  • myAppName e Home sono valori dei parametri evento

Impostare i parametri per ciascun evento

Gli esempi nella sezione precedente utilizzano il comando event in una funzione gtag() per inviare i parametri per un evento. Puoi anche aggiornare il comando config nello snippet del tag Google (nel tag HTML <head>) per inviare parametri con ogni evento sulla pagina.

Il seguente codice imposta il titolo della pagina e poi invia il parametro con ogni evento nella pagina:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());

gtag('config', 'G-XXXXXXXXXX', {
  'page_title': 'Contact Us',
  'currency': 'EUR'
});
</script>

Se aggiungi più di un ID tag alla pagina, utilizza il comando set per i parametri globali documentati (come user_id, page_title, currency) in modo che tutti gli ID ereditino i valori. Posiziona il comando set sopra il comando config.

gtag('set', {
  'page_title': 'Travel Destinations',
  'currency': 'USD'
});
// Place your config commands after the set command like follows
gtag('config', 'G-XXXXXXXXXX-1');
gtag('config', 'G-XXXXXXXXXX-2');
gtag('config', 'G-XXXXXXXXXX-3');

Visualizzare gli eventi in Analytics

Puoi visualizzare i tuoi eventi e i relativi parametri utilizzando i report In tempo reale e DebugView. Tieni presente che il report DebugView richiede una configurazione aggiuntiva prima di poter essere utilizzato. Questi due report mostrano gli eventi man mano che vengono attivati dagli utenti sul tuo sito web.

Verifica in DebugView

Quando utilizzi il report DebugView, i parametri definiti con gtag('set') vengono applicati a tutte le successive chiamate gtag('event') nella pagina. Per verificare, assicurati che il comando gtag('set') venga eseguito prima dell'attivazione dell'evento. Poi, seleziona un evento in DebugView ed esamina la scheda Parametri per visualizzare l'elenco unito dei parametri, inclusi quelli impostati a livello globale.

Alcuni parametri completano automaticamente le dimensioni e le metriche predefinite in Google Analytics. Ad esempio, i parametri degli eventi di misurazione avanzata e raccolti automaticamente, nonché i parametri obbligatori e facoltativi che invii con gli eventi consigliati, completano le dimensioni e le metriche predefinite.

Per altri parametri è invece necessario creare metriche e dimensioni personalizzate per poter visualizzare i valori parametro in Google Analytics.

Passaggi successivi

Crea dimensioni e metriche personalizzate per i parametri evento personalizzati.

Indietro
Configurare gli eventi
Avanti
Inviare gli ID utente