Abilita misurazioni facoltative
Siamo orgogliosi di avere uno degli snippet JavaScript più leggeri nel settore dell'analisi.
Ci riusciamo limitando radicalmente il numero di opzioni nello script predefinito. Invece, offriamo misurazioni avanzate come estensioni di script facoltative su misura per il modo in cui desideri utilizzare Histat. Questo approccio assicura che tu carichi solo il codice che verrà effettivamente utilizzato sul tuo sito web.
Puoi abilitare queste misurazioni facoltative quando aggiungi un nuovo sito al tuo account Histat o nell'area "Installazione sito" della sezione "Generale" nelle tue impostazioni sito
Nota che lo snippet di monitoraggio che devi inserire nel tuo sito cambia a seconda della selezione delle misurazioni avanzate. Quando apporti modifiche alle tue misurazioni facoltative, assicurati di inserire lo snippet più recente nel tuo sito affinché tutto il monitoraggio funzioni come previsto
Ecco l'elenco delle nostre misurazioni facoltative:
| Misurazione facoltativa | Spiegazione |
|---|---|
| Collegamenti in uscita | Traccia automaticamente i clic sui collegamenti in uscita` |
| Download di file | Traccia automaticamente i download di file |
| Pagine di errore 404 | Traccia automaticamente le pagine di errore 404 |
| Percorsi di pagina con hash | Traccia automaticamente i percorsi di pagina che utilizzano un # nell'URL routing basato su hash |
| Eventi personalizzati | Consente di tracciare eventi personalizzati come clic sui link, invii di moduli e qualsiasi altro clic su elemento HTML |
| Proprietà personalizzate | Consente di allegare proprietà personalizzate (note anche come dimensioni personalizzate in Google Analytics) quando si invia una visualizzazione di pagina o un evento personalizzato per creare metriche personalizzate |
| Ricavi e-commerce | Consente di assegnare valori monetari dinamici agli eventi personalizzati e di tracciare l'attribuzione dei ricavi |
Opzioni di tracciamento avanzate
Oltre all'elenco precedente (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js e script.revenue.js), abbiamo anche altre opzioni di tracciamento avanzate disponibili. Nota che queste non sono incluse nell'elenco di onboarding del sito, quindi dovrai inserirle manualmente nel tuo snippet di tracciamento.
| Estensione | Spiegazione |
|---|---|
| script.compat.js | Modalità di compatibilità per tracciamento utenti su Internet Explorer (≥IE11) |
| script.local.js | Consenti all'analisi di tracciare anche su localhost, il che è utile nelle app ibride |
| script.manual.js | Non attivare automaticamente le visualizzazioni di pagina. Consente inoltre di specificare posizioni personalizzate per censurare gli URL con identificatori. Puoi anche usarlo per tracciare parametri di query personalizzati |
Come modificare manualmente lo snippet di tracciamento
Ad esempio, il nome script predefinito nel nostro snippet è script.js. Se il tuo sito web è su un localhost e desideri tracciare quelle visite, hai la possibilità di caricare lo script con un'estensione diversa: script.local.js.
In questo caso, lo snippet che devi inserire nel tuo sito è il seguente (assicurati di modificare l'attributo data-domain con il dominio che hai aggiunto a Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Puoi mescolare e abbinare e combinare queste estensioni come preferisci. Ad esempio, se vuoi utilizzare sia il nostro routing basato su hash che il nostro monitoraggio dei clic sui link in uscita, puoi combinarli come segue: script.hash.outbound-links.js.
In questo caso, lo snippet che devi inserire nel tuo sito è il seguente (assicurati di cambiare l'attributo data-domain con il dominio che hai aggiunto a Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
Oppure, se vuoi usare la nostra estensione script.revenue.js per tracciare i ricavi dell'e-commerce e la nostra estensione script.local.js per tracciare il traffico localhost, il tuo snippet dovrebbe apparire così:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
E devi solo inserire quello snippet nel tuo sito, non serve altro.
script.compat.js
Lo script Histat predefinito non funzionerà su Internet Explorer perché utilizza l'API document.currentScript per leggere le opzioni di configurazione. Puoi eseguire Histat in modalità di compatibilità includendo l'estensione script.compat.js e definendo id="plausible" sul tag script in modo che possa trovare se stesso. Nota che questo funziona solo su ≥ IE11. Ecco come dovrebbe apparire:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
Per impostazione predefinita, lo script Histat attiva una visualizzazione di pagina quando viene caricato per la prima volta. Collega inoltre gli ascoltatori all'API History e attiverà automaticamente le visualizzazioni di pagina quando utilizzi history.pushState. Questa è utile per la maggior parte dei siti web, ma offriamo anche una modalità manuale nel caso in cui desideri il controllo completo su quando vengono attivate le visualizzazioni di pagina sul tuo sito web.
Uno dei casi d'uso per questo è quando usi Turbo (in precedenza Turbolinks). In quel caso, vuoi attivare manualmente le visualizzazioni di pagina Histat sull'evento del browser turbo:load o turbolinks:load a seconda della libreria che usi. Ecco come puoi farlo:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- definisci la funzione `plausible` per attivare manualmente gli eventi -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- attiva le visualizzazioni di pagina sulla navigazione turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
Quando usi turbolinks, dovresti assicurarti che lo script Histat non venga caricato ed eseguito durante la navigazione turbo. Potresti dover spostare lo script nella sezione <head> del tuo sito web o usare l'attributo data-turbo-eval="false" per farlo.
Quando usi manual.js ogni chiamata allo script con 'pageview' comporta il conteggio di una visualizzazione di pagina separata anche se chiamata sulla stessa pagina
Specifica posizioni personalizzate per gli URL delle tue pagine
Inoltre, l'estensione dello script manuale ti consente di fornire un'opzione speciale denominata u con i tuoi eventi. Ciò consente di specificare l'URL della pagina e può essere utilizzato per specificare posizioni personalizzate.
È particolarmente utile per censurare e aggregare più pagine i cui URL contengono identificatori specifici per gli utenti.
Traccia i parametri di query personalizzati per URL di pagina completi
Per impostazione predefinita, Histat elimina tutti i parametri di query per scopi di privacy ref, source, utm_source, utm_medium, utm_campaign, utm_content e utm_term.
Ciò significa che pagine come yoursite.com/blog/index.php?article=some_article&page=11 saranno segnalate come yoursite.com/blog/index.php nel report "Top Pages" della dashboard Histat.