Configurare i parametri evento

Questa guida mostra come configurare i parametri per gli eventi consigliati e quelli per gli eventi 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.

Sul tuo sito web, puoi utilizzare il tag Google (gtag.js) o Google Tag Manager. Se vuoi configurare 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

Ti consigliamo inoltre di leggere l'articolo Configurare gli eventi prima di leggere questa guida.

Informazioni sui parametri evento

I parametri forniscono informazioni aggiuntive sui modi in cui gli utenti interagiscono con il tuo sito web. Ad esempio, quando un utente visualizza un prodotto che vendi, puoi includere parametri che descrivono il prodotto visualizzato, come nome, categoria e prezzo.

Gli eventi di misurazione avanzata e raccolti automaticamente includono parametri per impostazione predefinita. Google fornisce anche un set di parametri obbligatori e facoltativi da includere in ogni evento consigliato. Inoltre, puoi aggiungere altri parametri evento quando ne hai bisogno.

Configurare i parametri evento

Gli eventi hanno la seguente struttura, in cui <event_parameters> sono i tuoi parametri, 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 parametro evento

Configurare i parametri per tutti gli eventi

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 i parametri a ogni evento sulla pagina.

L'istruzione seguente imposta il titolo della pagina e invia il parametro con ogni evento sulla 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': 'Travel Destinations',
  'currency': 'USD'
});
</script>

Se aggiungi più di un ID tag alla pagina, aggiungi un comando set anziché aggiornare il comando config in modo che tutti gli ID ereditino i parametri impostati. Inserisci 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 gli 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 attivati dagli utenti sul tuo sito web quando vengono attivati.

Alcuni parametri completano automaticamente dimensioni e 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.

Altri parametri richiedono la creazione di dimensioni e metriche personalizzate per visualizzare i valori dei parametri in Google Analytics. Ogni volta che crei un parametro personalizzato, devi creare una dimensione o una metrica personalizzata corrispondente in modo da poter visualizzare i dati.

Passaggi successivi

Crea dimensioni e metriche personalizzate per i tuoi parametri evento personalizzati.