Configurare gli eventi

Gli eventi ti consentono di misurare le interazioni degli utenti sul tuo sito web o nella tua app. Ad esempio, puoi misurare quando un utente carica una pagina, fa clic su un link ed effettua un acquisto. Google Analytics usa i dati degli eventi per creare report con informazioni sulla tua attività. Scopri di più

Questa guida mostra come configurare gli eventi consigliati e gli eventi personalizzati sul tuo sito web utilizzando il tag Google (gtag.js) o Google Tag Manager. Non è necessario configurare gli eventi raccolti automaticamente e di misurazione avanzata.

Pubblico

Hai configurato Google Analytics e stai iniziando a visualizzare i dati nei report, ma vuoi raccogliere più informazioni rispetto a quelle raccolte automaticamente da Analytics oppure sbloccare determinate funzionalità in Analytics.


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 di Editor per l'account Google Analytics

Configurare gli eventi

Utilizza l'API gtag.js per inviare eventi a Google Analytics. L'API ha una funzione denominata gtag() e ogni volta che vuoi inviare un evento a Google Analytics, utilizza la seguente sintassi:

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

In questo esempio, la funzione gtag() include quanto segue:

  • Un comando event che comunica a Google che stai inviando un evento
  • Il nome dell'evento consigliato o personalizzato
  • (Facoltativo) Una raccolta di parametri che forniscono informazioni aggiuntive sull'evento

Ad esempio, di seguito è riportato un evento consigliato denominato screen_view con due parametri:

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

Aggiungi eventi a JavaScript

gtag() è una funzione JavaScript, quindi devi aggiungerla a JavaScript sulla tua pagina web. Ad esempio, puoi aggiungere la funzione all'interno dei tag <script> o in un file JavaScript separato da importare nella pagina HTML.

Puoi aggiungere eventi a JavaScript in qualsiasi punto sotto lo snippet del tag Google. Google non elaborerà i dati degli eventi che posizioni sopra lo snippet del tag Google. Ad esempio, il seguente codice di esempio include un evento denominato screen_view in un tag <script>:

<!DOCTYPE html>
<html lang="en">
<head>
    <!-- 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');
    </script>

    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Title of the page</title>
</head>
<body>
    <p>Welcome to my website!</p>
    
    <script>
      /**
      * The following event is sent when the page loads. You could
      * wrap the event in a JavaScript function so the event is
      * sent when the user performs some action.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
    </script> 
</body>
</html>

Se vuoi inviare l'evento in base al clic su un pulsante (o a un'altra azione dell'utente), puoi aggiungere altro codice JavaScript all'evento.

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 alcune configurazioni aggiuntive prima di poter essere utilizzato. Questi due report mostrano gli eventi attivati dagli utenti sul tuo sito web quando questi eventi vengono attivati.

Passaggi successivi