> 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/tag-spec.md).

# Wicleタグの仕様

Wicleの計測タグが取得するデータと動作の仕組み、ユーザープロファイル・カスタムイベントとの役割の違いを説明します。

## Wicleの各種タグについて <a href="#block-08830a31e5f2487599d2d6d66a50e53c" id="block-08830a31e5f2487599d2d6d66a50e53c"></a>

Wicleは、サイトに設置した計測タグ（JavaScript）でユーザーの行動データを取得します。会員情報や購入金額などを分析に使う場合は、ユーザープロファイルやカスタムイベントを追加で送信します。

計測タグは非同期で読み込まれます。ただし、タグの実行やデータ送信にはブラウザの処理や通信が発生するため、サイトの構成や閲覧環境によって表示速度に影響する場合があります。

### イベントデータの取得 <a href="#event-data" id="event-data"></a>

ページの閲覧やクリックなど、ユーザーの行動をイベントとして取得します。ページビュー・クリック・活動時間は標準で計測され、スクロール率・注視領域・フォーム送信・エラーは設定画面で有効化すると計測されます。

対象や計測条件は[自動計測されるイベント](/data-setting/event-tracking/auto-event.md)をご覧ください。送信後、管理画面に反映されるまでには[集計の時間](/data-setting/measured-data/renewal-period.md)がかかります。

### ユーザーデータの取得 <a href="#user-data" id="user-data"></a>

来訪回数やクリックの発生数など、ユーザーごとの集計値は、計測したイベントをもとに更新されます。

会員IDや会員ランクなど、サイトが持つ属性情報は自動では取得されません。[ユーザープロファイル](/data-extension/user-profile.md)で、送信する情報を明示的に指定します。会員登録後やログイン後、会員情報の更新時などに送信します。

イベントから計算する値とユーザープロファイルの違いは、[データの種類と特徴](/data-setting/data-type.md)をご覧ください。

### カスタムイベントデータの取得 <a href="#custom-event-data" id="custom-event-data"></a>

購入完了や購入金額など、自動計測では取得できない行動や情報は、サイト側から[カスタムイベント](/data-extension/custom-event.md)として送信します。計測したい行動が発生するタイミングに合わせて、送信処理を実装します。

### セッションリプレイデータの取得 <a href="#session-replay-data" id="session-replay-data"></a>

[セッションリプレイの設定](/analytics/session-replay/setting.md)を有効にすると、ブラウザ上で動くスクリプトがHTMLドキュメント、HTMLの変更、マウス操作などの情報を取得し、サーバーへ送信します。再生時は、保存した情報をもとに管理画面でHTMLと操作を再現します。

## タグの種類 <a href="#block-7d4664083cbb45f3a6266dd7d4a5765c" id="block-7d4664083cbb45f3a6266dd7d4a5765c"></a>

計測タグは必須です。追加のデータを送る場合は、目的に応じてユーザープロファイルやカスタムイベントの送信処理を設置します。

| 名称                                            | 条件 | 役割                    | 設置・実行する場所              |
| --------------------------------------------- | -- | --------------------- | ---------------------- |
| [計測タグ](/initial-setting/tag.md)               | 必須 | サイト上の行動の自動計測とデータ送信    | 計測するすべてのページ            |
| [ユーザープロファイル](/data-extension/user-profile.md) | 任意 | 会員IDや会員ランクなどの属性情報を送信  | 会員登録後、ログイン後、会員情報の更新時など |
| [カスタムイベント](/data-extension/custom-event.md)   | 任意 | 任意の行動と、その行動に付随する情報を送信 | 計測したい行動が発生する場所         |

追加の送信処理より先に、計測タグの初期化コードを実行してください。
