Incolla il tuo ID di Misurazione GA4 in Impostazioni → Google Analytics. Il widget inoltra ogni interazione alla tua proprietà esistente, con l'ID dell'agente allegato per il filtraggio.
La maggior parte dei team utilizza già Google Analytics. Ora il tuo widget AI può alimentare direttamente in esso. L'integrazione di Google Analytics ti consente di vedere l'engagement del widget insieme a tutti i tuoi altri dati del sito — negli stessi cruscotti, segmenti e report di cui ti fidi già.
G-XXXXXXXXXX — trovalo in GA4 → Admin → Data Streams → il tuo stream)Ecco fatto. Il widget rileva il nuovo ID al suo prossimo caricamento e inizia a inoltrare eventi. Nessuna modifica al codice del tuo sito. Nessun nuovo script di tracciamento da gestire. Solo gli amministratori e i proprietari possono cambiare l'ID.
Quando lo script di incorporamento si avvia, il widget gli dice quale proprietà GA4 inviare tramite un WIDGET_GA_INIT postMessage. Lo script di incorporamento quindi:
window.gtag se è già presente nella pagina — nessuna doppia inizializzazione, nessuna chiamata config in conflittogtag.js da googletagmanager.com e lo inizializza con il tuo ID di Misurazionesend_to: <tuo-id-di-misurazione> in modo che gli eventi atterrino sempre nella proprietà giusta, anche su siti con più stream GACinque interazioni del widget diventano eventi GA4:
| Evento | Nome GA4 | Parametri extra |
|---|---|---|
| Widget aperto | widget_open | agent_id |
| Widget chiuso | widget_close | agent_id |
| Messaggio inviato | widget_message_sent | agent_id, message_length |
| Risposta AI ricevuta | widget_response_received | agent_id |
| Errore verificatosi | widget_error | agent_id, error_type |
Ogni evento porta agent_id in modo da poter filtrare per agenti specifici in GA4 — utile se gestisci più agenti in un'organizzazione. message_length (un numero di caratteri) ti consente di distinguere tra query brevi e dettagliate senza catturare il contenuto del messaggio. error_type etichetta gli errori per categoria (rete, autenticazione, limite di velocità) per cruscotti diagnostici.
Il contenuto dei messaggi non viene mai inviato a Google Analytics. Solo i metadati viaggiano: tipo di evento, ID agente, lunghezze numeriche e categorie di errore. Il widget esegue GA all'interno del contesto della tua pagina, quindi il tuo banner di consenso ai cookie esistente e i meccanismi di conformità GDPR controllano se il tracciamento si attiva — esattamente come fanno per il resto del tuo sito.
Se il tuo sito carica già GA4, il widget rileva window.gtag e lo utilizza direttamente. In caso contrario, carica gtag.js utilizzando il tuo ID di Misurazione. In entrambi i casi, gli eventi atterrano nella stessa proprietà GA4 con lo stesso contesto di sessione del resto del tuo sito — quindi le interazioni del widget appaiono naturalmente nei tuoi percorsi utente, funnel di conversione e segmenti di pubblico.
Una volta che gli eventi fluiscono:
widget_open per vedere l'engagement del widget giornaliero/settimanalewidget_open → widget_message_sent → il tuo evento di conversione, per misurare quanti chatter si convertonoagent_id per confrontare gli agenti fianco a fiancosend_to che corrisponde al tuo ID di Misurazione)I dati di engagement del widget sono sempre esistiti nel tuo cruscotto Companin. Questa integrazione li rende parte del tuo quadro analitico più ampio — attribuiti alle stesse sessioni, agli stessi utenti e agli stessi obiettivi di tutto ciò che misuri. Niente più passaggi tra strumenti per capire se il widget aiuta a convertire i visitatori.