> For the complete documentation index, see [llms.txt](https://docs.wicle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wicle.io/other/faq/how-to-use/replay-heatmap.md).

# セッションリプレイ・ヒートマップの使い方

セッションリプレイの有効化、マスキングと機微情報対策、取得するページの指定、ヒートマップの表示方法や集計モードなど、セッションリプレイ・ヒートマップの使い方に関するよくある質問です。

## セッションリプレイのマスキングは、デフォルトでどうなっていますか？ <a href="#default-masking" id="default-masking"></a>

デフォルトで、フォームの入力欄（`input`・`textarea`・`select`要素など）が自動的にマスキングされ、全テキストマスキングもオンになっています。

ただし、独自実装の入力欄や、入力後にページ本文へ表示される氏名などは、標準のフォームマスキングだけでは隠れない場合があります。取得を始める前に、個人情報を含まないテストデータで表示を確認してください。

詳しくは [セッションリプレイの設定](/analytics/session-replay/setting.md) をご覧ください。

## 特定のページだけセッションリプレイを取得する（または除外する）ことはできますか？ <a href="#page-filter" id="page-filter"></a>

はい。URL条件（パス・URL・クエリなど）で取得対象を指定し、否定の比較条件で特定のページを除外できます。設定変更は、反映後に取得するデータに適用されます。保存済みの録画は変更・削除されません。

詳しくは [セッションリプレイの設定](/analytics/session-replay/setting.md) をご覧ください。

## 「データなし」「時間が短すぎます」「保存エラー」と表示されるのはなぜですか？ <a href="#status" id="status"></a>

`時間が短すぎます` は、アクティブ時間が10秒未満の状態です。`データなし` は再生できる記録が見つからない状態、`保存エラー` は記録の保存時にエラーが発生した状態です。

`データなし` の場合は、取得の有効化、対象URL、利用上限、通信状況などを確認してください。録画情報の取得に失敗して再試行ボタンが表示されている場合は、まず再試行します。

詳しくは [セッションリプレイの概要](/analytics/session-replay/overview.md) をご覧ください。

## ヒートマップの集計モード「回数」と「UU数」は何が違いますか？ <a href="#count-mode" id="count-mode"></a>

`回数` はページビュー（PV）単位、`UU数` はユーザー単位で集計します。たとえばクリック数は、`回数` ではクリックがあったPV数、`UU数` ではクリックしたユーザー数です。同じPV内で何度クリックしても、`回数` では1件として数えます。要素別のクリック数も、同じPVまたは同じユーザーによる同じ要素への繰り返しクリックは1件です。

CTRは、それぞれの集計単位でクリックがあった割合です。

詳しくは [ヒートマップ/パフォーマンスの使い方](/analytics/heatmap/usage.md) をご覧ください。

## セッションリプレイを使い始めるには何が必要ですか？ <a href="#enable-replay" id="enable-replay"></a>

計測タグの設置と、セッションリプレイの有効化が必要です。設定の変更にはオーナー権限が必要です。

プロジェクト設定の`セッションリプレイ`で`有効にする`をオンにし、マスキングと取得対象URLを確認して`保存`します。設定が計測に反映されるまで数分程度かかる場合があり、反映後に記録されたセッションから閲覧できます。無効だった期間の録画を後から取得することはできません。

詳しくは [セッションリプレイの設定](/analytics/session-replay/setting.md) をご覧ください。

## フォーム以外の機微情報（クレジットカード番号など）が録画に映らないようにするには？ <a href="#mask-sensitive" id="mask-sensitive"></a>

ページ本文や独自実装の入力欄に個人情報が表示される場合は、マスキング対象セレクター、全テキストマスキング、取得対象URLの条件を設定します。取得を始める前に、個人情報を含まないテストデータで表示を確認してください。

マスキング設定を変更しても、保存済みの録画には反映されません。意図しない情報が保存された場合は、[サポート窓口](/other/support/contact.md)へ削除をご依頼ください。

詳しくは [セッションリプレイの設定](/analytics/session-replay/setting.md) をご覧ください。

## ヒートマップはどうやって表示しますか？ポップアップがブロックされる場合は？ <a href="#show-heatmap" id="show-heatmap"></a>

選択中のプロジェクトの計測タグが設置されたページを対象にします。URLを入力し `ヒートマップを表示` をクリックすると、対象ページがポップアップで開き、接続後に分析が始まります。自動で始まらない場合は、ポップアップ側の `分析開始` をクリックします。

ポップアップがブロックされる場合は、ブラウザ設定でWicle（app.wicle.io）のポップアップを許可してください。ポップアップを開かずに数値だけ確認したい場合は `統計のみ取得` を使います。

詳しくは [ヒートマップ/パフォーマンスの使い方](/analytics/heatmap/usage.md) をご覧ください。

## ヒートマップでスクロール到達率や注視領域が表示されないのはなぜですか？ <a href="#heatmap-no-data" id="heatmap-no-data"></a>

スクロール到達率の可視化にはスクロールイベント、注視領域の可視化には注視領域イベントの計測が必要です。これらの計測がオフの場合は画面上部に警告バナーが表示されるので、計測タグ設定から有効化してください。

詳しくは [ヒートマップ/パフォーマンスの使い方](/analytics/heatmap/usage.md) をご覧ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.wicle.io/other/faq/how-to-use/replay-heatmap.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
