Google BigQuery コネクター

1. 生テレメトリーを BigQuery にエクスポートする理由

MousePlayer のダッシュボードは、セッション再生や視覚的なヒートマップをすぐに提供します。一方、企業のデータサイエンスやビジネスインテリジェンス（BI）のチームには、生の行動ログへの直接の SQL アクセスが必要です。MousePlayer のデータを Google BigQuery に同期すると、次のことができます。

• テレメトリーとバックエンドデータの結合： 独自の SQL クエリで、フロントエンドのユーザーセッションを CRM レコード、決済ゲートウェイのログ、請求データベースと結合できます。
• 独自の AI/ML モデルの学習： 詳細なマウス移動の軌跡や連打クリックのパターンを使い、離反予測や不正検出のアルゴリズムを学習できます。
• MousePlayer 上のストレージ費用はゼロ： データはお客様の GCP プロジェクトへ直接エクスポートされます。データの所有権を100%保持し、企業の IAM ポリシーに準拠できます。

2. Business プランと Enterprise プランの機能

BigQuery コネクターを利用できるのは、 Business と Enterprise プランだけです。プランに応じて、毎日の夜間自動エクスポートに含めるデータセットを選べます。

エクスポートされるテーブル	データ内容 & スキーマ	Business プラン	Enterprise プラン
visitor_sessions_YYYYMMDD	セッションの全メタデータ（セッション ID、訪問者 ID、IP、国、デバイス、OS、ブラウザー、時間、リファラー、UTM、custom_user_id）。	含まれます	含まれます
visitor_custom_events_YYYYMMDD	すべての標準コンバージョンとカスタムイベント（例： purchase、 rage_click、 error_detected、フォーム送信）、および型付き EAV パラメーター。	含まれます	含まれます
mouse_events_YYYYMMDD	記録した各ページビューの詳細な座標ストリーム（X、Y、タイムスタンプ、スクロールの深さ、クリック対象、対象の CSS セレクター）。	利用不可	Enterprise 限定

3. 設定ガイド：GCP サービスアカウント & IAM 権限

MousePlayer がお客様個人の Google ログイン情報を求めることはありません。代わりに、Google Cloud Console で、最小限の権限を持つ専用のサービスアカウントを作成します。

1. Google Cloud Console で、 IAM & 管理 → サービスアカウント に移動し、 サービスアカウントを作成をクリックします。
2. サービスアカウントに名前を付けます（例： mouseplayer-bq-writer）。
3. IAM ロールを、次の二つだけ割り当てます： BigQuery Data Editor と BigQuery Job User。
4. 新しいサービスアカウントの キー タブに移動し、 キーを追加 → 新しいキーを作成をクリックして、 JSONを選択します。
5. MousePlayer のダッシュボードを開き、 プロパティ → 設定 → BigQueryに移動し、GCP プロジェクト ID、データセット ID、サービスアカウントのメールアドレス、JSON キーの内容を貼り付けます。