analytics

Clamp Analytics es un SDK de JavaScript ligero que permite recopilar datos de uso del producto sin cookies ni identificadores personales. Tras inicializar la librería con tu ID de proyecto, las vistas de página y la información de sesión se registran automáticamente, y puedes enviar eventos personalizados, identificar usuarios conectados, capturar transacciones de ingresos y registrar errores. La instalación es sencilla: añade el paquete con npm o pega una sola etiqueta de script que apunte al CDN. El script lee el identificador del proyecto desde un atributo data-clamp-project y comienza a rastrear inmediatamente. Para frameworks como React, Next.js, Vite, Nuxt, SvelteKit, Astro y otros, el SDK ofrece guías dedicadas y un componente de React que puede colocarse en el diseño raíz. La API incluye init, track, identify, reset, revenue, getAnonymousId y getUserId. Track permite registrar cualquier evento con nombre y propiedades planas de clave-valor. Revenue es un auxiliar tipado que emite eventos canónicos de suscripción y compra, calculando automáticamente los deltas de ingresos recurrentes mensuales (MRR) según el período de facturación. Identify vincula un ID de usuario estable a eventos futuros, mientras que reset elimina la asociación al cerrar sesión. Los mapas tipados de eventos pueden definirse en TypeScript, proporcionando autocompletado y validación en tiempo de compilación para eventos personalizados. Los eventos de ingresos siguen un tipo unión estricto que aplica la combinación correcta de campos para suscripciones, compras únicas y devoluciones. El manejo de errores puede activarse para capturar excepciones no controladas y rechazos de promesas no manejados como eventos $error, agrupados por huella digital para facilitar el análisis. Las extensiones opcionales añaden seguimiento automático de enlaces salientes, descargas de archivos, páginas 404, eventos basados en atributos de datos, web vitals y visibilidad de secciones. Cada extensión se carga bajo demanda, manteniendo el tamaño del paquete mínimo. El uso del lado del servidor es compatible a través de una versión separada que requiere una clave de API. Puedes emitir los mismos eventos desde servicios backend, webhooks o acciones del servidor, asegurando un flujo de eventos unificado. Todos los datos recopilados se almacenan en la plataforma Clamp Analytics, que ofrece una capa gratuita de 100 k eventos por mes y un servidor integrado de Model Context Protocol. Esto hace que los eventos sean directamente consultables por agentes de IA como Claude, Cursor o extensiones de VS Code, permitiendo analítica en lenguaje natural e insights automatizados. El SDK se publica bajo la licencia MIT y se mantiene en el repositorio clamp-sh/analytics.