Statistiche del sito

Le Statistiche del sito ti dicono quante visite e quanti visitatori ha il sito, quali pagine sono più viste e da dove arriva il traffico. Non usano cookie e non salvano dati personali.

Accendere le statistiche

Servono un progetto con la piattaforma Web e due cose insieme: l'interruttore e il codice nelle pagine.

1. Nelle Impostazioni del progetto accendi Raccogli le statistiche del sito.
2. Incolla questo codice nelle pagine del sito, dentro l'intestazione:

<script src="https://cdn.jsdelivr.net/npm/@bussolabs/closeyourit-js@0/dist/closeyourit.min.js"></script>
<script>
  CloseYourIt.init({
    endpointUrl: "https://bugs.example.com",
    publicKey: "<chiave pubblica del progetto>",
    projectId: "<id del progetto>",
    environment: "production",
    trackPageviews: true,
  })
</script>

3. Apri Statistiche del sito: la prima visita compare in pochi secondi.

La guida nell'app ti dà lo stesso codice già compilato per il progetto che scegli. Se usi già l'SDK, basta aggiungere trackPageviews: true (vedi JavaScript).

Cosa viene contato

• Una visita a ogni caricamento della pagina e a ogni cambio di pagina nelle app a pagina singola. Un cambio che resta sulla stessa pagina non conta.
• Della pagina partono solo il dominio e il percorso, mai i parametri dopo ?. Partono anche la pagina di provenienza e i parametri UTM delle campagne.
• Il visitatore è un codice anonimo calcolato dal server, che cambia ogni giorno. L'indirizzo di rete e il browser servono a calcolarlo e non vengono salvati.

Per contare una pagina a mano, per esempio un passo di una procedura:

CloseYourIt.capturePageview({ path: "/wizard/step-2" })

Cosa vedi

• I numeri del periodo: pageview, visitatori, bounce, durata media della visita, pagine per visita. Le variazioni sono rispetto al periodo precedente della stessa durata.
• Adesso: i visitatori degli ultimi 30 minuti.
• Pagine più viste e Pagine di ingresso e uscita.
• Da dove arrivano: Referrer principali, Canali (accesso diretto, ricerca, social, assistenti AI, altri siti, email, campagne a pagamento) e Campagne (UTM).
• Località: il paese.
• Browser e sistema operativo, Dispositivo e schermo.

Puoi scegliere progetto, ambiente e periodo: ultime 24 ore, 7 giorni, 30 giorni o un anno.

Eventi personalizzati

Un evento segna un'azione che conta, per esempio una registrazione:

CloseYourIt.captureEvent("Signup")

Gli eventi non contano come visite: servono ai goal.

Goal

Un goal è una visita o un evento che vale come obiettivo raggiunto.

1. Premi Gestisci goal, poi Nuovo goal.
2. Dai un Nome e scegli il Tipo:
   • Path pagina: un percorso esatto, oppure un prefisso con * (per esempio /blog/*);
   • Evento custom: il nome passato a captureEvent.
3. Premi Salva goal.

Per ogni goal vedi i visitatori unici, il totale e il tasso di conversione. Eliminare un goal toglie solo il suo conteggio: visite ed eventi restano.

Condividere le statistiche

Crea link pubblica una pagina in sola lettura con le statistiche del progetto. Ottieni l'indirizzo pubblico e un codice per incorporarla in un altro sito. La pagina mostra solo numeri aggregati, mai i singoli visitatori.

Per proteggere il link con una password, crealo dalla riga di comando:

cyi analytics share --project <id o chiave> --password <password>

Revoca spegne il link. Creare e revocare il link richiede un permesso apposito (vedi Permessi).

Leggere i dati da un programma

Con un token del progetto con permesso read:

curl https://bugs.example.com/api/v1/projects/$PROJECT_ID/analytics?range=30d \
  -H "Authorization: Bearer $CYI_TOKEN"

range vale 24h, 7d, 30d o 1y; environment sceglie l'ambiente. La risposta contiene riepilogo, andamento nel tempo, suddivisioni, canali e goal. Dalla riga di comando: cyi analytics show --project <id o chiave>.

Quanto restano i dati

Di base un anno. Si cambia in Retention statistiche del sito (giorni), nelle impostazioni dell'organizzazione o del progetto.