Live View

Live Viewはすべてのドメインダッシュボード内のリアルタイムタブです。国、都市、ページ、セッション長、トラフィックソース、デバイスなど、現在サイト上にいるユーザーを表示し、タブが表示されている間、3秒ごとに更新されます。

Proおよびそれ以上のプランでは、Ghost Multiplayerを有効にすることができます。これはビジターのマウスムーブメントをビジターが見ているページのスクリーンショット上にストリーム配信するカーソルオーバーレイで、サイドパネルにセッションの詳細が表示されます。このオーバーレイは設計上、一時的なものです。DOMコンテンツがキャプチャされることはなく、長期保存されることもなく、ペイロードにIPアドレスも含まれていません。

---

クイックスタート

1. app.zenovay.comでサインインします。
2. Domainsを開き、監視するドメインを選択します。
3. Live viewタブを開きます。
4. ビジターが到着すると、アクティブなセッションのリストが表示され、3秒ごとに更新されます。
5. （Pro+）任意のカードのWatch cursorをクリックして、そのビジターのGhost Multiplayer オーバーレイを開きます。

---

ビジターカード詳細

各アクティブなビジターは以下を含む単一のカードを表示します：

セッションは、最後のイベントが過去5分以内に到着した場合、「アクティブ」です。5分間のアクティビティがない場合、カードは自動的にリストから削除されます。

---

フィルター

タブの上部にあるフィルタバーはリストをクライアント側で絞り込みます。ポーリング対象は変更せず、表示される内容のみが変わります。利用可能なフィルタ：

• 国 — 現在表示されている国の単一選択ドロップダウン。
• ページ — 完全なパスマッチ。
• ソース — Direct / Organic / Paid / Social / Referral。
• デバイス — Desktop / Mobile / Tablet。

フィルタをクリアするとリスト全体が復元されます。V1のライブタブに保存セグメント統合はありません。3秒の更新を低コストに保つため、フィルタは意図的に軽量です。

---

自動更新と可視性対応の一時停止

• 更新間隔： タブが焦点を当てている間、3秒。
• バックグラウンド一時停止： ブラウザタブが隠れている場合（別のタブに切り替えるか、ウィンドウを最小化した場合）、無駄なリクエストとCPUを避けるため、ポーリングが停止します。
• 可視性時に再開： タブをフォアグラウンドに戻してから3秒以内にポーリングが再開されます。

一時停止は標準的なvisibilitychangeイベントによって駆動されます。カスタムハートビートやマニュアルボタンは必要ありません。

短時間のネットワーク中断がポーリングを低下させた場合、ビジターリストはエラーを表示する代わりに、次の間隔で自動的に再接続されます。

---

Ghost Multiplayer (Pro+)

Ghost Multiplayer はオプションのカーソルオーバーレイです。デフォルトではオフで、Pro+管理者がそれを開くと、ビジターごとにアクティブになります。

アクティベーション方法

1. 任意のビジターカードで、Watch cursorをクリックします。
2. フルスクリーンオーバーレイが開き、以下が表示されます：
   • 背景： ビジターが現在見ているページのスクリーンショット。
   • カーソル： リアルタイムのマウス位置を反映するアニメーションポインタ。
   • サイドパネル： 匿名ビジターID、セッション時間、このセッション中に訪問したページ、デバイス、ブラウザ、国。
3. Escキーを押すか、オーバーレイの外をクリックして閉じます。

カーソルはV1（HTTPポーリング）では1～2秒のラグで更新されます。V2ではWebSocketに移動して、ほぼ即座の更新が可能になります。下記のV2バックログを参照してください。

動作メカニズム

オーバーレイがアクティブな間、ビジターのトラッカーは：

1. ページ上のmousemoveイベントをリッスンします（パッシブリスナー、preventDefaultなし）。
2. 最大毎秒10サンプルにスロットルします。
3. 1秒のウィンドウでサンプルをバッチ化し、POST /api/analytics/live-cursor/ingestにPOSTします。
4. ペイロードはビューポートのパーセンテージとしての座標、セッションID、およびタイムスタンプのみが含まれます。IPもDOMコンテンツもフォームフィールド値もありません。

サーバー側では：

1. ワーカーは10秒のTTLを持つCloudflare KVにバッチを保存します。
2. オーバーレイはGET /api/analytics/live-cursor/:websiteId/:sessionIdを毎秒ポーリングします。
3. 古いサンプルは自動的に期限切れになります。データベースには何も書き込まれません。

ライブページプレビュー制限

カーソルの背後にあるページプレビュー背景画像はオンデマンドのサーバー側スクリーンショットであり、ウェブサイトあたり1日あたりの上限があります。カウンターは00:00 UTCでリセットされます：

同じ日にすでにキャプチャされたページを再表示してもバジェットは消費されません。そのキャプチャはキャッシュから提供されます。

日次制限に達すると、オーバーレイには明確なメッセージが表示されます：「1日のライブプレビュー上限に達しました — 00:00 UTCに再開されます」。ライブカーソルとビジターリストは正常に機能し続けます。ページスクリーンショット背景のみが次のリセットまで一時停止します。

サイドパネル詳細

サイドパネルは、ダッシュボード内に既に存在するセッションレベルのコンテキストを表示します。これは新しいデータソースを導入しません：

• 匿名ビジターID（製品の他の場所で使用されている同じ不透明識別子）
• セッション時間
• このセッション中に訪問したページ
• デバイス、ブラウザ、国

V1は会社名または収益履歴を表示しません（V2バックログを参照）。

---

プライバシーとコンプライアンス

Ghost Multiplayer は、新しい長期追跡サーフェスエリアをゼロに加えるように設計されました。V1で出荷された場合、以下の保証が保持されます：

• 両方の端でGPCを尊重。 ビジターのブラウザがnavigator.globalPrivacyControl === trueを設定する場合、トラッカーはカーソルデータをストリーム配信せず、サーバー側インジェストエンドポイントは204応答で迷走ペイロードをドロップします。
• 一時的なKVのみ。 カーソルバッチは10秒のTTL を持つCloudflare KVに存在します。分析データベースに書き込まれることはありません。
• 長期的なクッキーなし、localStorageなし。 オーバーレイをアクティブにしても、既存のトラッカーセッションIDを超えて、ビジターのデバイスに新しいストレージは導入されません。
• 座標のみ。 ペイロードにはビューポートのパーセンテージとしてのx/yが、セッションIDおよびタイムスタンプとともに含まれます。IPアドレス、DOMコンテンツ、フォーム値、クリップボードコンテンツ、キーストロークはありません。
• 一方向の可視性。 ビジターは管理者のカーソルを見ることもなく、通知も受け取りません。これはすべての他の分析ダッシュボードがどのように機能するかを反映していますが、公開向けのプライバシー通知を公開する場合は、管理者がライブカーソルアクティビティを監視する可能性があることを開示する必要があります。
• 匿名ページプレビュー。 プレビュー背景は、公開ページのみの匿名サーバー側スクリーンショットです。これはGlobal Privacy Control / do-not-trackビジターとしてレンダリングされます。クッキーが設定されず、クッキー同意バナーが抑制され、マーケティングまたは分析ピクセルが発火されていません。フォームフィールドはスクリーンショット内で編集され、ビジターDOMまたはPIIはキャプチャされていません。

プラン レベルの保持期間は、基礎となるセッション/ページビュー行に対して、サブスクリプション階層によって管理され続けます。カーソルストリーム自体は、何も永続化されていないため、その保持に追加されません。

---

パフォーマンスと制限

ベースLive Viewタブ自体は、3秒ごとにGET /api/analytics/realtime/:websiteIdに1つの小さなリクエストを追加します。他のリアルタイムダッシュボードタイルと同等のコストです。

---

V2バックログ

次の項目は、V1では意図的に含まれていません。追跡されていますが、まだ出荷されていません：

• 顧客のサイトのライブiframeをスクリーンショットの代わりにオーバーレイ背景として。
• WebSocketトランスポート 準秒以下のカーソル更新（現在HTTPポーリング）。
• IP対企業の濃縮 B2Bビジターのカーソルの上に企業ロゴを表示します。
• Stripe /請求履歴 支払顧客のためのサイドパネル。
• カーソルトレイル/パンくずリスト ページ上の最近のパスを表示しています。
• マルチ管理者プレゼンス — 複数の管理者が同じビジターを見ているときに、お互いのカーソルを見ることができます。
• 記録モード — 後で再生するためのセッションをキャプチャします（これは既存のSession Replay製品とマージされます、複製されません）。

これらのいずれかが早期に必要な場合、優先度は顧客の需要によって設定されます。[email protected]までお問い合わせください。

---

よくある質問

ビジターは私がカーソルを見ていることを知っていますか？

ビジターに通知は表示されません。オーバーレイは、他の分析ダッシュボードと同様の一方向ビューです。あなたの管轄区域が行動観測の開示を要求する場合、プライバシー通知にライブ監視を記載してください。

カーソルが1～2秒遅れているのはなぜですか？

V1はHTTPポーリングを1秒ごとのケイデンスで使用します。カーソルはビジターの実際の位置に～1～2秒の遅延で追いつきます。WebSocketトランスポートへの移動はV2バックログにあります。

メインダッシュボードでトラフィックが表示されていても、ビジターリストが空です。

いくつかの一般的な原因があります：

1. 現在アクティブなビジターがありません。 リストは、過去5分以内に最後のイベントが到着したセッションのみを表示します。静かな期間は正常です。
2. タブが非表示です。 タブがバックグラウンドにあるとき、ポーリングが一時停止されます。フォアグラウンドに戻して、最大3秒待ちます。
3. 表示されているページにトラッカーがインストールされていません。 Install Health診断で確認します。
4. 広告ブロッカー。 一部の広告ブロッカーはトラッカーリクエストを削除します。これはLive Viewだけでなく、すべての分析製品に影響します。

オーバーレイでビジターの実際のページを見ることはできますか。スクリーンショットではなく？

V1ではできません。V2バックログを参照してください。顧客のライブページをiframeに埋め込むには、顧客が独自のドメイン上でフレーミングを許可する必要があります。ほとんどはデフォルトではそうしません。V1のスクリーンショットアプローチは、すべてのサイトですぐに機能します。

Ghost Multiplayer は私のセッションリプレイクォータに対してカウントされますか？

いいえ。Ghost Multiplayer はリアルタイムのみで、何も保存されません。セッションリプレイ配分を消費しません。

Ghost Multiplayer オーバーレイリンクをチームメートと共有できますか？

V1ではできません。オーバーレイセッションは、認証されたZenovayセッションにバインドされます。将来の「ライブビューを共有」機能はバックログにあります。

---

関連

• Real-time Tracking — 基礎となるリアルタイムダッシュボード
• Session Replay — 事後分析用の記録されたセッション
• Heatmaps — クリック/スクロールデータの集計
• Privacy Compliance — トラッカーが送信するデータとその理由