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

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

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なら、イベントプロパティーの設定・活用も手軽に始められるので、ユーザー理解とサイト改善の強力な武器としてぜひ活用してください。


---

# 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://helps.ptengine.com/experience/setting/event-labels.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.