> 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/ai/summarize-event-data.md).

# ユーザー行動データの要約

ユーザー詳細で、ユーザー全体の行動傾向と日ごとの操作をAIで要約し、確認・再生成する方法を説明します。

## ユーザー要約と日別要約の使い分け <a href="#n1-analysis-support" id="n1-analysis-support"></a>

[ユーザー詳細画面](https://docs.wicle.io/analytics/n1-user/overview.md)で、行動の傾向や日ごとの操作をAIの要約で確認できます。要約で気になる行動が見つかったら、イベントタイムラインやセッションリプレイで元のデータを確認します。

| 要約     | 確認できること                           |
| ------ | --------------------------------- |
| ユーザー要約 | ユーザーの統計情報と直近30日間の行動をもとにした、利用傾向や変化 |
| 日別要約   | その日に何をしたか、どのような順序で操作したか           |

利用には[Wicle AIの有効化](https://docs.wicle.io/ai/policy.md#enable-ai)が必要です。要約の新規生成は[利用上限](#usage-limit)の対象になり、生成した要約はプロジェクト内で共有されます。

## ユーザー要約 <a href="#user-summary" id="user-summary"></a>

分析したいユーザーの詳細画面を開くと、画面上部の`AI ユーザー分析`に要約が表示されます。要約がない場合は自動で生成され、生成済みの場合はその結果が表示されます。

### 表示される内容 <a href="#user-summary-content" id="user-summary-content"></a>

| 項目     | 説明                          |
| ------ | --------------------------- |
| 一言サマリー | ユーザーの利用傾向と、特に注目する特徴         |
| 行動パターン | 複数のセッションにわたって繰り返される行動（最大5件） |
| 直近の変化  | 前回訪問と比べて見つかった変化（最大3件）       |
| 注目シグナル | 分析者が注目する事象（最大3件）            |

最初は一言サマリーと主要な項目が表示されます。`詳細`を選択すると、すべての分析結果を確認できます。

### 再生成 <a href="#user-summary-regenerate" id="user-summary-regenerate"></a>

生成済みのユーザー要約は7日間キャッシュされ、再利用されます。最新の行動を反映したい場合は、`再生成`を選択します。

前回の生成後に新しいセッションが発生すると、`新しいデータあり`と表示されます。新しいデータがなくても再生成できます。

## 日別要約 <a href="#session-summary" id="session-summary"></a>

ユーザー詳細では、行動した日ごとに、その日の操作を時系列で要約できます。直近の日は、要約がなければ自動で生成されます。別の日を確認する場合は、日付横の`要約`を選択します。

### 表示される内容 <a href="#session-summary-content" id="session-summary-content"></a>

| 項目       | 説明              |
| -------- | --------------- |
| 要約       | その日の行動の概要       |
| アクションフロー | 時間帯ごとの行動を時系列で表示 |

`詳細`を選択すると行動の流れを確認できます。生成後にデータが増えた場合などは、日別要約の`再生成`で更新します。

## 解析対象のイベントデータ <a href="#target-event-data" id="target-event-data"></a>

要約に使うイベントは、プロジェクト設定の`AI`で調整します。設定の変更には組織のOwner権限が必要です。

標準では、ページビュー・クリック、カスタムイベント・コードレスイベント、キー行動に紐づくイベントを解析します。

1. プロジェクト設定の`AI`を開きます。
2. `ユーザー行動データの要約`で、解析対象に追加する自動イベント種別を選択します。スクロール率（`scroll_depth`）・フォーム送信（`submit`）・エラー（`error`）を追加できます。
3. 必要に応じて、解析対象から除外するカスタムイベント・コードレスイベントを選択します。
4. この設定項目の`保存`を選択します。

ページビューとクリックは常に解析対象に含まれます。また、除外したカスタムイベント・コードレスイベントでも、キー行動に紐づく場合は解析対象に含まれます。入力してはいけない情報は、[AI機能の提供ポリシー](https://docs.wicle.io/ai/policy.md#prohibited-actions)も確認してください。

## 利用上限 <a href="#usage-limit" id="usage-limit"></a>

AIユーザー分析には、プロジェクトごとに1日あたりの分析対象ユーザー数の上限があります。同じ日に同じユーザーのユーザー要約・日別要約を複数回生成したり、再生成したりしても、1ユーザーとしてカウントされます。

上限に達すると、その日にまだ分析していないユーザーの要約は翌日まで新たに生成できません。生成済みのユーザー要約は引き続き確認できます。上限の確認・変更は[プロジェクトのリミット](https://docs.wicle.io/organization-project/project-setting/limitation.md)をご覧ください。

## 要約結果 <a href="#summary-results" id="summary-results"></a>

ユーザー要約と日別要約は、プロジェクト内のメンバーで共有されます。同じユーザーを確認する際に、生成済みの結果を利用できます。
