Analitiche del sito

Con una riga di codice nel sito della radio, il pannello registra visitatori, visite, pagine viste, sorgenti, campagne, clic, download, avvii della diretta ed eventi personalizzati. I dati si guardano in Gestione Radio → Analitiche del sito, riservata alla direzione della radio (Gestione Radio). Le statistiche restano nel pannello: non passano da servizi esterni.

Installare lo script

1. Controlla che in Gestisci Radio la radio abbia il Sito web giusto: il pannello accetta i dati solo da quel dominio (con o senza www, e dai suoi sottodomini, ad esempio le anteprime del sito).
2. In Gestione Radio → Analitiche del sito, riquadro Codice da inserire nel sito, premi Copia.
3. Incolla il codice in tutte le pagine del sito, prima di </body>.

<script defer src="https://pannello.example.it/public/sito/statistiche.js" data-radio="radioesempio"></script>

I siti costruiti con l’API del sito trovano lo stesso codice in radio.statistiche.codice (e i singoli valori in radio.statistiche.script e radio.statistiche.radio).

Siti a pagina unica

Nei siti che cambiano pagina senza ricaricarla (React, Vue, Astro con le transizioni di vista…) lo script conta da solo ogni cambio di indirizzo fatto con history.pushState o con i pulsanti avanti e indietro. Se il tuo router cambia pagina in un altro modo, chiama rpStats.pageview() dopo il cambio.

Attributi dello script

Attributo	Obbligatorio	A cosa serve
data-radio	Sì	Il codice della radio (codename). Senza, lo script non fa nulla.
data-consenso="banner"	No	Mostra un piccolo banner che chiede il consenso alle statistiche complete. Usalo solo se il sito non ha già un banner dei cookie.
data-privacy	No	L’indirizzo dell’informativa privacy del sito, linkato nel banner.

Consenso e modalità di raccolta

Come per Google Analytics, i dati completi si raccolgono solo dopo il consenso del visitatore. Lo script sceglie da solo una di tre modalità:

Modalità	Quando	Cosa si registra
Completa	Il visitatore ha accettato.	Tutto, con un identificativo salvato nel browser (il visitatore è riconosciuto nelle visite dei giorni dopo) e l’indirizzo IP.
Anonima	Nessun consenso (o rifiuto).	Pagine, provenienza, dispositivo, lingua, schermo e luogo approssimativo. Niente salvato nel browser, nessun indirizzo IP conservato; il visitatore è un codice che cambia ogni giorno.
Ridotta	Adblock attivo, oppure il browser chiede di non essere tracciato (Global Privacy Control o Do Not Track).	Solo la pagina vista, niente sul visitatore.

Lo script non usa cookie: la scelta del visitatore e l’identificativo stanno nella memoria del browser (localStorage), e le richieste partono senza credenziali.

Banner incluso

<script defer src="https://pannello.example.it/public/sito/statistiche.js"
        data-radio="radioesempio"
        data-consenso="banner"
        data-privacy="https://www.radioesempio.it/privacy"></script>

Il banner compare solo finché il visitatore non sceglie Accetta o Rifiuta, e mai in modalità ridotta.

Banner del sito

Se il sito ha già un banner dei cookie, collegalo con rpStats.consent():

// Quando il visitatore accetta le statistiche nel banner del sito
rpStats.consent(true);

// Quando le rifiuta o ritira il consenso: l'identificativo salvato viene cancellato
rpStats.consent(false);

Lo script si carica con defer: chiama rpStats dopo il caricamento della pagina, ad esempio controllando che window.rpStats esista.

Nella pagina Analitiche del sito del pannello trovi anche il Testo per l’informativa privacy del sito, da adattare e aggiungere alla privacy del sito: il titolare dei dati dei visitatori è la radio.

Cosa si conta da solo

• Pagine viste, con titolo, provenienza e parametri utm_source, utm_medium e utm_campaign dei link delle campagne (es. ?utm_source=instagram&utm_campaign=natale). Gli altri parametri dell’indirizzo non vengono salvati.
• Tempo attivo su ogni pagina (solo mentre la scheda è visibile e il visitatore interagisce) e scorrimento, cioè fin dove viene letta la pagina.
• Link verso altri siti: il dominio di destinazione.
• Download di file (PDF, ZIP, MP3, documenti di Office, APK…): il nome del file.
• Avvio di audio e video (audio_play, video_play), ad esempio il lettore della diretta: una volta per elemento.

Le visite si ricavano dalle pagine viste: meno di 30 minuti tra un evento e l’altro dello stesso visitatore sono la stessa visita. I programmi automatici (bot) non si contano.

Eventi personalizzati

Con un attributo

Aggiungi data-rp-event a un elemento: ogni clic manda l’evento con quel nome. Il dettaglio è il testo dell’elemento, oppure quello di data-rp-label.

<button data-rp-event="ascolta">Ascolta la diretta</button>

<a href="/podcast/puntata-12" data-rp-event="podcast" data-rp-label="Puntata 12">Ascolta la puntata</a>

Consiglio

L’evento ascolta (come audio_play) viene contato tra gli ascolti nei totali delle analitiche: usalo sul pulsante della diretta.

Da JavaScript

// rpStats.event(nome, dettaglio) - il dettaglio è facoltativo, al massimo 120 caratteri
rpStats.event('newsletter', 'iscrizione dal footer');
rpStats.event('condividi', 'whatsapp');

Riferimento di rpStats

Funzione	Cosa fa
rpStats.consent(true), rpStats.consent(false)	Registra la scelta del visitatore e passa alla modalità completa o anonima.
rpStats.event(nome, dettaglio)	Manda un evento personalizzato.
rpStats.pageview()	Conta una pagina vista (per i router che non usano history.pushState).

Se non arrivano dati

• Il Sito web della radio deve corrispondere al dominio da cui parte lo script: un sito su un altro dominio viene rifiutato.
• Lo script deve avere data-radio con il codice giusto.
• Le analitiche devono essere attive sul pannello: se in radio.statistiche dell’API c’è null, chiedi allo staff di RadioPanel.
• I dati di dettaglio restano 24 mesi.