# Analisi del traffico web

Monitora le app Opser e altri siti, comprendi le metriche del traffico e verifica privacy e accesso.

Source: https://docs.opser.com/it/capabilities/analytics/

## Misurare il traffico del sito

Analytics mostra visitatori, visualizzazioni di pagina, sorgenti di traffico, campagne, paesi, dispositivi ed eventi personalizzati dei tuoi siti. Apri **Analytics** dalle app dello spazio di lavoro per scegliere un sito ed esplorare la sua dashboard. Se l'app non è presente, installala dall'App Store o chiedi a un amministratore.

Il monitoraggio deve essere disponibile nella regione dello spazio di lavoro. Analytics inizia a raccogliere dati quando attivi il monitoraggio; aggiungere un sito non recupera il traffico precedente.

## Attivare il monitoraggio di un'app Opser

Apri un'[app esterna](https://docs.opser.com/it/capabilities/external-apps/) pubblicata, seleziona la sezione **Analytics** e attiva il monitoraggio. Opser aggiunge automaticamente il codice di monitoraggio: non occorre modificare il codice o ripubblicare. Puoi trovare le app Opser dello spazio di lavoro e i relativi interruttori anche in **Aggiungi sito** in Analytics.

Apri la dashboard del sito in Analytics per vedere il traffico. Disattiva il monitoraggio dalla pagina dell'app esterna quando vuoi interrompere la raccolta. I domini monitorati seguono quelli dell'app.

## Collegare un sito ospitato altrove

In Analytics, scegli **Aggiungi sito**, inserisci un nome e i domini da monitorare e crea il sito. Apri la configurazione o le impostazioni del sito per copiare lo snippet di monitoraggio. Incolla lo snippet esatto nell'head di ogni pagina o nel layout condiviso, poi pubblica le modifiche. Lo snippet contiene l'identificatore del sito e l'indirizzo corretto del servizio di raccolta.

In alternativa, scegli **Copia prompt** sotto **Lascia che il tuo agente IA lo configuri** e consegnalo a un agente che può modificare il codice del sito. Il prompt include lo snippet e le istruzioni di installazione. Chiedi all'agente di mostrare le modifiche e verificare il sito pubblicato.

Visita il sito pubblico con un normale browser. La dashboard attende la prima visita registrata; le visite da localhost e dai browser automatizzati vengono ignorate. Non installare un secondo snippet su un'app Opser con il monitoraggio già attivo.

## Comprendere le metriche

Scegli un periodo e confrontalo con il precedente della stessa durata. Le date seguono il fuso orario dello spazio di lavoro, impostato in **Impostazioni → Organizzazione**. Fai clic su una pagina, sorgente, campagna, paese o dispositivo per filtrare la dashboard.

| Metrica | Significato |
| --- | --- |
| Visitatori | Conteggi anonimi giornalieri per dispositivo e browser. Una persona che torna domani viene contata nuovamente; non è un conteggio di persone uniche. |
| Visite | Gruppi di attività che terminano dopo 30 minuti senza eventi. |
| Visualizzazioni di pagina | Caricamenti registrati e cambi di navigazione supportati nelle applicazioni a pagina singola. |
| Pagine per visita | Media delle visualizzazioni di pagina per visita. |
| Frequenza di rimbalzo | Percentuale di visite con una sola visualizzazione di pagina e nessun altro evento. |
| Durata della visita | Tempo medio tra il primo e l'ultimo evento registrato di una visita. Una visita con un solo evento ha durata zero. |
| Visitatori in tempo reale | Visitatori registrati negli ultimi cinque minuti. |

I dati dettagliati coprono gli ultimi 13 mesi. Gli agenti possono leggere anche i riepiloghi mensili precedenti. Le query estese possono utilizzare dati campionati; considera come stime le metriche indicate come approssimative.

## Privacy e accesso

Il codice di monitoraggio non usa cookie o memoria del browser per identificare i visitatori. Gli indirizzi IP servono a determinare il paese e generare un codice anonimo giornaliero, poi vengono scartati. Il codice cambia ogni giorno ed è specifico per ciascun sito. Le statistiche restano nella regione dello spazio di lavoro. I bot noti sono esclusi.

Non inserire dati personali nei nomi e nelle proprietà degli eventi personalizzati. Consulta **Analytics → Impostazioni** per la spiegazione sulla privacy e la soglia di visualizzazioni di pagina inclusa.

Il permesso `analytics.view` consente di leggere siti e statistiche; `analytics.manage` consente di gestire i siti monitorati. I controlli delle app esterne richiedono `external-apps.manage`. Anche l'agente deve avere accesso all'app Analytics. Un amministratore gestisce i permessi in [Impostazioni → Permessi](https://docs.opser.com/it/workspace/permissions/).

## Chiedere all'agente informazioni sul traffico

> Confronta il traffico del nostro sito negli ultimi 30 giorni con il periodo precedente. Mostra le pagine e le sorgenti principali e indica se qualche metrica è approssimativa.

Specifica il sito se ne monitori diversi. Gli strumenti Analytics leggono le statistiche; non modificano le impostazioni di monitoraggio. Gli eventi personalizzati compaiono dopo che il codice del sito li invia: descrivi l'azione da misurare quando chiedi a un agente di implementarne uno.

## Se non compare traffico

Verifica che il monitoraggio sia attivo, il sito pubblicato e il dominio visitato presente nell'elenco. Per un altro servizio di hosting, verifica che lo snippet compaia una sola volta nelle pagine pubblicate e che il browser possa caricarlo. Un codice bloccato, un test locale o una visita automatizzata non dimostrano che il monitoraggio funzioni.

Se Analytics segnala che il servizio non è disponibile, chiedi all'amministratore di verificare la disponibilità regionale. Se la raccolta è sospesa per la soglia di visualizzazioni, consulta **Analytics → Impostazioni** e [Piani e crediti](https://docs.opser.com/it/billing/usage/): l'uso non pagato può sospendere la raccolta dopo un periodo di tolleranza. Le visite mancanti durante una sospensione non vengono recuperate.