Matomo

Il connettore Matomo porta nel foglio i dati di analisi del tuo sito da un'istanza Matomo (self-hosted o Matomo Cloud).

Modello diverso da Google Analytics 4: in Matomo non si combinano liberamente dimensioni e metriche. Si sceglie un Sito e poi un Report predefinito (es. "Paese", "Motori di ricerca", "Pagine visitate"): ogni report ha un set fisso di metriche e al massimo una dimensione, mai scelta liberamente. Alcuni report (es. il riepilogo visite) non hanno nessuna dimensione e restituiscono una sola riga per periodo.

Autenticazione diversa dagli altri connettori: non usa un login OAuth, ma l'URL della tua istanza Matomo e un token di autenticazione che generi tu in Matomo (Impostazioni personali > Sicurezza > Token di autenticazione). Basta il permesso di visualizzazione sui siti che vuoi usare. L'istanza deve essere raggiungibile da internet: non funziona con installazioni disponibili solo in rete locale o dietro VPN.

Per incrociare una dimensione diversa da quella del report si usa il Segmento (un filtro sulle visite, calcolato da Matomo prima di generare il report), separato dai filtri sulle righe descritti più sotto.

Permessi richiesti

• view : Livello minimo richiesto per il token Matomo: basta il permesso di visualizzazione (view) sui siti che vuoi usare, non serve accesso di amministrazione. Il connettore vede solo i siti su cui il token ha almeno questo permesso.

Metriche disponibili

Le metriche disponibili dipendono dal report scelto: non esiste un elenco fisso come per altri connettori. Dopo aver selezionato Sito e Report, la sidebar mostra solo le metriche di quel report specifico, con le prime tre già selezionate.

Alcune metriche cambiano nome dietro le quinte su periodi più lunghi di un giorno: i visitatori unici non sono sommabili tra giorni diversi, quindi su un intervallo di più giorni Matomo restituisce un valore approssimato (somma dei visitatori unici di ciascun giorno) invece del conteggio esatto. Il connettore lo gestisce in automatico, nessuna azione richiesta.

La metrica Utenti conta solo le visite a cui il sito ha assegnato esplicitamente un identificativo utente (tramite la funzione Matomo "User ID", tipicamente collegata a un login): su siti che non la usano resta a zero anche con molte visite, non è un errore.

Dimensioni disponibili

Al massimo una dimensione per report, ed è sempre quella del report scelto (es. il report "Paese" ha sempre e solo la dimensione Paese): non è selezionabile liberamente. Alcuni report (i riepiloghi) non hanno nessuna dimensione.

Per analizzare i dati secondo una dimensione diversa da quella del report, usa il campo Segmento nella sezione del report (es. countryCode==it;deviceType==smartphone).

Limiti noti

• Un report Matomo alla volta ha un solo Sito e un solo Report
  A differenza di GA4 non si combinano dimensioni e metriche di report diversi in un unico report Magic Reports: ogni report qui corrisponde a un report Matomo specifico, con le sue metriche e la sua unica dimensione.
• Ordinamento su una sola colonna
  Matomo non supporta ordinamenti multipli: puoi ordinare per una sola metrica o per la dimensione alla volta, non una combinazione di più colonne.
• Nessun operatore "compreso tra" sui filtri metrica
  Il builder filtri condiviso non ha un operatore dedicato per un intervallo di valori. Si ottiene lo stesso risultato con due condizioni in AND: "maggiore o uguale a" il valore minimo e "minore o uguale a" il valore massimo.
• Filtri sulle righe case-insensitive
  I confronti testuali nei filtri (contiene, esatto, inizia con, ecc.) non distinguono maiuscole da minuscole, sia quando Matomo li applica direttamente sia quando li applica il connettore.
• Riga "Others" e dati troncati
  Per contenere lo spazio di archiviazione, Matomo salva solo le prime righe di ogni report (la soglia dipende dalla configurazione dell'istanza) e somma le restanti in una riga "Others": quelle righe non sono più recuperabili singolarmente da nessuno strumento esterno, non solo da questo connettore.
• Freschezza dei dati e archiviazione
  Matomo pre-calcola i report invece di generarli sempre al volo. I dati di oggi sono parziali e vengono aggiornati a intervalli. Se su un'istanza self-hosted l'archiviazione è disattivata e nessun cron la sostituisce, alcuni report possono risultare vuoti o non aggiornati: il connettore restituisce quello che Matomo ha calcolato, non può forzarne il ricalcolo.
• Una connessione per istanza
  Ogni connessione salvata punta a una sola istanza Matomo (un URL e un token). Per lavorare con più istanze diverse, crea una connessione separata per ciascuna dalla stessa schermata dei connettori.

Filtri e ordinamento

• Filtri sulle righe e Segmento non sono la stessa cosa
  Il filtro agisce sulle righe del report già calcolato, senza cambiarne i valori: es. nel report Pagine, filtrare per "URL contiene /blog" tiene solo quelle righe, i numeri di ciascuna riga restano quelli originali. Il Segmento invece filtra le visite prima ancora del calcolo, e il report viene ricalcolato da zero: nel report Pagine, un segmento "Paese = Italia" mostra le pagine viste solo dalle visite italiane, con numeri diversi. Il segmento è anche l'unico modo per incrociare una dimensione diversa da quella del report.
• Operatori disponibili sulla dimensione
  Contiene, Inizia con, Finisce con, Esatto, Regexp, ciascuno disponibile anche come Escludi (equivalenti a "non contiene", "non esatto", ecc.). Tutti case-insensitive. Per i report gerarchici (es. Pagine) il confronto avviene sul percorso completo, non solo sull'ultimo livello.
• Operatori disponibili sulle metriche
  Maggiore di, Minore di, Maggiore o uguale a, Minore o uguale a, Uguale a, ciascuno disponibile anche come Escludi (es. Escludi + Uguale a = diverso da). Le percentuali si possono scrivere sia come "50" sia come "50%"; le durate si inseriscono in secondi.

Tempi di esecuzione

La prima esecuzione su un intervallo di date che Matomo non ha ancora calcolato può essere più lenta del solito: Matomo elabora i report al momento della richiesta invece di averli già pronti.

Quando il report ha filtri su una metrica, più di una condizione sulla dimensione, oppure ordinamento su una metrica calcolata, Matomo restituisce tutte le righe del periodo e filtri/ordinamento vengono applicati dal connettore: su report con molte righe può richiedere qualche secondo in più rispetto a un report senza filtri, che invece li applica Matomo stesso restituendo solo le righe utili.