> 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/event/search-event.md).

# イベントを検索する

イベントとユーザーの条件による行動の絞り込み、検索期間の指定、条件の保存と呼び出し方法を説明します。

## イベント検索でできること <a href="#what-you-can-do" id="what-you-can-do"></a>

特定のページを閲覧した、特定のボタンをクリックしたなどの行動と、その行動をしたユーザーを検索できます。URLやクリックしたテキストに加え、イベントディメンション（行動時のデバイスや流入元などの情報）でも絞り込めます。

## 検索の方法 <a href="#search-method" id="search-method"></a>

`イベント`画面を開き、調べたい行動と期間を指定します。検索パネルで条件を組み合わせる場合は、`詳細条件を選択`をオンにします。

詳細条件の検索ボックスは、上段が`イベント条件`、下段が`ユーザー条件`です。たとえば「共有ボタンを押した有料プランのユーザー」を調べる場合、上段に共有ボタンのクリック、下段にプランの条件を指定します。

<figure><img src="https://1516189518-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhDtk9aBzYOvC8RRWtKCd%2Fuploads%2FJ03omnlAcc9J3uAyqHle%2F%E3%82%B9%E3%82%AF%E3%83%AA%E3%83%BC%E3%83%B3%E3%82%B7%E3%83%A7%E3%83%83%E3%83%88%202024-07-31%2021.50.43.png?alt=media&amp;token=100eb206-7722-453c-a764-0e3cb575abe9" alt=""><figcaption></figcaption></figure>

### 検索パネルを利用した検索 <a href="#search-panel" id="search-panel"></a>

1. `イベント条件`を選択し、項目、比較方法、値の順に指定します。
2. ユーザーの属性や利用状況でも絞り込みたい場合は、`ユーザー条件`を指定します。
3. チャート上部で期間を選び、検索結果を確認します。

複数の条件を追加すると、すべての条件に一致する対象に絞り込めます（AND条件）。同じ項目内に複数の値を指定すると、いずれかに一致する条件を作れます（OR条件）。

### 文字列の直接入力を利用した検索 <a href="#direct-text-input" id="direct-text-input"></a>

詳細条件のイベント検索ボックスに文字列を入力すると、イベントの種類、項目、値に一致する候補を検索できます。たとえば`click`を入力すると、クリックに関連する候補が表示されます。候補を選んで検索条件に追加します。

### 条件のコピーと貼り付け <a href="#copy-paste-conditions" id="copy-paste-conditions"></a>

詳細条件の検索ボックス右上のメニュー（`…`）から、条件をコピー・貼り付けできます。

| 操作           | 動作                       |
| ------------ | ------------------------ |
| 条件をコピー       | 入力中の条件をコピーします。           |
| 条件を貼り付け（追加）  | 入力中の条件を残し、コピーした条件を追加します。 |
| 条件を貼り付け（上書き） | 入力中の条件を、コピーした条件に置き換えます。  |
| 条件をリセット      | 検索ボックスの条件を空にします。         |

## 検索に使える条件 <a href="#available-conditions" id="available-conditions"></a>

### イベント条件 <a href="#event-conditions" id="event-conditions"></a>

自動イベント、イベントディメンション、コードレスイベント、カスタムイベント、保存したイベント条件を指定できます。`期間内イベント数`を指定すると、選択した期間に条件に一致するイベントが何回発生したかで、ユーザーを絞り込めます。

### ユーザー条件 <a href="#user-conditions" id="user-conditions"></a>

ライフサイクル、キー行動、ユーザープロファイル、ユーザーディメンション、ユーザーディメンション（コードレスイベント、カスタムイベント）などを指定できます。

イベント条件は「何をしたか」、ユーザー条件は「どのようなユーザーか」を指定するために使います。

### 期間 <a href="#period" id="period"></a>

直近7日、直近4週間、今日、昨日、今週、今月、先週、先月から選べます。日付で指定する場合は`カスタム`を選びます。直近4週間は28日間で、暦上の1ヶ月とは異なります。

## 条件の例 <a href="#condition-examples" id="condition-examples"></a>

### 特定のページをみた <a href="#specific-page-view" id="specific-page-view"></a>

| 条件     | 設定例                                                   |
| ------ | ----------------------------------------------------- |
| イベント条件 | `ページビューのURL` → `次を含む` → `https://example.com/product` |
| ユーザー条件 | 条件なし                                                  |

入力するURLは、調べたいページのURLに置き換えます。

### 特定のボタンをクリックした <a href="#specific-button-click" id="specific-button-click"></a>

| 条件     | 設定例                         |
| ------ | --------------------------- |
| イベント条件 | `クリックのテキスト` → `次を含む` → `共有` |
| ユーザー条件 | 条件なし                        |

回数や活動時間も指定する例は[イベント検索で様々な行動を探す](https://docs.wicle.io/analytics/event/howto-search-event.md)をご覧ください。

## 条件の保存 <a href="#save-conditions" id="save-conditions"></a>

`期間内イベント数`は保存する条件に含められません。イベントの種類やURLなどの条件を保存し、回数の条件は検索するたびに追加してください。

1. 検索条件を指定し、画面右上の`新しい条件として保存`を選択します。
2. 名前・説明を入力し、`保存`を選択します。
3. 左側の`保存した条件`から、保存した項目を選択して呼び出します。

保存するのは条件で、検索結果の一覧やチャートで選択した日付を固定するものではありません。期間は検索時に選びます。保存済みの条件を変更した場合は`条件を更新して保存`を選択します。別の条件として残す場合は、保存ボタン横のメニューから`新しい条件として保存`を選びます。

保存したイベント条件は、キー行動の条件には使えません。キー行動に使う場合は、[コードレスイベント](https://docs.wicle.io/data-extension/codeless-event.md)または[カスタムイベント](https://docs.wicle.io/data-extension/custom-event.md)を利用してください。

## プリセット条件 <a href="#preset-conditions" id="preset-conditions"></a>

左側のプリセットを選ぶと、検索条件が反映されます。各プリセットの対象は[イベントのプリセット条件](https://docs.wicle.io/analytics/event/preset-condition.md)をご覧ください。
