Habilitar mediciones opcionales
Estamos orgullosos de tener uno de los fragmentos de código JavaScript más livianos en la industria de análisis.
Logramos esto al limitar radicalmente la cantidad de opciones en el script predeterminado. En cambio, ofrecemos mediciones mejoradas como extensiones de script opcionales adaptadas a cómo desea utilizar Histat. Este enfoque garantiza que solo cargue el código que realmente se utilizará en su sitio web.
Puede habilitar estas mediciones opcionales al agregar un nuevo sitio a su cuenta de Histat o en el área "Instalación del sitio" de la sección "General" en la configuración del sitio
Tenga en cuenta que el fragmento de seguimiento que necesita insertar en su sitio cambia según su selección de mediciones mejoradas. Al realizar cambios en sus mediciones opcionales, asegúrese de insertar el fragmento más nuevo en su sitio para que todo el seguimiento funcione como se espera
A continuación, se muestra la lista de nuestras mediciones opcionales:
| Medición opcional | Explicación |
|---|---|
| Enlaces salientes | Rastrear clics en enlaces salientes automáticamente |
| Descargas de archivos | Rastrear descargas de archivos automáticamente |
| Páginas de error 404 | Realizar un «rastreo automático de páginas de error 404» |
| Rutas de páginas con hash | Realizar un «rastreo automático de rutas de páginas que utilizan un «#» en la URL «Enrutamiento basado en hash» |
| Eventos personalizados | Permite «realizar un seguimiento de eventos personalizados», como clics en enlaces, envíos de formularios y cualquier otro clic en elementos HTML |
| Propiedades personalizadas | Permite adjuntar «propiedades personalizadas» (también conocidas como dimensiones personalizadas en Google Analytics) al enviar una vista de página o un evento personalizado para crear métricas personalizadas |
| Ingresos de comercio electrónico | Permite asignar «valores monetarios» dinámicos a eventos personalizados y realizar un seguimiento de la atribución de ingresos |
Opciones de seguimiento avanzadas
Además de la lista anterior (script.outbound-links.js, script.file-downloads.js, script.hash.js, script.tagged-events.js, script.pageview-props.js y script.revenue.js), también tenemos algunas opciones de seguimiento más avanzadas disponibles. Tenga en cuenta que no están incluidas en la lista de incorporación del sitio, por lo que deberá insertarlas en su fragmento de seguimiento manualmente.
| Extensión | Explicación |
|---|---|
| script.compat.js | Modo de compatibilidad para seguimiento de usuarios en Internet Explorer (≥IE11) |
| script.local.js | Permitir que Analytics realice un seguimiento también en el host local, lo que es útil en aplicaciones híbridas |
| script.manual.js | No activar las visitas a la página automáticamente . También te permite "especificar ubicaciones personalizadas" para redactar URL con identificadores. También puedes usarlo para rastrear "parámetros de consulta personalizados" |
Cómo cambiar manualmente el fragmento de seguimiento
Por ejemplo, el nombre de script predeterminado en nuestro fragmento es "script.js". Si tu sitio web está en un servidor local y quieres rastrear esas visitas, tienes la opción de cargar el script con una extensión diferente: "script.local.js".
En este caso, el fragmento que necesitas insertar en tu sitio es el siguiente (asegúrate de cambiar el atributo data-domain al dominio que agregaste a Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>
Puedes mezclar y combinar estas extensiones de la forma que desees. Por ejemplo, si desea utilizar tanto nuestro enrutamiento basado en hash como nuestro seguimiento de clics en enlaces salientes, puede combinarlos de la siguiente manera: script.hash.outbound-links.js.
En este caso, el fragmento que debes insertar en tu sitio es el siguiente (asegúrate de cambiar el atributo data-domain al dominio que agregaste a Histat):
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>
O digamos que quieres usar nuestra extensión script.revenue.js para rastrear los ingresos del comercio electrónico y nuestra extensión script.local.js para rastrear el tráfico del host local, tu fragmento debería verse así:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>
Y solo necesitas insertar ese fragmento en tu sitio, no necesitas nada más.
script.compat.js
El script Histat predeterminado no funcionará en Internet Explorer porque utiliza la API document.currentScript para leer las opciones de configuración. Puede ejecutar Histat en modo de compatibilidad incluyendo la extensión script.compat.js y definiendo id="plausible" en la etiqueta del script para que pueda encontrarse a sí mismo. Tenga en cuenta que esto solo funciona en IE11 o superior. Así es como debería verse:
<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>
script.manual.js
De manera predeterminada, el script Histat activa una vista de página cuando se carga por primera vez. También adjunta oyentes a la API History y activará automáticamente las vistas de página cuando utilice history.pushState. Esto es útil para la mayoría de los sitios web, pero también ofrecemos un modo manual en caso de que desee un control total sobre cuándo se activan las visitas a la página en su sitio web.
Uno de los casos de uso para esto es cuando usa Turbo (anteriormente Turbolinks). En ese caso, desea activar manualmente las visitas a la página de Histat en el evento del navegador turbo:load o turbolinks:load según la biblioteca que use. Aquí le mostramos cómo puede hacerlo:
<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- define la función `plausible` para activar eventos manualmente -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) }</script>
<!-- activa las visitas a la página en la navegación de Turbolinks -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>
Al usar Turbolinks, debe asegurarse de que el script Histat no se cargue ni se ejecute durante la navegación Turbo. Es posible que deba mover el script a la sección <head> de su sitio web o usar el atributo data-turbo-eval="false" para hacerlo.
Al usar manual.js, cada llamada de script con 'pageview' da como resultado que se cuente una visita a la página por separado, incluso si se llama en la misma página
Especifique ubicaciones personalizadas para las URL de su página
Además, la extensión de script manual le permite proporcionar una opción especial denominada u con sus eventos. Esto le permite especificar la URL de la página y se puede utilizar para especificar ubicaciones personalizadas.
Es especialmente útil para redactar y agregar varias páginas cuyas URL contienen identificadores específicos de los usuarios.
Seguimiento de parámetros de consulta personalizados para URL de páginas completas
De forma predeterminada, Histat elimina todos los parámetros de consulta por motivos de privacidad ref, source, utm_source, utm_medium, utm_campaign, utm_content y utm_term.
Esto significa que páginas como yoursite.com/blog/index.php?article=some_article&page=11 se informarán como yoursite.com/blog/index.php en el informe "Páginas principales" de su panel de control de Histat.