> 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/data-setting/event-tracking/auto-event.md).

# 自動計測されるイベント

Wicleで標準計測されるイベントと有効化が必要なイベントの種類、取得する情報と計測条件、課金対象の区分を説明します。

## 自動計測されるイベントについて <a href="#about" id="about"></a>

計測タグを設置すると、ページビュー・クリック・活動時間を標準で計測します。スクロール率・注視領域・フォーム送信・エラーは、[計測タグ設定画面](https://docs.wicle.io/initial-setting/tag.md#event-delivery)で有効化すると計測されます。

| 区分              | イベント                                                                                           | 課金対象 |
| --------------- | ---------------------------------------------------------------------------------------------- | ---- |
| 標準で計測           | [ページビュー](#view)、[クリック](#click)                                                                 | 対象   |
| 標準で計測           | [活動時間](#spend_time)                                                                            | 対象外  |
| 設定画面で有効化して計測    | [スクロール率](#scroll-depth)、[注視領域](#viewport-attention)、[フォーム送信](#form-submit)、[エラー](#error-event) | 対象   |
| A/Bテストの施策配信時に計測 | [A/Bテスト施策のイベント](#experiment_events)                                                            | 対象外  |

## デフォルトの自動計測イベント <a href="#default_events" id="default_events"></a>

計測タグを設置すると、標準で計測が始まるイベントです。

### ページビュー（view） <a href="#view" id="view"></a>

ページが表示され、タグが読み込まれると、`view`イベントを送信します。

主に次の情報を取得します。

* ページのURL
* ページタイトル（[ページタイトルのマスキング](https://docs.wicle.io/initial-setting/tag.md#title-masking)が有効な場合は送信しません）
* リファラ
* デバイス、OS情報
* ユーザーエージェント

{% hint style="info" %}
SPAサイトでも、タグが仮想ページ遷移を自動検知してviewイベントを送信します。別途の設定は不要です。
{% endhint %}

### クリック（click） <a href="#click" id="click"></a>

次の要素をクリックすると、`click`イベントを送信します。子要素をクリックした場合も、親要素が対象に含まれていれば、その要素のクリックとして計測します。

* A要素
* BUTTON要素
* INPUT要素の内、type属性が以下のもの
  * button
  * checkbox
  * image
  * radio
  * range
  * reset
  * submit

#### 計測サポート外のケース <a href="#unsupported" id="unsupported"></a>

* [ShadowDom](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM)内の要素
* [iframe](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe)内の要素

{% hint style="info" %}
**クリックイベントの拡張**

対象要素に特定の属性を付与することで、任意のデータをクリックイベントに付与できます。詳しくは以下をご覧ください。

[クリックイベントの拡張](https://docs.wicle.io/data-setting/event-tracking/click-event-extension.md)
{% endhint %}

## 非課金イベント <a href="#not_billed_event" id="not_billed_event"></a>

次のイベントは、**計測イベント数の実績としてカウントされない**非課金イベントです。

### 活動時間（spend\_time\_in\_pv / spend\_time\_in\_session） <a href="#spend_time" id="spend_time"></a>

Wicleでは、ページを開いていた経過時間ではなく、ユーザーの操作をもとに算出する「**活動時間**」を扱います。操作として検知するのは、**マウス移動・スクリーンタッチ・スクロール・クリック・入力**です。

`spend_time_in_pv`は1ページビュー内、`spend_time_in_session`は1セッション内の累計活動時間を計測します。標準設定では、次のしきい値ごとに、ページビューまたはセッションにつき1回ずつイベントを送信します。

```
# spend_time_in_pv
10秒, 30秒, 60秒, 120秒, 180秒, 240秒, 300秒, 360秒, 420秒, 480秒, 540秒, 600秒

# spend_time_in_session
3秒, 10秒, 30秒, 60秒, 120秒, 180秒, 240秒, 300秒, 360秒, 420秒, 480秒, 540秒, 600秒
```

このイベントデータをもとに、ユーザー単位やページ単位の活動時間を算出します。

### A/Bテスト施策のイベント <a href="#experiment_events" id="experiment_events"></a>

A/Bテストの施策配信時には、表示・操作・エラーを表す専用イベントが自動送信されます。これらも非課金です。

詳しくは [A/Bテストで計測されるイベント](https://docs.wicle.io/action/experiment/events.md) をご覧ください。

## オプトインできる自動計測イベント <a href="#optin_events" id="optin_events"></a>

[計測タグ設定画面](https://docs.wicle.io/initial-setting/tag.md#event-delivery)で有効化すると、計測が始まります。追加したイベントは課金対象です。無効化すると以後の計測は停止しますが、それまでに取得したデータは保持期間内で引き続き閲覧できます。

### スクロール率（scroll\_depth） <a href="#scroll-depth" id="scroll-depth"></a>

スクロール可能な範囲に対して、どこまでスクロールしたかを割合で計測します。次のしきい値に達するごとに、**ページビューにつき各しきい値で1回ずつイベントを送信**します。

| タイプ       | しきい値                                              | 用途           |
| --------- | ------------------------------------------------- | ------------ |
| 標準（デフォルト） | 25%, 50%, 75%, 100%                               | 一般的なスクロール計測  |
| 詳細        | 10%, 20%, 30%, 40%, 50%, 60%, 70%, 80%, 90%, 100% | より細かいスクロール分析 |
| 簡易        | 50%, 100%                                         | イベント数を抑えた計測  |

スクロール率は、ページのスクロール位置を「ページ全体の高さから表示領域の高さを引いた値」で割って計算します。ページ最下部が100%です。スクロールできないページや、スクロールできる範囲が表示領域の高さの30%未満のページでは計測しません。

[プロジェクト設定の計測タグ画面](https://app.wicle.io/settings/mesurement-tag)からしきい値のタイプを変更できます。

### 注視領域（viewport\_attention） <a href="#viewport-attention" id="viewport-attention"></a>

ページを複数の領域に分け、各領域がブラウザの表示範囲に入っている時間を計測します。主にヒートマップで使います。

領域が画面外にある時間や、別のタブを表示している時間はカウントしません。視線そのものを計測する機能ではありません。

### フォーム送信（submit） <a href="#form-submit" id="form-submit"></a>

ブラウザ上でフォームの送信操作を表す`submit`イベントが発生すると計測します。サーバー側での送信成功や購入完了を示すものではありません。完了を計測したい場合は、[カスタムイベント](https://docs.wicle.io/data-extension/custom-event.md)などで定義します。

### エラー（error） <a href="#error-event" id="error-event"></a>

#### ブラウザ上でのエラー <a href="#browser-error" id="browser-error"></a>

ブラウザ上で発生したJavaScriptのエラーや警告を、`error`イベントとして計測します。同じエラーが繰り返し送信されないよう、重複を抑制します。

計測対象ごとに、`level`（重大度）と`type`（発生元）、メッセージやスタックトレース（エラーの発生箇所を示す情報）を記録します。

| 計測対象                                                                                                       | level | type               | message              | stack      |
| ---------------------------------------------------------------------------------------------------------- | ----- | ------------------ | -------------------- | ---------- |
| [console.warn](https://developer.mozilla.org/en-US/docs/Web/API/console/warn)                              | warn  | console.warn       | 関数に渡された引数の内容         | -          |
| [console.error](https://developer.mozilla.org/en-US/docs/Web/API/console/error)                            | error | console.error      | 関数に渡された引数の内容         | -          |
| [errorイベント](https://developer.mozilla.org/en-US/docs/Web/API/Element/error_event)                          | error | error              | イベントのmessageプロパティ    | 取得できた場合に記録 |
| [unhandledrejectionイベント](https://developer.mozilla.org/en-US/docs/Web/API/Window/unhandledrejection_event) | error | unhandledrejection | reasonの文字列またはmessage | 取得できた場合に記録 |

#### サーバー上でのエラー <a href="#server-error" id="server-error"></a>

Web APIによるイベント送信を実装すると、サーバー上でのエラーも`error`イベントとして収集できます。ブラウザ上のエラーとは異なり、自動計測ではありません。

{% hint style="info" %}
Web APIの利用には、弊社側での設定とアクセストークンの受け渡しが必要です。利用をご希望の場合は、[サポート窓口](https://docs.wicle.io/other/support/contact.md)へお問い合わせください。
{% endhint %}
