Collega Novaco a Google Analytics

    Inoltra gli eventi del tuo assistente virtuale a Google Tag Manager o Google Analytics 4 e crea report su conversazioni, lead e appuntamenti.

    Due metodi

    Esistono due modi per collegare i dati di Novaco a Google Analytics. Scegline uno — non eseguirli mai in parallelo.

    Quali eventi sono disponibili? Consulta il riferimento degli eventi di Google Analytics.

    Collega con Google Tag Manager

    GTM distribuisce gli eventi a terze parti tramite i tag. Per farlo, fornisci i dati nel cosiddetto "data layer". Aggiungi un listener per ogni evento che vuoi utilizzare.

    Esempio: un evento

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    Esempio: più eventi

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        dataLayer.push({
          "event": e.type,
          "autochat_event_details": e.detail.eventData
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    Il try-catch è una gestione degli errori opzionale — puoi lasciarlo così com'è.

    Crea le variabili del data layer

    Oltre agli eventi, Novaco fornisce dati aggiuntivi come session_id, chat_type e appointment_type. Crea una variabile per ciascuno.

    1. Vai al tuo container GTM.
    2. Vai su Variabili e fai clic su "Nuova" sotto "Variabili definite dall'utente".
    3. Scegli "Variabile del data layer" come tipo di variabile.
    4. Assegna un nome chiaro, ad esempio "Novaco – session_id".
    5. Come nome della variabile del data layer, inserisci il nome della variabile Novaco.
    6. Fai clic su Salva.

    Collega gli eventi a trigger e tag

    Crea un trigger per ogni evento su cui vuoi agire, quindi combina trigger e variabili in un tag GA4.

    Crea un trigger

    1. Vai al tuo container GTM.
    2. Vai su Trigger e fai clic su "Nuovo".
    3. Scegli il tipo di trigger "Evento personalizzato".
    4. Assegna un nome chiaro, ad esempio "Novaco – Lead creato".
    5. Usa il nome dell'evento Novaco come nome dell'evento.
    6. Fai clic su Salva.

    Crea il tag GA4

    1. Vai su Tag e fai clic su "Nuovo".
    2. Scegli il tipo di tag "Google Analytics: evento GA4".
    3. Assegna un nome chiaro, ad esempio "GA4 – Eventi Novaco".
    4. Inserisci il tuo ID misurazione oppure collegalo alla configurazione del tuo tag di Google.
    5. Inserisci {{Event}} come nome dell'evento.
    6. In "Parametri evento", aggiungi le variabili Novaco come parametri.
    7. Fai clic su Salva.

    Ogni trigger di eventi Novaco che aggiungi ora invia automaticamente i suoi dati a GA4. Gli stessi elementi possono essere utilizzati per altri tag, come una conversione lead di Google Ads.

    Collega direttamente a Google Analytics 4

    Non hai un tag manager? Usa l'implementazione del tag di Google (gtag.js). Non eseguire mai questa configurazione in parallelo con Google Tag Manager — se usi GTM, segui invece la guida qui sopra.

    1. Configura il tuo tag di Google

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

    Sostituisci G-12345678 con il tuo ID misurazione.

    2. Aggiungi il monitoraggio degli eventi Novaco

    Aggiungi questo snippet dopo la chiamata a gtag('config', ...).

    <script>
    window.addEventListener('autochat_lead_created', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'appointment_type': e.detail.eventData.appointment_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    window.addEventListener('autochat_chat_first_user_interaction', function (e) {
      try {
        gtag('event', e.type, {
          'session_id': e.detail.eventData.session_id,
          'chat_type': e.detail.eventData.chat_type
        });
      } catch(e) {
        // Your error handling if relevant
      }
    });
    </script>

    e.type si risolve automaticamente nel nome dell'evento, ad esempio autochat_lead_created. Questo è anche il nome dell'evento che vedrai in GA4. Tutto ciò che segue sono i parametri dell'evento.

    Dimensioni personalizzate GA4

    Per creare report sui parametri degli eventi, registrali come dimensioni personalizzate in GA4.

    1. Vai all'amministrazione della tua proprietà GA4.
    2. Vai su "Definizioni personalizzate".
    3. Vai su "Dimensioni personalizzate" e fai clic su "Crea dimensione personalizzata".
    4. Usa un nome descrittivo per la dimensione, ad esempio "Novaco chat open type".
    5. Imposta l'ambito su "Evento".
    6. Come parametro evento, usa il nome della variabile che hai utilizzato nel tag GA4, ad esempio chat_open_type.

    analyticsSetup.dimensions.note

    Cerchi l'elenco degli eventi?

    Ogni evento, quando viene attivato e quali dati contiene.

    Visualizza il riferimento degli eventi