Documentación · Por Koolya
Cómo instalar el script de Koolya Analytics
Necesitas una empresa con Analytics disponible, un sitio activo y acceso para editar su configuración. Cada sitio tiene una clave pública de recogida propia. Copia siempre el snippet que muestra su pantalla de configuración.
Revisado el
1. Añade el script a tu web
Crea el sitio con su dominio y copia el código de instalación en la cabecera común. Sustituye CLAVE_PUBLICA_DEL_SITIO por la clave que muestra Koolya. El atributo async permite cargar el script sin bloquear el análisis del HTML.
Instálalo una sola vez por documento. Si tu gestor de contenidos permite editar la cabecera común, utiliza esa opción y comprueba que el código aparece en las páginas públicas.
<script async src="https://koolya.com/api/script?p=CLAVE_PUBLICA_DEL_SITIO"></script>2. Comprueba el primer evento
Abre una página del dominio configurado y revisa la actividad de ese sitio en Analytics. En las herramientas de red del navegador comprueba que /api/script devuelve JavaScript y que se envían solicitudes a /api/collect.
Si no llegan datos, revisa la clave, el dominio, que el sitio siga activo y la inclusión de Analytics en la empresa. Un bloqueador o una política CSP también puede impedir la carga. Si tienes CSP, autoriza koolya.com en script-src y connect-src sin eliminar las restricciones existentes.
3. Revisa la navegación
El tracker escucha cambios de historial en aplicaciones web y registra páginas vistas. Prueba una navegación real y revisa que no duplique el evento. No añadas una llamada manual de pageview si tu navegación ya se está registrando.
Las sesiones viven en memoria. Una recarga crea otra sesión; eso es parte del funcionamiento, no un error de instalación.