Aggiungere il tracker
Installa il tag script del tuo sito e controlla che gli eventi arrivino. Rivedi i tuoi requisiti di consenso prima di attivare la raccolta.
1. Copia il tuo snippet
Accedi, apri il tuo sito web e vai su Settings → Installation → Scripts (Impostazioni → Installazione → Script). Il tuo snippet ha questo aspetto, con il token del tuo sito. Lo stile Minimal (Minimo) mostrato qui legge le sue opzioni da Installation → Dashboard; lo stile Explicit (Esplicito) scrive le stesse opzioni come attributi dello script (vedi Opzioni dello script).
<script defer src="https://app.seean.io/k.js"
data-site="YOUR_SITE_TOKEN"
data-api="https://app.seean.io"></script>Mantieni sia l’indirizzo dello script sia quello dell’API su https://app.seean.io, come mostrato sopra, a meno che la raccolta first-party non sia attiva in Installation; in quel caso per entrambi si usa l’hostname generato <slug>-collect.seean.io - oppure un tuo dominio di raccolta personalizzato attivo. Uno snippet esistente che usa questi indirizzi non deve cambiare quando Seean aggiorna la propria infrastruttura.
2. Incollalo prima di </head>
Usa il documento HTML condiviso o il layout radice per ogni pagina che vuoi misurare. Segui la guida della tua piattaforma per il posizionamento corretto. Installa il tracker una sola volta: usare sia un layout sia un tag manager può contare le visite due volte.
Il tracker osserva la navigazione supportata tramite History API, ad esempio / → /pricing. Le stringhe di query non fanno parte del percorso della pagina; i frammenti hash vengono ignorati a meno che tu non imposti data-hash="true". Una campagna con tag diversa o una sessione scaduta possono comunque avviare una nuova sessione e contare di nuovo lo stesso pathname. Carica il tracker come script esterno classico; non importarlo nel bundle della tua applicazione e non aggiungere type="module".
3. Verifica
Apri il sito pubblicato in una normale scheda del browser, poi controlla Settings → Installation → Setup health (Impostazioni → Installazione → Stato della configurazione) per il sito web corrispondente. Last pageview received (Ultima visualizzazione di pagina ricevuta) mostra l’ora della visualizzazione di pagina conservata più recente; prima di qualsiasi visualizzazione, Installation verified (Installazione verificata) mostra quando la pagina pubblicata ha superato il controllo per l’ultima volta. Usa Check installation (Controlla installazione) per ispezionare la home page pubblicata alla ricerca di tracker, token e policy di sicurezza. Seean controlla anche la home page pubblicata automaticamente in background (ogni minuto nel primo giorno del sito web), così l’installazione è verificata appena lo snippet viene pubblicato, anche quando la dashboard è chiusa. Il banner della Panoramica scompare quindi senza attendere una visita.
Un riferimento nel codice sorgente o una vecchia visita non dimostrano che la tua ultima distribuzione funzioni. Abbina un nuovo percorso di pagina e orario in Eventi usando i controlli di installazione. La guida alla diagnostica della configurazione spiega risultati, permessi e limiti.
Opzioni dello script
Installation → Dashboard contiene le opzioni di tracciamento del sito web: campagne UTM (attive), percorsi di pagina con hash (disattivi), Web Vitals (attivi), conversioni automatiche (attive per i siti web nuovi e mai configurati), log di debug (disattivo) e hostname cross-domain. Save tracking options (Salva opzioni di tracciamento) le memorizza; uno snippet minimo le applica al caricamento successivo della pagina. Lo stile di snippet Explicit scrive invece le stesse scelte come attributi:
| Attributo | Predefinito | Effetto |
|---|---|---|
data-conversions="true" |
disattivo nell’HTML grezzo | Carica i preset di conversione automatici attivi una volta per documento. Gli snippet espliciti generati lo includono mentre Auto conversions è attivo. |
data-hash="true" |
disattivo | Conta le modifiche di location.hash come visualizzazioni di pagina e riporta il percorso con il suo frammento, ad esempio /docs#install. |
data-utm="off" |
attivo | Smette di leggere utm_source, utm_medium e utm_campaign; un link con tag non avvia più una nuova sessione. |
data-vitals="off" |
attivo | Salta del tutto la misurazione dei Web Vitals (nessun observer delle prestazioni). |
data-debug="true" |
disattivo | console.debug di ogni payload prima dell’invio. Sicuro quando la console non è disponibile. |
data-domains="a.com,b.com" |
disattivo | Passaggio cross-domain: i link verso gli host elencati (e i loro sottodomini) portano l’ID visitatore, e una pagina di destinazione adotta un ID in arrivo. |
Quando uno qualsiasi di questi attributi è presente, le opzioni della dashboard vengono ignorate per quella pagina. Dettagli e valori predefiniti: Opzioni dello script e del tracciamento.
Cosa invia il tracker
| Campo | Cos’è |
|---|---|
| path | il percorso della pagina, senza stringa di query (con il frammento quando data-hash è attivo) |
| hostname | il sito web misurato |
| referrer | l’URL di provenienza del browser; il collettore conserva solo il suo hostname |
| timezone | fallback per il paese quando l’edge di rete non ne riporta nessuno |
| visitorId, sessionId | le identità predefinite sono derivate sul server per sito web e giorno UTC; il passaggio cross-domain opzionale porta l’identità nel session storage valido per la giornata |
| campaign | source, medium, campaign, term e content UTM quando presenti, a meno che data-utm="off" |
| click id | il nome di un parametro click-id pubblicitario presente nell’URL di destinazione (gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid); il valore non viene mai letto. Disattivo con data-utm="off" |
| title | document.title, i primi 200 caratteri |
| uid | il tuo id utente dopo seean.identify(id), memorizzato solo quando Identify users (Identifica utenti) è attivo per il sito web |
| screen | screen.width x screen.height |
| Web Vitals | LCP, INP, CLS, FCP e TTFB; misurazioni successive possono aggiornare un campione. Disattivo con data-vitals="off" |
Il collettore legge paese, regione e città dalle intestazioni dell’edge di rete della richiesta, usa lo user agent per le categorie di browser, sistema operativo e dispositivo, registra il primo tag Accept-Language del browser come lingua del visitatore e può usare la regione di quella lingua come fallback per il paese. L’indirizzo IP viene confrontato solo con le regole di esclusione e non viene mai memorizzato. Le stringhe di query diverse dai campi UTM e dal nome del click-id non vengono mai raccolte.
Il tracciamento predefinito usa un hash server giornaliero limitato al sito web, senza cookie né archiviazione di misurazione persistente nel browser. Il passaggio cross-domain opt-in usa sessionStorage valido per la giornata. La raccolta si ferma per Do Not Track, Global Privacy Control o l’opt-out del browser descritto in Esclusioni. Dove si applica un consenso o un opt-out, controlla il caricamento dello script tramite il meccanismo di consenso del tuo sito. Vedi privacy tecnica e archiviazione e consenso.
Sviluppo locale
Il tracker ignora localhost e 127.0.0.1 a meno che tu non aggiunga data-local al tag script. Usa un sito web/token Seean separato per il traffico di test e copia l’indirizzo API dallo snippet di quel sito. Browser automatizzati, Do Not Track, Global Privacy Control e l’opt-out del browser possono comunque fermare la raccolta; data-local non disattiva quei controlli.
Rimuovere o aggiornare un’installazione
Rimuovi lo script dal suo layout o tag manager e pubblica la modifica per fermare la raccolta futura da quell’installazione. I report esistenti restano. Ruotare il token di tracciamento di un sito invalida immediatamente i suoi vecchi snippet; aggiorna ogni installazione con il nuovo token. Vedi impostazioni del sito web.
Qualcosa non è chiaro? Contatta il supporto.