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ù

Tipi di evento

Gli eventi Google Analytics sono raggruppati in quattro categorie:

Tipo di evento Link È necessaria la configurazione? Descrizione e caso d'uso
Raccolti automaticamente Scopri di più No Raccolti per impostazione predefinita quando configuri il tag Google Analytics sul tuo sito o nella tua app. Alcuni esempi includono first_visit, session_start e user_engagement.
Misurazione avanzata Scopri di più No (in genere) Raccolti automaticamente quando la misurazione avanzata è attivata nell'interfaccia utente di GA4. Misura le interazioni web comuni come scroll, click e file_download.
Consigliato Riferimento agli eventi consigliati Sì Eventi standardizzati per diverse verticali di attività (ad es. vendita al dettaglio, viaggi, giochi) che sbloccano pannelli di report predefiniti. Esempi: purchase, login, sign_up.
Personalizzato Scopri di più Sì Eventi che definisci personalmente perché nessun evento automatico, avanzato o consigliato precompilato soddisfa le tue esigenze. Accessibile tramite i report personalizzati.

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 o superiore 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, 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 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 campione include un evento consigliato chiamato screen_view e un evento personalizzato chiamato signup_newsletter 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 events are sent when the page loads. You send
      *   recommended and custom events the same way. You could wrap
      *   the events in JavaScript functions so they are sent when
      *   users perform specific actions.
      */
      gtag('event', 'screen_view', {
        'app_name': 'myAppName',
        'screen_name': 'Home'
      });
      gtag('event', 'signup_newsletter', {
        'method': 'web'
      });
    </script> 
</body>
</html>

Se vuoi inviare l'evento in base a un clic sul pulsante (o a un'altra azione dell'utente), puoi aggiungere del codice JavaScript aggiuntivo 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

Indietro
Web
Avanti
Aggiungi parametri