PostHog、Mixpanel & Amplitude の連携ブリッジ

プロダクト分析ツールで分かるのは、 何が 起きたかです。MousePlayer では、 なぜ起きたかが分かります。この連携ブリッジは両者を双方向に接続し、ファネルの離脱から、その理由を説明する録画へワンクリックで移動できるようにします。

1. 課題：数字だけでは人の姿が見えない

プロダクト分析では、1,000人がチェックアウトに進み、620人が離脱したというファネルが得られます。問題を正確に測定できても、その実態はまだ見えていません。この620件の録画を数件見れば、通常は数分で疑問が解けます — ただし、ID を書き出して手動で検索せずに、グラフから該当するセッションへ移動できることが前提です。

この プロダクト分析連携ブリッジ がその隔たりを埋めます。次の内部で動作し、 mp.js 二つのシステムを自動的に結び付けます。

  • 送信方向： 分析ツールが記録する各イベントに、 mouseplayer_session_url プロパティが付きます。イベントを開き、リンクをクリックすると、そのセッションを視聴できます。
  • 受信方向： 訪問者の distinct_id を読み戻して MousePlayer のセッションに保存します。そのため、PostHog、Mixpanel、Amplitude で既に使用している識別子で録画を検索できるようになります。

コードは不要です。 連携ブリッジが分析 SDK を自動検出します。MousePlayer の関数を呼び出す必要も、イベントのトラッキング方法を変える必要もありません。

2. 有効化

方法 A：ダッシュボード（コード不要）

  1. プロジェクトを開き、 連携 タブに移動します。
  2. 次の設定を切り替えます： PostHog、Mixpanel & Amplitude の連携ブリッジ → ON。
  3. 利用するプラットフォームを選択します。変更は自動的に保存されます。

設定は、サイトのページが次に読み込まれたときに適用されます。既存のセッションにさかのぼって適用されることはありません。

方法 B：手動でスクリプトを設定

コードに直接設定する場合は、次の中に二つの値を設定します： window.mp_config。

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. プラットフォームごとの動作

プラットフォームごとに API が異なるため、連携ブリッジはそれぞれで一般的な呼び出しに対応付けます。これを設定する必要はありません — 選択したプロバイダーに従って動作します。

プラットフォーム送信方向（再生 URL）受信方向（識別子）
PostHog posthog.register() — スーパープロパティとして登録され、それ以降のすべてのイベントに付加されます posthog.get_distinct_id()
Mixpanel mixpanel.register() — 同じスーパープロパティの動作です mixpanel.get_distinct_id()
Amplitude setUserProperties() — ユーザープロパティとして設定されます getDeviceId()、従来の SDK では代わりに getInstance().options.deviceId を使います

スーパープロパティとユーザープロパティ： PostHog と Mixpanel では、それ以降のイベントに再生 URL が付加されます。連携ブリッジの初期化後に発生したすべてのイベントに含まれます — ページ読み込みの初期段階で既に送信されたイベントには含まれません。

4. 識別子：distinct_id から識別可能なセッションへ

多くのチームが過小評価するのは、受信方向の機能です。これがないと MousePlayer のセッションは匿名のままです。視聴はできても、次の要求には応えられません： 「先週解約したアカウントの録画を見せてください」。

連携ブリッジを有効にすると、分析ツールの distinct_id がセッションの custom_user_id フィールドに書き込まれます — SDK を手動で呼び出したときと同じフィールドです。

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

既にご自身で mp('set') を呼び出している場合は、そのまま続けてください。明示的に渡す識別子は、ブラウザーごとの分析用識別子ではなく、ご自身の主キーであるため、より確実です。

プライバシーに関する注意： 転送されるのは、分析ツールが既に割り当てた識別子だけです。メールアドレス、氏名、その他の個人情報のフィールドを SDK から読み取ることはありません。ご自身のプライバシーポリシーでこの処理を説明し、法的根拠として同意に依拠する場合は、同意管理ツールによってトラッキングスクリプトの実行を制御してください。

5. 技術的な動作

分析 SDK は通常非同期で読み込まれ、多くの場合、次が既に動作し始めた後になります： mp.js 。そのため、起動時に1回だけ試す方式では、実際のサイトの大半で失敗します。

  • 連携ブリッジの再試行は 1.5秒ごと、最大10回です。両方向の処理が完了すると直ちに停止します。
  • 各方向の処理は独立して完了するため、識別子の出現を待っている間に再生 URL が重複して送信されることはありません。
  • SDK が現れない場合、連携ブリッジは約15秒後に何も通知せずに試行を終了します。コンソールには何も出力せず、セッション録画は影響を受けずに継続します。
  • 128文字を超える識別子は、切り詰めずに無視します。一致することのない、不完全な識別子の保存を避けるためです。

6. 動作の確認

  1. 通常のブラウザータブでサイトを開き、短時間操作します。
  2. 分析ツールで最新のイベントを開き、 mouseplayer_session_url プロパティを探します。そのリンクを開くと、録画に直接移動できるはずです。
  3. MousePlayer で次を開きます： ユーザーエクスプローラー。識別子を持つセッションでは、自動生成された訪問者のニックネームの代わりに識別子が表示されます。

何も表示されない場合

  • どのイベントにもプロパティがない： ページで分析 SDK が実際に読み込まれているか、対応するプラットフォームを選択したかを確認してください。PostHog を選択しても Mixpanel は読み取れません。
  • 後から発生したイベントにだけプロパティがある： 想定どおりの動作です。第3節の注意事項をご覧ください。
  • URL はあるが識別子がない： SDK がまだ distinct_id を割り当てていません。ユーザーを識別する前は正常な状態です。後のページ読み込み時に取得されます。
  • ログイン済みの管理者としてテストしている： 設定によっては内部トラフィックが除外されます。プライベートウィンドウをお試しください。

記載されている商標はすべて各所有者に帰属します。MousePlayer とこれらのプロバイダーとの間に取引関係はありません。