# イベントを検索する

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

イベント検索では特定のページをじっくり見た、特定のボタンをクリックしたというイベントが発生したユーザーを検索することができます。また、イベント毎に自動で計算している来訪回数、リファラー、デバイスの`イベントディメンション`でも検索することができます。

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

イベントの検索ボックスは2段に分かれています。\
上段では検索したいイベントの情報を入力し、下段ではそのイベントを絞り込みたいユーザーの条件を入力します。<br>

<figure><img src="/files/ld7ulrkkGxfekUY9MeB9" alt=""><figcaption></figcaption></figure>

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

上段（イベント条件）、下段（ユーザー条件）ともに検索ボックスにカーソルをあてると検索パネルが表示されます。左から右に条件を選択していき最後に値を入力するとその条件にあったユーザーが絞り込まれます。AND条件とOR条件（同じ項目内のみ）も設定可能です。<br>

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

検索ボックスに直接文字列を入力すると、Event(イベントの種類)、Keys(要素）、Values（値）のすべてから検索を行うことができます。例えば`click`と入力するとclickに含まれるイベント、要素、Valuesに合致する内容がサジェストとして表示されます。

### 条件のコピーと貼り付け <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週間、今日、昨日、今週、今月、先週、先月、カレンダーで指定から選択ができます。

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

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

イベント条件：`ページビューのURL` | `次を含む` | [`https://xxxxx/`](https://wicle.io/)\
ユーザー条件：条件なし

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

イベント条件：`クリックのテキスト` | `次を含む` | `ボタン名`\
ユーザー条件：条件なし

その他の条件については[様々な行動の探し方](/analytics/event/howto-search-event.md)をご覧ください。

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

条件を入力後、右側の`新しい条件として保存`を選択すると設定した条件を保存することができ、保存した条件はイベント左カラムから確認できます。

左カラムから保存した条件を選択することで、検索ボックスに同じ条件を入力することができます。

なお、保存済みイベントはキー行動の条件としては利用できません。キー行動の条件として利用したい場合はコードレスイベント、もしくはカスタムイベントを利用してください。<br>

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

左カラムによく使われる条件をプリセットとして用意しています。プリセットの中の項目を選択すると自動的に検索条件が反映されます。\
プリセット条件の詳細については[イベントのプリセット条件](/analytics/event/preset-condition.md)をご覧ください。<br>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.wicle.io/analytics/event/search-event.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
