> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/experience/setting/event-labels.md).

# イベントラベルについて

## イベントプロパティーとは📝

1．ウェブ解析ツール（PtengineやGoogleアナリティクスなど）でイベントをさらに細かく分類・説明するためのプロパティです。

2．ウェブサイトやアプリでユーザーが行った以下のような行動の【詳細】です。

* フォーム送信　 【送信した内容など】
* 新規会員登録　 【性別、年齢など】
* その他ボタンのクリック　 【カートに追加した商品など】

### イベントの基本構成🔍

ウェブ解析のイベント（Ptneingeではカスタムイベント）は、主に3つの要素で構成されています。

1. **イベントカテゴリ**🗂️\
   例：ボタンクリック、ページ閲覧、フォーム送信など、行動の「大まかな種類」
2. **イベントアクション**▶️\
   例：クリックした、送信した、開いたなど、具体的な「動作」
3. **イベントプロパティー**🏷️\
   例：どのボタンか、どのページか、どんな内容か、どのようなユーザーかなど、「詳細な情報」

**イベントプロパティー**はこの中で、行動の詳細や背景を記録する役割を持っています。

### イベントプロパティーの役割✨

イベントプロパティーを使うことで、ユーザー行動をより深く理解できます。

<table><thead><tr><th width="105.53125">例</th><th width="170.078125">イベントカテゴリ</th><th width="169.8203125">イベントアクション</th><th width="170.48046875">イベントプロパティー</th><th>可能な分析</th></tr></thead><tbody><tr><td>ECサイト</td><td>ボタンクリック</td><td>カートイン</td><td>・商品名<br>・商品ID<br>・価格<br>・商品カテゴリなど</td><td><p>・人気の商品は？</p><p>・高額商品かどうか</p></td></tr><tr><td>求人サイト</td><td>ボタンクリック</td><td>応募</td><td>・応募した求人のID<br>・性別、年齢<br>・勤務年数など</td><td><p>・人気のある求人は？</p><p>・応募者の特徴は？</p></td></tr></tbody></table>

このように、イベントプロパティーは以下のような内容を見える化し、サイト改善やマーケティング施策をヒントを与えます。

・「ユーザーがなぜその行動を取ったのか」

・「その行動の裏にどんな特徴があるのか」

### イベントプロパティーの実装💡

#### Step１：何を知りたいかを明確にする

イベントプロパティー導入において最初で最も重要なステップです。

「ユーザーのどんな行動や意図を深く理解したいか」を明確にすることです。

**ビジネス課題**（例：「なぜ購入されないのか？」、「どのコンテンツが効果的か？」）を出発点に考えましょう。

**自問すべきポイント：**

* 自社の主要なビジネス目標は何か？
* その達成に必要なユーザー行動は何か？
* その行動の背景や詳細で知りたいことは何か？

#### Step２：コードの用意（開発者向けガイド）

Ptengineのイベントプロパティーは、シンプルなJavaScriptコードをウェブサイトに埋め込むことで実装できます。

通常、技術的な知識を持つ開発者の協力が必要です。

基本的な呼び出し形式は以下の通りです。

```javascript
ptengine.track('イベント名', {
    property_key1: 'property_value1',
    property_key2: 'property_value2'
});
```

{% hint style="success" %}
'label\_key1' はイベントプロパティー名、'label\_value1' はラベルの値です。
{% endhint %}

**実装の具体例**

**例1：「資料請求」のボタンがクリックされた場合**

* `資料請求`がイベント名
* `document_id`や`user_type`などがイベントプロパティー

```javascript
ptengine.track('資料請求', {
    document_id: 'DL001',
    document_name: 'Ptengine活用ガイド',
    user_type: '法人'
});
```

**例2：フォーム送信イベント**

* `お問い合わせ送信`がイベント名
* `inquiry_type`や`service_name`がイベントプロパティー

```javascript
ptengine.track('お問い合わせ送信', {
    inquiry_type: '製品について',
    service_name: 'ヒートマップ機能'
});
```

{% hint style="info" %}
*ウェブサイトの読み込み速度に影響を与えないよう、Ptengineのタグは非同期で読み込まれるように設計されています。*
{% endhint %}

**ポイント☝️**

* ラベルは「何を知りたいか」に合わせて自由に設計できます。
* コード実装が、Ptengineのサポートも利用可能です（有料サービス）。

### Ptengineにおける活用例🚀

Ptengineでは、イベントプロパティーを簡単に設定・活用できます。

* **導入ステップ🛠️**
  1. まず、「どんな情報を知りたいか」を決める（例：購入につながらない理由、人気商品の傾向など）。
  2. 必要なイベントプロパティーを設計し、開発者がJavaScriptコードを実装。
  3. Ptengineの管理画面でデータを確認し、ヒートマップや分析機能で活用。
* **活用事例📊**
  * 商品カテゴリや価格帯ごとにカート投入率や離脱率を比較し、改善点を発見。
  * サービス申し込みの各段階での離脱理由を分析し、フォームや案内を最適化。
  * ユーザー属性ごとの行動傾向を把握し、パーソナライズ配信やクーポン施策に活用。

## まとめ📝

* **イベントプロパティー**は、ユーザー行動の「詳細」、「背景」を記録するための大切な仕組みです。
* これを活用することで、「なぜその行動が起きたのか」、「どんな特徴があるのか」を深く分析でき、ビジネスの課題発見や成果向上につながります。
* Ptengineなら、イベントプロパティーの設定・活用も手軽に始められるので、ユーザー理解とサイト改善の強力な武器としてぜひ活用してください。