Activa les mesures opcionals
Estem orgullosos de tenir un dels fragments de JavaScript més lleugers del sector de l'anàlisi.
Ho aconseguim limitant radicalment el nombre d'opcions de l'script predeterminat. En canvi, oferim mesures millorades com a extensions d'script opcionals adaptades a com voleu utilitzar Histat. Aquest enfocament garanteix que només carregueu el codi que s'utilitzarà realment al vostre lloc web.
Podeu activar aquestes mesures opcionals quan afegiu un lloc nou al vostre compte d'Histat o a l'àrea "Instal·lació del lloc" de la secció "General" a la vostra "configuració del lloc".
Tingueu en compte que el fragment de seguiment que heu d'inserir al vostre lloc canvia en funció de la vostra selecció de mesures millorades. Quan feu canvis a les vostres mesures opcionals, assegureu-vos d'inserir el fragment més recent al vostre lloc perquè tot el seguiment funcioni com s'esperava.
Aquí teniu la llista de les nostres mesures opcionals:
| Mesura opcional | Explicació |
|---------------------------|----------------------- -------------------------------------------------- -----------------------------|
| Enllaços de sortida | Seguiment dels clics als enllaços de sortida' | | Descàrregues de fitxers | Seguir automàticament les descàrregues de fitxers| | 404 pàgines d'error |Seguir automàticament les pàgines d'error 404' |
| Camins de pàgines amb hash | Feu un seguiment automàtic dels camins de la pàgina que utilitzen un "#" a l'URL "encaminament basat en hash" |
| Esdeveniments personalitzats | Us permet fer un "seguiment d'esdeveniments personalitzats", com ara clics en enllaços, enviaments de formularis i qualsevol altre clic d'element HTML |
| Propietats personalitzades | Us permet adjuntar "propietats personalitzades" (també conegudes com a dimensions personalitzades a Google Analytics) quan envieu una pàgina vista o un esdeveniment personalitzat per crear mètriques personalitzades |
| Ingressos de comerç electrònic | Us permet assignar "valors monetaris" dinàmics a esdeveniments personalitzats i fer un seguiment de l'atribució d'ingressos |
Opcions de seguiment avançades
A més de la llista anterior (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview- props.js i script.revenue.js), també tenim algunes opcions de seguiment més avançades disponibles. Tingueu en compte que aquests no s'inclouen a la llista d'incorporació del lloc, de manera que haureu d'inserir-los manualment al fragment de seguiment.
| Extensió | Explicació |
|---------------------------|----------------------- -------------------------------------------------- -----------------------------|
| script.compat.js | Mode de compatibilitat per al "seguiment d'usuaris a Internet Explorer" (≥IE11) |
| script.local.js | Permet que l'anàlisi també faci un seguiment a localhost, cosa que és útil a les aplicacions híbrides |
| script.manual.js | No activeu les pàgines vistes automàticament També us permet "especificar ubicacions personalitzades" per redactar URL amb identificadors. També podeu utilitzar-lo per fer un seguiment dels paràmetres de consulta personalitzats|
Com canviar manualment el fragment de seguiment
Per exemple, el nom de l'script predeterminat al nostre fragment és script.js. Si el vostre lloc web es troba en un host local i voleu fer un seguiment d'aquestes visites, teniu l'opció de carregar l'script amb una extensió diferent: script.local.js.
En aquest cas, el fragment que heu d'inserir al vostre lloc és el següent (assegureu-vos de canviar l'atribut de domini de dades al domini que heu afegit a Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Podeu combinar, combinar i combinar aquestes extensions de la manera que vulgueu. Per exemple, si voleu utilitzar tant el nostre enrutament basat en hash com el nostre seguiment de clics d'enllaços de sortida, podeu combinar-los de la següent manera: script.hash.outbound-links.js.
En aquest cas, el fragment que heu d'inserir al vostre lloc és el següent (assegureu-vos de canviar l'atribut de domini de dades al domini que heu afegit a Histat):
<script defer data-domain="yourdomain.com" src="https://plausible.com/js/script.hash.outbound-links.js"></script>
O digueu que voleu utilitzar la nostra extensió script.revenue.js per fer un seguiment dels ingressos del comerç electrònic i la nostra extensió script.local.js per fer un seguiment del trànsit localhost, el vostre fragment hauria de tenir aquest aspecte:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
I només heu d'inserir aquest fragment al vostre lloc, sense necessitat de res més.
script.compat.js
L'script d'Histat predeterminat no funcionarà a Internet Explorer perquè utilitza l'API document.currentScript per llegir les opcions de configuració. Podeu executar Histat en mode de compatibilitat incloent l'extensió script.compat.js i definint id="plausible" a l'etiqueta de l'script perquè pugui trobar-se. Tingueu en compte que això només funciona amb ≥ IE11. Així és com hauria de ser:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
De manera predeterminada, l'script d'Histat activa una pàgina vista quan es carrega per primera vegada. També connecta els oients a l'API History i activarà automàticament les pàgines vistes quan utilitzeu history.pushState. Això és útil per a la majoria de llocs web, però també oferim un mode manual per si voleu un control total sobre quan s'activen les pàgines vistes al vostre lloc web.
Un dels casos d'ús d'això és quan utilitzeu Turbo (abans Turbolinks). En aquest cas, voleu activar manualment les visualitzacions de pàgina d'Histat a l'esdeveniment del navegador turbo:load' o turbolinks:load', depenent de la biblioteca que feu servir. A continuació us indiquem com podeu fer-ho:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- defineix la funció `plausible` per activar manualment esdeveniments -->
<script>window.plausible = finestra.plausible || function() { (window.plausible.q = window.plausible.q || []).push (arguments) }</script>
<!-- activa les pàgines vistes a la navegació amb turboenllaços -->
<script>
document.addEventListener("turbo:load", function() {
plausible('visualització de pàgina')
})
</script>
Quan utilitzeu turbolinks, us heu d'assegurar que l'script d'Histat no es carregui i s'executi durant la navegació turbo. És possible que hàgiu de moure l'script a la secció <head> del vostre lloc web o utilitzar l'atribut data-turbo-eval="false" per fer-ho.
Quan s'utilitza manual.js, cada trucada d'script amb `'pageview'' fa que es compti una pàgina vista independent encara que es crida a la mateixa pàgina
Especifiqueu ubicacions personalitzades per als URL de les vostres pàgines
A més, l'extensió d'script manual us permet proporcionar una opció especial anomenada u amb els vostres esdeveniments. Això us permet especificar l'URL de la pàgina i es pot utilitzar per especificar ubicacions personalitzades.
És especialment útil redactar i agregar diverses pàgines els URL de les quals contenen identificadors específics dels usuaris.
Feu un seguiment dels paràmetres de consulta personalitzats per als URL de les pàgines completes
De manera predeterminada, Histat elimina tots els paràmetres de consulta per a finalitats de privadesa ref, source, utm_source, utm_medium, utm_campaign, utm_content i utm_term.
Això vol dir que pàgines com yoursite.com/blog/index.php?article=some_article&page=11 s'informaran com a yoursite.com/blog/index.php a l'informe "Pàgines principals" del vostre Tauler de control d'Histat.