analytics

Clamp Analyticsは、Cookieや個人識別子を使用せずにプロダクト利用データを収集できる軽量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はログアウト時にその関連付けを解除します。 TypeScriptで型付きイベントマップを定義でき、カスタムイベントに対するコンパイル時のオートコンプリートと検証が可能になります。収益イベントは厳格なユニオン型に従い、サブスクリプション、ワンタイム購入、返金の正しいフィールド組み合わせを強制します。 エラーハンドリングを有効にすると、捕捉されない例外と未処理のプロミスキジェクトが$fingerprintでグループ化された$errorイベントとしてキャプチャされ、分析が容易になります。 オプトイン式エクステンションにより、外部リンク、ファイルダウンロード、404ページ、data属性駆動イベント、Web Vitals、セクション表示可視性の自動トラッキングが追加できます。各エクステンションはオンデマンドで読み込まれ、バンドルサイズを最小限に抑えます。 サーバーサイドでの使用も、APIキーを必要とする別ビルドを通じてサポートされています。バックエンドサービス、ウェブフック、サーバーアクションから同じイベントを発行でき、統一されたイベントストリームを確保できます。 収集されたすべてのデータはClamp Analyticsプラットフォームに保存され、毎月10万件の無料枠と内蔵Model Context Protocolサーバーを提供します。これにより、Claude、Cursor、VS Code拡張機能などのAIエージェントがイベントを直接クエリでき、自然言語による解析と自動インサイトが可能になります。 SDKはMITライセンスで提供され、clamp-sh/analyticsリポジトリで管理されています。