Об этом проекте

Clamp Analytics — это легкий JavaScript SDK, позволяющий собирать данные об использовании продукта без куки или персональных идентификаторов. После инициализации библиотеки с вашим ID проекта просмотры страниц и информация о сессиях записываются автоматически, а вы можете отправлять пользовательские события, идентифицировать авторизованных пользователей, фиксировать транзакции дохода и логировать ошибки. Установка проста: добавьте пакет через npm или вставьте один тег script, указывающий на CDN. Скрипт считывает идентификатор проекта из атрибута data-clamp-project и сразу начинает отслеживание. Для фреймворков вроде React, Next.js, Vite, Nuxt, SvelteKit, Astro и других SDK предоставляет специальные руководства и React-компонент, который можно разместить в корневом макете. API включает init, track, identify, reset, revenue, getAnonymousId и getUserId. Track позволяет записывать любое именованное событие с плоскими свойствами ключ-значение. Revenue — типизированный хелпер, который генерирует канонические события подписки и покупки, автоматически рассчитывая дельты ежемесячной регулярной выручки (MRR) на основе биллингового периода. Identify привязывает стабильный ID пользователя к будущим событиям, а reset очищает ассоциацию при выходе. Типизированные карты событий можно определять в TypeScript, обеспечивая автодополнение и валидацию на этапе компиляции для пользовательских событий. События дохода следуют строгому union-типу, который требует правильного набора полей для подписок, разовых покупок и возвратов. Обработку ошибок можно включить для перехвата необработанных исключений и отклоненных промисов как событий $error, которые группируются по отпечатку для упрощения анализа. Опциональные расширения добавляют автоотслеживание исходящих ссылок, скачивания файлов, страниц 404, событий на основе data-атрибутов, Web Vitals и видимости секций. Каждое расширение загружается по требованию, сохраняя минимальный размер бандла. Серверное использование поддерживается через отдельную сборку, требующую API-ключ. Вы можете генерировать те же события из бэкенд-сервисов, вебхуков или серверных действий, обеспечивая единый поток событий. Все собранные данные хранятся в платформе Clamp Analytics, которая предоставляет бесплатный тариф 100 тыс. событий в месяц и встроенный сервер Model Context Protocol. Это делает события напрямую запрашиваемыми ИИ-агентами вроде Claude, Cursor или расширений VS Code, позволяя проводить аналитику на естественном языке и получать автоматические инсайты. SDK распространяется под лицензией MIT и поддерживается в репозитории clamp-sh/analytics.