Documentación · Por Koolya
Dominios permitidos y rutas excluidas del tracker
El tracker admite dos atributos opcionales en el elemento script: data-domains limita los nombres de host donde se ejecuta y data-exclude omite rutas. Son controles de instalación en el navegador, útiles para distinguir la web pública de otras zonas.
Revisado el
Permitir nombres de host concretos
Escribe nombres de host separados por comas, sin protocolo, puerto ni barras. La comparación es exacta con window.location.hostname: example.com no incluye automáticamente www.example.com ni tienda.example.com. No añadas espacios alrededor de las comas.
Si el atributo está vacío, el script no aplica esta lista de host. Cuando copies el ejemplo, sustituye tanto la clave como los dominios por los de tu sitio. Comprueba la versión publicada en cada host, especialmente si compartes una plantilla con un entorno de pruebas.
<script defer src="https://koolya.com/api/script?p=TU_CLAVE_PUBLICA"
data-domains="example.com,www.example.com"></script>Excluir una ruta y sus descendientes
La ruta /admin excluye /admin y /admin/usuarios, pero no /administracion. Usa rutas que empiecen por barra y sepáralas por comas. El control comprueba pathname; no es un filtro por parámetros UTM ni por fragmentos de la URL.
Puedes combinar ambos atributos en el mismo script. Las exclusiones evitan que el tracker envíe eventos desde esas rutas; no borran registros anteriores ni protegen el acceso a la página. La autorización de una zona privada debe resolverse en tu aplicación.
<script defer src="https://koolya.com/api/script?p=TU_CLAVE_PUBLICA"
data-exclude="/admin,/area-privada"></script>Verifica una página incluida y otra excluida
Abre una ruta pública y comprueba su petición de eventos. Repite en una ruta excluida y confirma que no se envían nuevos eventos. En una SPA, prueba también el cambio entre ambas rutas sin recargar. Conserva la lista junto a las instrucciones de instalación para revisarla al crear nuevas secciones.