Come risolvere le visualizzazioni mancanti in Plausible
1. Individua quali visualizzazioni di pagina mancano
Inizia da un URL per cui il problema si verifica. Annota l’indirizzo della pagina, l’ora del test e se il report di Plausible mostra visite ad altre pagine dello stesso sito. Un esempio concreto, come una pagina prodotto che non compare mentre la homepage sì, è più utile di un generico «le analisi non funzionano».
Confronta la pagina interessata con una che viene monitorata correttamente. Verifica che le due pagine usino lo stesso modello, vengano caricate dallo stesso hostname e compaiano nello stesso sito Plausible. Qualsiasi differenza tra questi elementi ti indica dove indagare prima di modificare il codice.
Separa le visite dirette dalla navigazione interna al sito. Apri l’URL interessato in una nuova scheda, poi raggiungilo facendo clic su un link da un’altra pagina. Se le visite dirette compaiono nel report ma i clic no, il problema potrebbe dipendere dal modo in cui il sito gestisce la navigazione; se non compare nessuna delle due, inizia dal codice di monitoraggio o dalle impostazioni del browser.
Tieni un breve registro dei test. Annota l’URL esatto, il percorso seguito per raggiungerlo, il browser e il risultato ottenuto. In questo modo potrai ripetere lo stesso test dopo una modifica, senza doverti affidare alla memoria.
2. Verifica se il browser invia un evento di visualizzazione di pagina
Apri la pagina interessata e gli strumenti per sviluppatori del browser. Nel pannello Rete, ricarica la pagina e cerca le richieste associate a Plausible.
Se trovi una richiesta, esaminala nel dettaglio anziché fermarti a «si è caricata». Controlla che l’URL della pagina nella richiesta corrisponda a quello interessato, che la richiesta sia stata completata e che il browser non la segnali come bloccata o non riuscita. Se la richiesta riporta la homepage invece di un percorso annidato, il problema potrebbe riguardare la gestione degli URL, non necessariamente l’assenza dello script.
Se non compare alcuna richiesta, controlla prima i filtri del pannello Rete. Un filtro di testo potrebbe nascondere la richiesta che cerchi, mentre il mantenimento del log può mescolare l’attività dei caricamenti precedenti con il test attuale. Cancella il filtro, ricarica la pagina una volta e controlla le nuove attività.
Usa il pannello Console come verifica aggiuntiva. Un errore di caricamento dello script, un messaggio relativo ai criteri di sicurezza dei contenuti o un’eccezione JavaScript potrebbero spiegare perché la richiesta non parte. Prima di modificare qualsiasi cosa, copia il messaggio esatto e l’URL della pagina interessata: questi due dettagli aiutano a distinguere un errore del sito da un blocco del browser.
Per capire perché alcune pagine non compaiono in Plausible, verifica innanzitutto se il browser invia una richiesta di visualizzazione. Questa semplice osservazione restringe il campo: se non ci sono richieste, indaga sull’esecuzione dello script; se invece ce n’è una, controlla la richiesta e la configurazione dei report. In questo modo puoi capire come verificare il tracking di Plausible e individuare dove intervenire.
3. Escludi blocchi del browser e del consenso
Ripeti il test in un profilo browser pulito o in una finestra privata, disattivando le estensioni, se possibile. Gli ad blocker, la protezione antitracciamento e le estensioni per la privacy possono impedire l’invio di una richiesta di analisi; il risultato ottenuto in un solo browser, quindi, non basta a dimostrare che il problema riguardi tutti i visitatori.
Prova il flusso di consenso come farebbe un visitatore. Carica la pagina prima di scegliere, poi accetta il consenso alle analisi, se il sito lo richiede, e ricarica la pagina o visita di nuovo il percorso interessato. Se la richiesta compare solo dopo aver dato il consenso, controlla la configurazione del sistema di gestione del consenso e verifica che la relativa categoria di analisi sia collegata allo script di Plausible.
Non considerare di per sé un bug il rifiuto del consenso alle analisi facoltative. L’importante è verificare che il comportamento corrisponda alle regole di consenso previste dal sito e alla configurazione in uso. Per maggiori informazioni sulle scelte di misurazione orientate alla privacy, leggi le novità nelle analisi che mettono la privacy al primo posto.
Controlla nella Console se compaiono errori solo dopo il caricamento del banner di consenso. Se lo script del banner non funziona e non attiva quello di analisi, la pagina potrebbe sembrare normale anche se la richiesta di monitoraggio non viene inviata. Se il problema dipende dal banner, verifica anche se è possibile usare i suoi controlli con la tastiera; questa guida spiega come verificare se un sito web pubblica una dichiarazione di accessibilità.
4. Confronta il codice di monitoraggio effettivamente caricato nelle pagine interessate
Esamina la pagina così come viene visualizzata nel browser, non solo il file sorgente o le impostazioni del sistema di gestione dei contenuti. Un modello potrebbe non includere lo snippet di monitoraggio per un determinato tipo di pagina, oppure un gestore di tag potrebbe inserirlo solo in alcuni percorsi. Confronta il codice effettivamente caricato in un URL funzionante e in uno che presenta il problema.
Cerca lo script di Plausible e il valore del sito o del dominio a cui è associato. Un errore di battitura nel dominio configurato o un hostname diverso da quello registrato per il sito potrebbe farti cercare nel report sbagliato.
Verifica che lo script non sia presente più di una volta. Un’installazione duplicata può complicare i test e rendere i risultati più difficili da interpretare. Se le due pagine differiscono, individua quale sistema fornisce il codice, ad esempio il modello della pagina, un gestore di tag o un plugin, e apporta la correzione in quel punto anziché aggiungere un’altra copia manualmente.
Quando confronti il codice effettivamente caricato, tieni conto dei tempi di esecuzione degli script. Un sistema di gestione del consenso o dei tag potrebbe aggiungere lo script dopo il caricamento dell’HTML iniziale; perciò, una rapida occhiata al sorgente della pagina potrebbe non mostrare lo stato finale. Usa insieme i pannelli Elementi e Rete del browser per verificare se l’elemento script compare e se il browser lo richiede.
5. Prova separatamente i caricamenti diretti e la navigazione lato client
Apri il percorso interessato direttamente in una nuova scheda, poi raggiungilo da un’altra pagina senza ricaricare completamente il sito. Annota il risultato per ciascun metodo. Un sito realizzato come applicazione a pagina singola può cambiare il percorso visualizzato senza caricare un nuovo documento: verifica quindi se quella navigazione genera una visualizzazione di pagina.
Se i caricamenti diretti vengono conteggiati ma i clic interni no, controlla il router del sito e verifica che l’integrazione con Plausible supporti la navigazione lato client. Consulta la documentazione dell’integrazione per capire come gestisce i cambi di percorso.
Se la navigazione viene conteggiata ma il caricamento diretto no, esamina la risposta iniziale della pagina e il modello associato al percorso. Il server potrebbe fornire un documento diverso o non includere il codice di monitoraggio per quel percorso. Confronta il codice effettivamente caricato e i dettagli delle richieste al caricamento iniziale con quelli registrati dopo un clic.
Prova un percorso con parametri di query o una barra finale solo se i visitatori usano davvero queste varianti. In questi casi, l’URL registrato dal browser e quello che ti aspetti di trovare nel report potrebbero essere diversi; annota l’indirizzo esatto invece di dare per scontato che URL dall’aspetto simile vengano trattati allo stesso modo.
6. Controlla l’ambito e i filtri dei report di Plausible
Prima di considerare l’assenza di una riga come un problema di raccolta dei dati, verifica che la dashboard mostri il sito Plausible corretto. Un report relativo a un dominio di staging, a un hostname alternativo o a un progetto con un nome simile non ti dirà se la visualizzazione della pagina di produzione è stata registrata.
Imposta un intervallo di date che includa il test, poi controlla gli eventuali filtri o segmenti applicati al report. Un intervallo troppo ristretto o un filtro attivo potrebbero nascondere una pagina registrata. Se hai testato a un’ora precisa, usala per collegare la verifica nel report al test effettuato nel browser.
Cerca la pagina nel report o esaminalo usando lo stesso percorso inviato dal browser, inclusi l’eventuale barra finale o i parametri di query pertinenti.
Distingui inoltre una visualizzazione di pagina da un evento personalizzato. Se l’implementazione invia un evento con nome specifico quando si carica un percorso, controlla la richiesta e cerca l’evento nella sezione appropriata del report, senza presumere che si tratti di una normale visualizzazione di pagina.
7. Ripeti i test sui casi interessati dopo la correzione
Modifica una sola cosa alla volta. Se hai corretto il valore del dominio, ripeti il test prima di modificare anche le regole del consenso o il codice del router. Una modifica per volta ti permette di capire se la richiesta ha ripreso a funzionare ed evita che un secondo problema ne nasconda un altro.
Ripeti i test iniziali: carica direttamente ogni URL interessato, raggiungilo tramite un link interno e confronta entrambi i risultati con quelli di una pagina sicuramente funzionante. Mantieni le stesse impostazioni del browser e la stessa scelta di consenso che avevi annotato prima. Se il sito usa più modelli, includi un esempio non funzionante per ciascun modello interessato.
Per ogni test verifica due cose: che il browser invii la richiesta di visualizzazione prevista per l’URL corretto e che la nuova visualizzazione compaia nel report del sito Plausible previsto. Se la richiesta è presente ma il report è ancora vuoto, ricontrolla il sito selezionato, l’intervallo di date e i filtri prima di modificare di nuovo il codice del sito. Se Plausible non registra le visualizzazioni di pagina, queste verifiche aiutano a distinguere un problema di raccolta da uno di report.
Conserva il registro dei test riusciti insieme alla modifica del codice o al ticket di assistenza. Includi gli URL interessati, i risultati ottenuti nel browser, gli eventuali errori rilevanti della Console e l’ambito del report controllato. Questi elementi permettono a chi se ne occuperà dopo di ripetere il test, anziché ricevere una segnalazione generica sulle visualizzazioni di pagina mancanti.
