analytics

Clamp Analytics는 쿠키나 개인 식별 정보 없이 제품 사용 데이터를 수집할 수 있는 경량 JavaScript SDK입니다. 프로젝트 ID로 라이브러리를 초기화하면 페이지뷰와 세션 정보가 자동으로 기록되며, 커스텀 이벤트를 전송하고 로그인한 사용자를 식별하며 수익 거래를 캡처하고 에러를 기록할 수 있습니다. 설치는 간단합니다: npm으로 패키지를 추가하거나 CDN을 가리키는 단일 스크립트 태그를 붙여넣기만 하면 됩니다. 스크립트는 data-clamp-project 속성에서 프로젝트 식별자를 읽어 즉시 추적을 시작합니다. React, Next.js, Vite, Nuxt, SvelteKit, Astro 등 프레임워크를 위한 전용 가이드와 루트 레이아웃에 배치할 수 있는 React 컴포넌트가 제공됩니다. API는 init, track, identify, reset, revenue, getAnonymousId, getUserId를 포함합니다. Track은 평평한 키-값 속성으로 모든 이름이 붙은 이벤트를 기록합니다. Revenue는 타입 지정된 헬퍼로 구독 및 구매 이벤트를 발행하며, 청구 기간을 기반으로 월 재발행 수익(MRR) 차액을 자동으로 계산합니다. Identify는 향후 이벤트에 안정적인 사용자 ID를 연결하고, reset은 로그아웃 시 해당 연결을 지웁니다. 타입스크립트에서 타입 이벤트 맵을 정의하면 커스텀 이벤트에 대한 컴파일 타임 자동 완성 및 유효성 검사를 얻을 수 있습니다. 수익 이벤트는 구독, 일회성 구매, 환불에 올바른 필드 조합을 강제하는 엄격한 유니온 타입을 따릅니다. 오류 처리를 활성화하여捕捉되지 않은 예외와 미처리 프라미스 거부사항을 $error 이벤트로 캡처할 수 있으며, 이들은 더 쉬운 분석을 위해フィン거프린트로 그룹화됩니다. 선택적 확장은 아웃바운드 링크, 파일 다운로드, 404 페이지, 데이터 속성 기반 이벤트, 웹 비트랄, 섹션 뷰 가시성에 대한 자동 트래킹을 추가합니다. 각 확장은 요청된 대로 로드되어 번들 크기를 최소화합니다. 서버사이드 사용은 별도 빌드를 통해 지원되며 API 키가 필요합니다. 백엔드 서비스, 웹훅 또는 서버 액션에서 동일한 이벤트를 발행하여 통합 이벤트 스트림을 보장할 수 있습니다. 수집된 모든 데이터는 Clamp Analytics 플랫폼에 저장되며, 월 10만 이벤트 무료 티어와 내장 Model Context Protocol 서버를 제공합니다. 이를 통해 Claude, Cursor, VS Code 확장 같은 AI 에이전트가 이벤트를 직접 쿼리할 수 있어 자연어 분석과 자동화된 인사이트가 가능합니다. SDK는 MIT 라이선스로 배포되며 clamp-sh/analytics 저장소에서 유지관리됩니다.