Incolla il tuo ID di misurazione GA4 nelle Impostazioni → Google Analytics. Il widget inoltra ogni interazione alla tua proprietà esistente, con l'ID agente allegato per il filtraggio.
La maggior parte dei team utilizza già Google Analytics. Ora il tuo widget AI può alimentarlo direttamente. L'integrazione di Google Analytics ti consente di vedere il coinvolgimento del widget insieme a tutti i tuoi altri dati del sito: negli stessi dashboard, 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 conflitto.gtag.js da googletagmanager.com e lo inizializza con il tuo ID di misurazione.send_to: <your-measurement-id> in modo che gli eventi atterrino sempre nella proprietà giusta, anche su siti con più stream GA.Cinque 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 così puoi filtrare per agenti specifici in GA4: utile se gestisci diversi agenti in un'unica 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, autorizzazione, limite di velocità) per dashboard diagnostiche.
Il contenuto del messaggio 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 scorrono:
widget_open per vedere il coinvolgimento giornaliero/settimanale del widget.widget_open → widget_message_sent → il tuo evento di conversione, per misurare quanti chatter si convertono.agent_id per confrontare gli agenti fianco a fianco.send_to che corrisponde al tuo ID di misurazione).I dati di coinvolgimento del widget sono sempre esistiti nel tuo dashboard 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.