> 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/analytics/session-replay/setting.md).

# セッションリプレイの設定

セッションリプレイの取得を有効化する手順、テキストとページタイトルのマスキング、取得対象ページの指定方法を説明します。

取得の有効化、保存するテキストのマスキング、対象ページを設定します。対象サイトには[計測タグ](https://docs.wicle.io/initial-setting/tag.md)の設置が必要です。

設定の変更にはオーナー権限が必要です。Customプランで設定を変更できない場合は、担当者へお問い合わせください。

## 設定画面へのアクセス <a href="#access" id="access"></a>

1. 左メニュー上部のプロジェクト名をクリックします。
2. プロジェクト名の右にある歯車マークから設定画面を開きます。
3. `セッションリプレイ` を選択します。

## 有効化/無効化 <a href="#enable-disable" id="enable-disable"></a>

1. `セッションリプレイ` の `有効にする` をオンまたはオフにします。
2. 有効にする場合は、後述のマスキングと取得対象URLを確認します。
3. `保存` をクリックします。

変更が実際の計測に反映されるまで、数分程度かかる場合があります。オフにすると、新たなセッションリプレイデータの取得が停止します。マスキングやURL条件の変更も、反映後に取得するデータに適用されます。

{% hint style="info" %}
セッションリプレイを無効化しても、新たな録画が停止するだけで、保存済みのデータは引き続き閲覧できます。
{% endhint %}

{% hint style="danger" %}
無効にしていた期間のデータを、後からさかのぼって取得することはできません。
{% endhint %}

## プライバシー保護設定 <a href="#privacy" id="privacy"></a>

### デフォルトマスキング <a href="#default-masking" id="default-masking"></a>

フォームの入力情報は、デフォルトでマスキングされます。対象は次のCSSセレクタに一致する要素です。CSSセレクタは、ページ内の要素を指定するための記述です。

```
input:not([type="submit"]):not([type="button"])
textarea
select
```

{% hint style="info" %}
`input:not([type='submit']):not([type='button'])` は input要素でもsubmitやbutton typeのものは除いていることを示しています。
{% endhint %}

{% hint style="warning" %}
独自実装の入力欄や、入力後に別の場所へ表示される氏名・住所などは、標準のフォームマスキングだけでは隠れない場合があります。

取得を始める前に、個人情報を含まないテストデータで表示を確認してください。必要に応じて、マスキング対象セレクター、全テキストマスキング、取得対象URLの条件を設定します。
{% endhint %}

### 全テキストマスキング <a href="#full-text-masking" id="full-text-masking"></a>

`全テキストのマスキング` を有効にすると、ページ内のテキストをマスキングして保存します。氏名や住所などがページ本文に表示される場合にも利用します。

画像の代替テキスト（`alt`）、入力欄の案内文（`placeholder`）、ツールチップ（`title`）、読み上げ用のテキスト属性（`aria-label`・`aria-description`・`aria-placeholder`・`aria-valuetext`）、送信・ボタン型の入力要素のラベルも対象です。URLや任意の属性すべてをマスキングする設定ではありません。

ページタイトルは、別の[ページタイトルのマスキング](#title-masking)で設定します。

{% hint style="info" %}
全テキストマスキングはデフォルトでオンになっています。
{% endhint %}

テキストの変換ルールは以下の通りです。

| 種類                        | マスキング後の表示         |
| ------------------------- | ----------------- |
| 半角英字などのアルファベット            | 小文字は `x`、大文字は `X` |
| 日本語・中国語・韓国語などの文字（半角カナを含む） | `Ｘ`（全角エックス）       |
| 数字                        | 半角などは `0`、全角は `０` |
| 絵文字や、多くの記号・空白             | 変換せずそのまま表示        |

アクセント付きの文字や、アラビア文字などの各言語の文字・数字も変換対象です。一部の日本語の記号や全角記号は`Ｘ`に変換されます。

#### マスキングのイメージ <a href="#masking-example" id="masking-example"></a>

<figure><img src="https://1516189518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhDtk9aBzYOvC8RRWtKCd%2Fuploads%2F0WzLLclJc4lBqTBxsZAI%2Fimage.png?alt=media&amp;token=17342267-f06a-465e-8ef8-3e6636f42fde" alt=""><figcaption></figcaption></figure>

### ページタイトルのマスキング <a href="#title-masking" id="title-masking"></a>

`ページタイトルのマスキング`を有効にするとページタイトルを送信しません。デフォルトはオフです。

1. `セッションリプレイ`の`有効にする`をオンにします。
2. `ページタイトルのマスキング`の`有効にする`をオンにします。
3. `保存`をクリックします。

この設定は、全テキストマスキングがオフでも適用されます。非マスキング対象セレクターを指定しても、タイトルのマスキングは解除されません。

変更は、更新版タグの次回読み込み以降に適用されます。過去に取得したデータは変更されません。

イベントに送信するページタイトルもマスキングする場合は、[計測タグ設定のページタイトルのマスキング](https://docs.wicle.io/initial-setting/tag.md#title-masking)も有効にしてください。

### 個別にマスキング/非マスキングを設定する <a href="#custom-masking" id="custom-masking"></a>

Webサイト上の特定要素について、マスキングの設定・解除を行うことができます。

#### マスキング対象セレクター <a href="#mask-selectors" id="mask-selectors"></a>

マスキングしたい要素のCSSセレクタを入力します。複数ある場合は1行に1つずつ指定します。

#### 非マスキング対象セレクター <a href="#unmask-selectors" id="unmask-selectors"></a>

全テキストマスキングが有効な場合に、マスキングせずに保存したい要素のCSSセレクタを入力します。複数ある場合は1行に1つずつ指定します。個人情報を含む可能性がある要素は指定しないでください。

{% hint style="warning" %}
同一の要素に対してマスキングと非マスキングの両方の指定がある場合は、安全性を優先してマスキングが適用されます。
{% endhint %}

<details>

<summary>CSSセレクタの指定方法がわからない場合</summary>

1. 対象のページを開きます
2. ページ内から、CSSセレクタを取得したい要素を見つけます
3. 要素の上で右クリックし`検証`を選択すると Chromeデベロッパーツール が開きます
4. Elementsタブの中で、該当の要素に対応するHTMLタグがハイライトされます
5. ハイライトされたHTMLタグを右クリックし、`Copy > Copy selector`を選択すると、クリップボードにその要素を指定するCSSセレクタがコピーされます

</details>

## セッションリプレイを取得するページを指定する <a href="#page-filter" id="page-filter"></a>

### URL 条件 <a href="#url-conditions" id="url-conditions"></a>

`計測対象URLの条件` で、取得するページの範囲を指定します。たとえば、パスの前方一致に `/products/` を指定すると、その配下のページを対象にできます。特定のページを除外する場合は、否定の比較条件を利用します。

条件は以下の項目で設定します。

| 項目      | 説明             | 例                      |
| ------- | -------------- | ---------------------- |
| パス      | URLのパス部分       | `/questions`           |
| URL     | 完全なURL         | `https://example.com/` |
| クエリ     | URLのクエリパラメータ   | `?page=1`              |
| URIアンカー | URLの `#` 以降の部分 | `#section1`            |

比較方法は `次と等しい`・`次を含む`・`前方一致`・`後方一致`・`次を含まない` から選びます。正規表現も利用できます。クエリの完全一致・前方一致では先頭に `?`、URIアンカーでは先頭に `#` を含めて入力します。

複数の条件を組み合わせる場合、AND条件（すべて一致）とOR条件（いずれか一致）を設定できます。条件は合わせて10個まで設定可能です。

### SPA 除外条件 <a href="#spa-exclusion" id="spa-exclusion"></a>

SPAサイトにおいてセッションリプレイを行いたくないページを除外できます。

{% hint style="warning" %}
SPA除外条件はURL条件で指定されているページの範囲内でのみ有効です。除外ページもURL条件の対象に含まれるよう設定してください。
{% endhint %}

## 意図せず保存されてしまったデータの削除 <a href="#delete-data" id="delete-data"></a>

意図しないデータが保存された場合は、[サポート](https://docs.wicle.io/other/support/contact.md)へ削除をご依頼ください。設定を変更しても、保存済みデータのマスキングや削除は行われません。

## トラブルシューティング <a href="#troubleshoot" id="troubleshoot"></a>

[セッションリプレイが見られない、うまく再生されない場合](https://docs.wicle.io/other/troubleshoot/troubleshooting-sessionreplay.md)
