Supporto e risoluzione dei problemi

Scrivi a hello@seean.io indicando il dominio del sito web, la schermata interessata, il periodo selezionato e cosa ti aspettavi di vedere.

Usa le FAQ per le domande comuni sul prodotto, la disponibilità delle funzionalità per controllare le integrazioni supportate e fatturazione e utilizzo per quote e accesso alle fatture.

Non arrivano visualizzazioni di pagina

Conferma che la pagina distribuita includa il token del sito e l’origine API corretti da Settings (Impostazioni).
Controlla che il browser possa caricare /k.js e inviare la richiesta di raccolta.
Controlla i controlli di consenso, le preferenze di privacy del browser, i blocker e le esclusioni configurate.
Controlla se il periodo di prova è scaduto o se l’utilizzo ha raggiunto la quota.
Apri Settings → Installation → Setup health (Impostazioni → Installazione → Stato della configurazione), che mostra la visualizzazione di pagina ricevuta più di recente e offre Check installation (Controlla installazione).

Non ruotare un token come primo passo di risoluzione: la rotazione invalida le installazioni esistenti.

Controllare la configurazione pubblicata

Seean controlla automaticamente la home page pubblicata di ogni sito web non ancora verificato, senza che nessuno apra la dashboard: ogni minuto durante il primo giorno del sito web, ogni 5 minuti per il resto della prima settimana, ogni 30 minuti per il resto del primo mese e ogni 6 ore dopo. Cambiare il dominio o ruotare il token del sito riavvia questa pianificazione dal ritmo del primo giorno. Il primo controllo che trova lo snippet, il token e una policy di sicurezza permissiva verifica il sito web immediatamente; non serve alcuna visita. I siti web verificati e quelli che già ricevono eventi non vengono più interrogati; reimpostare le statistiche di un sito web non verificato lo rimette su questa pianificazione.

Anche il banner di installazione della Panoramica vuota esegue un controllo quando si apre. I proprietari e gli amministratori del sito web possono inoltre usare Settings → Installation → Setup health → Check installation. Legge la home page pubblicata e controlla l’indirizzo del tracker generato, il riferimento al token del sito e la policy di sicurezza (l’intestazione HTTP e qualsiasi tag <meta http-equiv="Content-Security-Policy"> nell’head della pagina). I risultati compaiono sullo schermo senza ricaricare. Se la connessione a Seean cade, la schermata avvisa che i dati ricevuti potrebbero non essere aggiornati e disattiva nuovi controlli fino alla riconnessione:

Security policy blocks Seean (La policy di sicurezza blocca Seean) indica la direttiva script o di connessione che blocca e le sorgenti da aggiungere. Uniscile alla tua policy esistente e pubblica la modifica; mantieni intatti gli altri permessi dell’applicazione.
Seean is installed (Seean è installato) significa che l’indirizzo del tracker e il token del sito compaiono nel codice sorgente della pagina e la policy di sicurezza (intestazione e meta tag) consente lo script e le richieste di raccolta. Non è richiesta alcuna visita. Il sito web viene segnato come installato immediatamente: il banner di installazione della Panoramica si chiude, Your sites (I tuoi siti) mostra Installed (Installato) e Setup health mostra Installation verified (Installazione verificata) con l’ora del controllo. I report si riempiono man mano che arrivano i visitatori; blocker o scelte di consenso possono comunque impedire il conteggio di singoli visitatori.
Tracker reference found — confirm in a browser (Riferimento al tracker trovato — conferma in un browser) significa che indirizzo e token compaiono, ma la policy usa regole nonce, hash o strict-dynamic che il controllo non può valutare, oppure l’head della pagina è troppo lungo da leggere (vedi i limiti sotto). Una verifica precedente viene mantenuta; segui la verifica nel browser.
Setup could not be confirmed (Impossibile confermare la configurazione) può indicare uno snippet assente o diverso, un caricamento lato client o un caricamento condizionato al consenso. Segui la verifica nel browser prima di concludere che il tracker manca.
Could not inspect (Impossibile ispezionare) spiega una pagina non disponibile, un errore HTTP, una risposta troppo grande o un indirizzo non supportato. Riprova dopo aver corretto la pagina pubblicata, oppure usa la verifica nel browser.
Last pageview received (Ultima visualizzazione di pagina ricevuta) mostra la visualizzazione di pagina conservata più recente per questo sito web, indipendentemente dal periodo di report selezionato. Un timestamp vecchio è la prova di una raccolta passata, non che l’installazione attuale funzioni. Senza visualizzazioni di pagina, Installation verified mostra l’ultimo controllo riuscito e Not installed yet (Non ancora installato) significa che nessun controllo ha verificato la pagina pubblicata.

Un controllo successivo che trova lo snippet o il token mancanti, o una policy che blocca Seean, rimuove la verifica e il banner torna finché il sito web non ha dati. Anche cambiare il dominio del sito web, ruotare il suo token o cambiare l’hostname del collettore usato dallo snippet generato rimuove la verifica e riavvia i controlli automatici. Le modifiche al collettore includono l’attivazione/disattivazione della raccolta first-party e l’attivazione, la perdita o la disconnessione di un dominio di raccolta personalizzato; cambiare un hostname di fallback mentre un dominio personalizzato attivo serve ancora lo snippet non reimposta la verifica. Pubblica lo snippet corrente e le sue origini nella policy di sicurezza prima di controllare di nuovo. I dati analitici esistenti vengono conservati. Un controllo che non riesce a leggere la pagina lascia invariato il risultato precedente.

Un risultato manuale o automatico relativo a una configurazione di installazione precedente non può verificare quella nuova né rimuovere il suo controllo in coda. Se un controllo manuale dice Installation settings or a newer check changed during this check (Le impostazioni di installazione o un controllo più recente sono cambiati durante questo controllo), rivedi lo snippet generato corrente e riprova; Seean non segna come installato il risultato obsoleto.

I controlli manuali sono limitati a due al minuto per utente connesso su tutti i suoi siti web; i controlli automatici non contano in questo limite. Il verificatore legge solo la home page HTTPS pubblica del dominio configurato, con al massimo tre redirect all’interno di quel dominio e del suo indirizzo www, una scadenza totale di 12 secondi e un limite di risposta di 2 MiB. Indirizzi privati, siti con IP letterale, porte non standard, siti solo IPv6 e risposte compresse che ignorano la richiesta di HTML non compresso non vengono ispezionati.

Si tratta di un controllo lato server del codice sorgente e delle intestazioni: non esegue JavaScript, non aggira consenso o blocker del browser, non ispeziona altre route e non dimostra che le policy nonce/hash/strict-dynamic funzionino. Un head di pagina più lungo di 16 KB che ha ancora un meta tag http-equiv oltre quel punto, o policy nei meta tag più lunghe di 16 KB, non possono essere confermati da questo controllo e richiedono la verifica nel browser. Risposte CDN diverse e policy su altre pagine richiedono la verifica nel browser. Controlla l’hostname che lo snippet generato usa attualmente - il tuo dominio di raccolta una volta attivo, altrimenti l’indirizzo di raccolta first-party o app.seean.io; uno snippet standard più vecchio può continuare a funzionare dopo l’attivazione della raccolta first-party. Il controllo stesso non invia eventi analitici e non memorizza l’HTML recuperato; vengono conservati solo l’ora della verifica, l’ora dell’ultimo controllo applicato e l’ora del prossimo controllo automatico. I viewer non possono eseguire controlli di installazione.

Verificare la propria installazione

Apri il tuo sito web pubblicato in una normale scheda del browser. Completa il flusso di consenso analitico del tuo sito, se applicabile. Rispetta le scelte di privacy dei tuoi visitatori.
Negli strumenti per sviluppatori del browser, apri Network (Rete). Ricarica la pagina e cerca https://app.seean.io/k.js. Dovrebbe caricarsi correttamente, eventualmente dalla cache del browser.
Cerca una POST verso https://app.seean.io/api/collect se usi lo snippet di produzione standard. Il suo corpo JSON include il tuo token pubblico in t e il pathname della pagina in p. Una risposta 204 da sola non è la prova che i dati siano stati memorizzati: anche le richieste escluse possono terminare senza una risposta di errore.
In Seean, apri Events (Eventi), seleziona un intervallo che includa l’ora attuale e aggiorna l’elenco. Abbina il percorso della tua pagina e l’orario. Controlla anche Settings → Installation → Setup health per l’ora dell’ultima visualizzazione di pagina ricevuta.
Vai a un pathname diverso, poi usa Indietro e Avanti. Conferma ogni visualizzazione di pagina prevista in Eventi. Query e frammenti non sono percorsi di pagina distinti; una nuova campagna o sessione può comunque contare di nuovo lo stesso pathname. Le notifiche consecutive per un pathname invariato nella stessa sessione vengono deduplicate; lasciare un percorso e tornarvi può produrre un’altra visualizzazione di pagina.

Usa un sito web/token separato per i test, così i tuoi controlli non gonfiano i report di un cliente. Un download riuscito dello script, un’anteprima della pagina funzionante o vecchi dati in Setup health non dimostrano che una nuova installazione funzioni.

Lo script si carica ma non compare alcuna richiesta di raccolta

Controlla l’opt-out del browser, Do Not Track, Global Privacy Control o un browser automatizzato. window.seean può esistere con metodi inattivi quando la raccolta è disattivata, quindi controllare quell’oggetto da solo non basta. Carica lo snippet come script esterno classico, con data-site e data-api sullo stesso elemento.

Se il tuo sito web usa una Content Security Policy, consenti https://app.seean.io nella policy script effettiva e in connect-src. Se definisci script-src-elem, anche quella deve consentire il tracker. Unisci queste origini alla tua policy esistente; non sostituire il resto né abilitare tutte le origini. I loader inline usati da un tag manager possono inoltre richiedere la tua policy nonce/hash esistente. Vedi opzioni dello script.

Le richieste falliscono o i conteggi sono raddoppiati

Un token sconosciuto/ruotato può produrre un 404; una quota di fatturazione o un piano inattivo possono fermare la raccolta. Controlla la fatturazione e il token nell’HTML distribuito. Una richiesta bloccata o un errore CSP sono visibili negli strumenti per sviluppatori del browser. Segui le esclusioni quando le richieste riescono ma i dati previsti mancano.

Cerca k.js sia nei file del progetto sia nei container del tag manager. Mantieni una sola installazione e lasciale osservare la navigazione supportata. Aggiungere un trigger History Change che ricarica l’intero tracker, o inviare manualmente pageview a ogni navigazione, può raddoppiare i conteggi.

Test locali o automatizzati

Localhost e 127.0.0.1 richiedono data-local. L’automazione del browser o le impostazioni di privacy possono fermare intenzionalmente la raccolta. Un test dell’interfaccia del browser non è la prova che una visualizzazione di pagina reale sia stata ingerita.

I report sembrano diversi

Fai corrispondere sito web, intervallo di date, filtri e periodo calcolato. Tempo reale usa finestre di due e trenta minuti; la Panoramica copre di norma un intervallo più lungo. Le stime del paese e le importazioni delle query Google hanno i loro limiti.

Un’analisi non è partita

Ogni pagina di analisi avvia un calcolo per il suo periodo. L’avviso sopra la pagina spiega un rifiuto: Your current analyses are still running (Le tue analisi correnti sono ancora in esecuzione) attende quelle in corso; Too many analyses were started for this website. Try again in N seconds (Troppe analisi avviate per questo sito web. Riprova tra N secondi) significa che il budget di avvio (120 al minuto su tutti i siti web del proprietario dell’account e dei compagni di team; un burst di venti e trenta al minuto per sito web condiviso da link di condivisione, widget e visitatori della demo che non sono membri della demo) è esaurito, e la pagina riprova una volta da sola dopo l’attesa. Could not start this analysis. Please retry (Impossibile avviare questa analisi. Riprova) è un errore inatteso; la console del browser registra l’ID della richiesta server per il supporto. Retry analysis (Riprova analisi) riparte immediatamente.

Le analisi in background e i dettagli su richiesta condividono un budget di esecuzione limitato: due calcoli in tutto il servizio, al massimo uno per proprietario di sito web. Questo include Tempo reale e il conteggio leggero degli utenti online. Un calcolo in background attende mentre il budget è occupato; un dettaglio espanso può invece mostrare Analytics is busy. Retry the breakdown shortly. (Le analisi sono occupate. Riprova il dettaglio tra poco.) Usa Retry breakdown (Riprova dettaglio) dopo che un altro calcolo è terminato. Questo limita il lavoro analitico concorrente ma non è una garanzia di latenza di raccolta costante o di capacità illimitata. Un calcolo in caricamento o fallito non è un conteggio pari a zero.

Quando un calcolo termina, il calcolo in attesa successivo idoneo riceve subito il suo posto. Aprire più siti web in un unico account non aggiunge un ritardo fisso di nuovo tentativo dopo ogni calcolo completato. Un calcolo in esecuzione in quell’account deve comunque terminare prima; la preparazione dei dati sorgente accettati, le interruzioni dell’archiviazione e gli snapshot di ripristino possono ritardare il momento in cui un report diventa pronto.

Contattare in sicurezza

Includi screenshot degli errori dove utile. Non inviare password, codici di verifica, segreti dei ricavi o dati dei visitatori esportati a meno che non sia stato concordato un processo di supporto sicuro specifico. Le domande su fatturazione e account possono essere descritte senza esporre quei valori.

Qualcosa non è chiaro? Contatta il supporto.