takt-angular

El paquete @vskstudio/takt-angular ofrece una integración nativa de Angular para la plataforma de analítica Takt, centrada en la recopilación de datos con enfoque de privacidad. Está diseñado para Angular 17 y versiones posteriores, y puede añadirse a un proyecto con un único comando del gestor de paquetes. Instalación Ejecute: pnpm add @vskstudio/takt-angular @vskstudio/takt-core Integración en el Bootstrap En la llamada raíz de bootstrap, registre el proveedor usando provideTakt. El proveedor inicializa la biblioteca central de analítica solo en el navegador, envía una vista de página inicial, activa funciones opcionales de captura automática (clics en enlaces externos, descargas de archivos, navegación SPA, etc.) y limpia los recursos cuando la aplicación Angular se destruye. En el lado del servidor el proveedor es inerte, lo que hace que la biblioteca sea segura para renderizado del lado del servidor. Servicio Inyectable TaktService puede inyectarse en cualquier parte de la aplicación. Expone métodos como track(eventName, options), pageview(), optOut() y optIn(). Todos los métodos son no‑operacionales antes de que la biblioteca se inicialice o cuando se ejecuta en el servidor, garantizando que nunca lancen excepciones. Seguimiento Declarativo de Clics La directiva TaktEventDirective permite a los desarrolladores adjuntar seguimiento a cualquier elemento clicable mediante el atributo taktEvent, con entradas opcionales taktProps y taktRevenue. La directiva resuelve la instancia de analítica en tiempo de clic, manteniendo limpio el marcado. Widgets UI Se proporcionan dos componentes independientes: - TaktBadgeComponent renderiza una insignia SVG generada en el servidor para un dominio dado. - TaktEmbedComponent renderiza un iframe aislado que muestra paneles de analítica públicos. Ambos componentes pueden usarse en cualquier plantilla Angular y admiten entradas para dominio, tema, tamaño, idioma y variante visual. API Pública de Estadísticas El helper createStats crea un cliente para la API pública de Takt. Ofrece métodos asíncronos summary, timeseries, realtime y breakdown, permitiendo a los desarrolladores obtener datos analíticos agregados de forma programática. Elemento Personalizado Independiente del Framework Para páginas que no usan Angular se exporta un elemento personalizado autónomo llamado takt-analytics. Después de llamar a defineTaktElement (o importar el módulo que ejecuta automáticamente el registro), el elemento puede insertarse en HTML puro y respetará automáticamente la configuración de privacidad, como el seguimiento de enlaces externos y descargas de archivos. También está disponible un bundle CDN para inclusión rápida sin necesidad de compilación. Opciones de Configuración TaktConfig admite un conjunto amplio de opciones, incluyendo dominio, endpoint, seguimiento de enlaces externos, seguimiento de descargas de archivos, navegación SPA, respeto a Do Not Track, exclusión de localhost, tasa de muestreo, manejo de cadenas de consulta, exclusiones de rutas, limpieza de URL y seguimiento de elementos etiquetados. Los valores predeterminados son razonables para la mayoría de los sitios, y la configuración puede suministrarse a provideTakt en el bootstrap. Licencia La biblioteca se publica bajo la licencia MIT.