segment-cdp について
Segment CDP のイベント計測を計画するスキルです。ブラウザーと Node.js の追跡方法、イベント設計、よくある誤りを扱います。
主な機能
- 01Analytics.js によるブラウザー計測
- 02Node.js のサーバーサイド計測
- 03イベントスキーマ設計
- 04計測のアンチパターン解説
活用シーン
- 01ブラウザー操作の計測
- 02バックエンドや webhook のイベント送信
- 03イベントスキーマの定義と検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/segment-cdpを入力して読み込まれたか確認します。
詳細
Segment CDP
パターン
Analytics.js ブラウザー連携
Analytics.js を使ったクライアントサイドのトラッキングです。track、identify、page、group の各呼び出しを含めます。匿名 ID は、identify でユーザーと統合されるまで保持されます。
Node.js によるサーバーサイドトラッキング
@segment/analytics-node を使った高性能なサーバーサイドのトラッキングです。内部でバッチ処理を行い、ノンブロッキングで動作します。バックエンドのイベント、Webhook、機密データの送信に不可欠です。
トラッキングプランの設計
Object + Action の命名規則を使ってイベントスキーマを設計します。必須プロパティ、型、検証ルールを定義します。 適用のために Protocols と連携させます。
アンチパターン
❌ 動的なイベント名
❌ プロパティをイベントとしてトラッキングする
❌ track の前に identify を呼ばない
⚠️ 注意すべき落とし穴
| Issue | Severity | Solution |
|---|---|---|
| Issue | medium | See docs |
| Issue | high | See docs |
| Issue | medium | See docs |
| Issue | high | See docs |
| Issue | low | See docs |
| Issue | medium | See docs |
| Issue | medium | See docs |
| Issue | high | See docs |
コメント
Markdown 対応