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 utilizza 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 di quelle che Analytics raccoglie automaticamente o vuoi 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 Editor per l'account Google Analytics

Panoramica del tag Google (gtag.js)

Utilizza l'API del tag Google (gtag.js) per inviare eventi a Google Analytics. L'API ha una funzione chiamata gtag() e ogni volta che vuoi inviare un evento a Google Analytics, utilizzi 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 ulteriori informazioni sull'evento

Ad esempio, il seguente è un evento consigliato chiamato screen_view con due parametri:

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

Aggiungere eventi a JavaScript

gtag() è una funzione JavaScript, quindi devi aggiungerla al codice JavaScript della tua pagina web. Ad esempio, puoi aggiungere la funzione all'interno dei tag <script> o in un file JavaScript separato che importi nella pagina HTML.

Puoi aggiungere eventi al tuo JavaScript in qualsiasi punto sotto lo snippet del tag Google. Google non elaborerà i dati degli eventi che inserisci sopra lo snippet del tag Google. Ad esempio, il seguente codice di esempio include un evento chiamato screen_view all'interno di 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 a un clic sul pulsante (o a un'altra azione dell'utente), puoi aggiungere altro codice JavaScript all'evento.

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.

Passaggi successivi