Umami Analytics
Plugin Umami non ufficiale, non affiliato a Umami: traffico, pagine più viste, referrer e visualizzazioni per voce nell'amministrazione di EmDash.
Estensione
Umami Analytics
Plugin Umami non ufficiale, non affiliato a Umami: traffico, pagine più viste, referrer e visualizzazioni per voce nell'amministrazione di EmDash.
Descrizione
Un plugin non ufficiale. Non è affiliato a Umami, né approvato o supportato da Umami.
Mostra i tuoi numeri di Umami all’interno dell’amministrazione di EmDash: il traffico del sito nella dashboard e le visualizzazioni di pagina accanto alle voci che le hanno generate. Per Umami Cloud e per un Umami self-hosted dalla versione 3.4.0.
- Scheda traffico Umami. Nella dashboard: visite, visualizzazioni di pagina e coinvolgimento degli ultimi sette giorni a confronto con la settimana precedente, e le cinque pagine più viste con le relative voci.
- Pagina Umami Analytics. Un grafico giornaliero su 7, 30 o 90 giorni, frequenza di rimbalzo e durata della visita, voci più viste, referrer, paesi, visualizzazioni di pagina in base ai dati degli eventi che il tuo sito allega (per categoria, per cominciare) e un controllo della configurazione che indica la soluzione per ogni problema trovato.
- Pagina per voce. Ogni voce pubblicata con le sue visualizzazioni di pagina a 7 e 30 giorni, ordinabili, per una raccolta o per tutte, con le traduzioni combinate se vuoi.
- Pannello Umami nell’editor. Le visualizzazioni di pagina a 7 e 30 giorni di ogni voce accanto all’editor e fin dove arrivano i lettori quando il tuo sito invia un evento di lettura.
- Strumenti MCP. Quattro strumenti di sola lettura che rispondono in base ai numeri memorizzati.
Il plugin si limita a leggere. Non modifica mai nulla in Umami né nei tuoi contenuti. I dati demo ti permettono di provarlo senza un sito web in Umami.
È testato con un Umami 3.4.0 self-hosted. La connessione a Umami Cloud segue l’API pubblicata da Umami e non è ancora stata provata con un account Cloud.
Basato sul plugin analytics di EmDash di Eisbachcode, con licenza MIT.
Installazione
Ti servono: EmDash 1.0.1 o successivo con un runner sandbox per i plugin; un sito web in Umami con lo script di tracciamento di Umami già installato sul tuo sito; un Umami self-hosted 3.4.0 o successivo (la prima versione self-hosted con chiavi API) oppure Umami Cloud; e EMDASH_ENCRYPTION_KEY impostata sul sito, in modo che la chiave API possa essere salvata cifrata (npx emdash secrets generate ne crea una).
- Installa il plugin dal registro e controlla le sue autorizzazioni: leggere i contenuti, leggere lo schema e fare richieste di rete a qualsiasi host pubblico. Il plugin richiede solo l’URL dell’API di Umami indicato nelle sue impostazioni.
- In Umami, crea un utente con il ruolo View only. Aggiungilo al team che possiede il tuo sito web, con il ruolo di team View only. Se il sito è tuo e non di un team, spostalo prima in un team.
- Accedi a Umami con quell’utente e crea una chiave in Settings > API keys.
- In EmDash, apri Plugins e poi le impostazioni di questo plugin. Incolla la chiave in Umami API key.
- Per un Umami self-hosted, imposta Umami API URL su
https://your-host/api. Il valore predefinito è l’indirizzo di Umami Cloud. - Inserisci l’ID del sito web Umami che trovi nelle impostazioni del sito in Umami. Se lo lasci vuoto, la scheda della dashboard elenca i siti che la chiave può vedere, così puoi copiarne uno. Salva.
- Apri Plugins > Umami Analytics e seleziona Check setup. Controlla tutto ciò da cui dipendono i numeri e fornisce una frase per ogni problema.
Le prime sincronizzazioni leggono a ritroso fino a Keep daily rows for (90 giorni per impostazione predefinita), partendo dai dati più recenti. Su Node ci vogliono circa due ore per un sito di 100 voci.
Ogni raccolta ha bisogno di un modello di URL (in Tipi di contenuto), altrimenti le pagine non possono essere associate alle voci. Su Cloudflare Workers, la sincronizzazione richiede il Cron Trigger descritto nella guida alla distribuzione di EmDash.
Un Umami self-hosted deve avere un nome host pubblico: EmDash rifiuta gli indirizzi privati, quindi localhost, un indirizzo di rete locale o un nome raggiungibile solo via VPN non funzioneranno.
Per usare gli strumenti MCP, attiva l’accesso Agent per il plugin in Plugins. Riattivalo dopo un aggiornamento che modifica uno strumento.
Domande frequenti
Perché tutto mostra zero? La maggior parte degli errori di configurazione produce zeri senza alcun errore. Apri Plugins > Umami Analytics e seleziona Check setup: indica la soluzione per ogni problema trovato.
Perché i miei numeri sono diversi da quelli della dashboard di Umami?
I giorni seguono l’impostazione Time zone: usa il fuso orario del sito web in Umami, altrimenti i dati giornalieri differiscono intorno alla mezzanotte. Le pagine sotto /_emdash sono escluse e i totali contano solo i nomi host in Hostnames to count (l’URL del tuo sito e la sua forma con www, se non modificati).
Funziona con Umami Cloud? Segue l’API pubblicata da Umami, ma non è ancora stato provato con un account Cloud. Segnala quello che trovi nelle issue del repository.
Il mio Umami si trova dietro un proxy con accesso autenticato. Lascia passare senza proxy gli otto endpoint dell’API di Umami usati dal plugin. Il README li elenca e Umami verifica la chiave API su ciascuno.
Quante richieste fa? Una sincronizzazione fa al massimo sette richieste a Umami. Aprire la pagina Umami Analytics ne fa cinque.
Posso provarlo senza Umami? Sì. Imposta Data source su Demo data e seleziona Refresh nella scheda della dashboard. Genera 90 giorni di traffico inventato sulle tue voci reali. Cambiare l’origine dei dati cancella tutti i numeri memorizzati, quindi i dati demo non si mescolano mai a quelli reali.
Chi può vedere i numeri? Editor e amministratori vedono la scheda della dashboard, entrambe le pagine Umami e gli strumenti MCP. Gli autori vedono il pannello dell’editor per le proprie voci.
Da dove vengono le tabelle per categoria?
Dai dati degli eventi che il tuo sito allega alle sue visualizzazioni di pagina tramite l’hook data-before-send del tracker di Umami. Indica fino a tre proprietà in Views by event data. Un sito che non ne invia non vede alcuna tabella.
Come funziona la profondità di lettura?
Il tuo sito invia un evento personalizzato quando un lettore raggiunge ciascuna profondità di una voce, ad esempio post_read con post e depth. Compila di conseguenza le quattro impostazioni Read-through. Per impostazione predefinita sono vuote, il che disattiva la funzione.
Quali lingue parla? Inglese e tedesco, in base alla lingua di amministrazione di ciascun utente.
Sicurezza
Segnala un problema di sicurezza in privato tramite il modulo di avviso del repository: https://github.com/shanelord01/emdash-umami-analytics/security/advisories/new
Cosa può fare la chiave API di Umami
Una chiave API di Umami non ha permessi propri. Può fare tutto ciò che può fare l’utente che l’ha creata. Una chiave creata con un utente amministratore potrebbe modificare o eliminare ogni sito web del tuo Umami, quindi creala con un utente con il ruolo View only, aggiunto al team del sito con il ruolo di team View only. Una chiave creata così può leggere i siti web di quel team e non modificare nulla. Il plugin stesso invia solo richieste GET.
Accesso alla rete
Il plugin richiede network:request:unrestricted, perché un Umami self-hosted si trova su un host che inserisci nelle impostazioni e che nessun elenco fisso di host potrebbe nominare. Richiede solo l’URL dell’API di Umami indicato nelle sue impostazioni (https://api.umami.is/v1 se non modificato), con la chiave come token Bearer. I dati demo non fanno alcuna richiesta. EmDash rifiuta gli indirizzi privati per ogni plugin.
Cosa viene inviato e cosa viene memorizzato
- Umami riceve la chiave API, l’ID del sito web e i nomi host da contare. Nulla dei tuoi contenuti lascia il sito.
- La chiave viene salvata come impostazione cifrata (AES-GCM con
EMDASH_ENCRYPTION_KEY). Senza questa chiave EmDash rifiuta di salvarla invece di memorizzarla in chiaro. Il plugin non la scrive mai nei suoi log. - Il database del sito contiene visualizzazioni di pagina e visite per giorno e percorso, totali del sito e coinvolgimento per giorno, l’associazione di ogni percorso alla sua voce con i conteggi delle visualizzazioni e la profondità di lettura di quella voce, e lo stato della sincronizzazione con le pagine, i referrer e i paesi principali dell’ultima settimana. Le righe giornaliere più vecchie di Keep daily rows for vengono eliminate.
Chi può fare cosa
La scheda della dashboard, le pagine Analytics e Per entry e gli strumenti MCP richiedono il ruolo di editor. Il pannello dell’editor richiede il ruolo di autore e mostra solo le voci che l’utente può modificare. Modificare le impostazioni richiede il ruolo di amministratore.
Registro delle modifiche
0.1.4
- Su EmDash 1.2 e successivi le pagine si trovano in un’unica cartella Umami nella barra laterale (Analytics, Per entry). I loro indirizzi non cambiano; le versioni precedenti di EmDash le elencano una per una.
- Nessuna nuova autorizzazione e nessuna modifica agli strumenti MCP.
0.1.3, 9 ottobre 2026
- I giorni seguono il tuo fuso orario. Prima erano giorni UTC, quindi una visualizzazione di pagina prima delle 10 circa a Sydney veniva contata nel giorno precedente. La nuova impostazione Time zone parte da Australia/Sydney. Imposta il fuso orario del sito web in Umami.
- Con l’aggiornamento i numeri memorizzati vengono cancellati una volta e riletti da Umami, partendo dai più recenti. I grafici e le visualizzazioni per voce si riempiono durante il recupero: circa due ore per 90 giorni e 100 voci su Node, al ritmo del Cron Trigger su Cloudflare Workers. Modificare l’impostazione in seguito produce lo stesso effetto.
- Rinominati con il nome di Umami, per non essere scambiati con quelli di un altro plugin: le pagine Umami Analytics e Umami per entry (stessi indirizzi), la scheda traffico Umami e il pannello Umami nell’editor.
- La pagina del registro ha delle schede, incluso questo registro delle modifiche, e un banner.
- Correzioni all’amministrazione: niente più falso «nessuna pagina corrisponde», le pagine principali della dashboard coprono i suoi 7 giorni, il grafico giornaliero indica il nome della sua serie e il pannello dell’editor indica il giorno in cui inizia la sua cronologia memorizzata.
- Nessuna nuova autorizzazione. Gli strumenti MCP ora descrivono i loro giorni nel tuo fuso orario, quindi EmDash disattiva l’accesso Agent dopo l’aggiornamento. Riattivalo in Plugins.
0.1.2, 1 ottobre 2026
- Coinvolgimento accanto ai totali: frequenza di rimbalzo, visita media e pagine per visita a confronto con il periodo precedente, e un nuovo campo
engagementinsite_totals. - Profondità di lettura per voce (quattro impostazioni, disattivata per impostazione predefinita) e due nuovi endpoint Umami usati solo quando è attiva. Recupero più rapido dopo l’installazione.
- Riattiva l’accesso Agent in Plugins dopo l’aggiornamento.
Cronologia completa: CHANGELOG.md.