# About Event Labels

## About Event Labels

## What are Event Labels📝

1. Properties for further classifying and describing events in web analytics tools (such as Ptengine and Google Analytics).
2. These are the \[details] of the following user actions taken on websites and apps.

Form submission \[content submitted, etc.]

New member registration \[gender, age, etc.]

Other button clicks \[products added to cart, etc.]

### Basic Structure of Events🔍

Web analytics events (custom events in Ptengine) are primarily composed of three elements.

**Event Category**🗂️ Example: Button clicks, page views, form submissions, etc.—the "general type" of action

**Event Action**▶️ Example: Clicked, submitted, opened, etc.—the specific "action"

**Event Label**🏷️ Example: Which button, which page, what content, what type of user, etc.—the "detailed information"

**Event Label** has the role of recording the details and context of actions among these three elements.

### The Role of Event Labels✨

By using event labels, you can gain a deeper understanding of user behavior.

In this way, event labels make the following content visible and provide insights for site improvements and marketing strategies.

* "Why did users take that action"
* "What characteristics lie behind that action"

### Implementing Event Labels💡

#### Step 1: Clarify What You Want to Understand

This is the first and most important step in implementing event labels.

It is about clarifying "what user behaviors or intentions you want to understand more deeply."

Start by thinking about **business challenges** (example: "Why aren't purchases happening?", "Which content is effective?").

**Questions to ask yourself:**

What are your company's primary business goals?

What user behaviors are necessary to achieve them?

What details or context about that behavior do you want to understand?

#### Step 2: Preparing Code (Developer Guide)

Ptengine event labels can be implemented by embedding simple JavaScript code on your website.

Typically, the assistance of a developer with technical knowledge is required.

The basic calling format is as follows.

```javascript
ptengine.track('event_name', {
    label_key1: 'label_value1',
    label_key2: 'label_value2'
});
```

> **SUCCESS** 'label\_key1' is the event label name, and 'label\_value1' is the label value.

**Specific Implementation Examples**

**Example 1: When the "Download Materials" button is clicked**

"Download Materials" is the event name

document\_id and user\_type are event labels

```javascript
ptengine.track('download_materials', {
    document_id: 'DL001',
    document_name: 'Ptengine User Guide',
    user_type: 'corporate'
});
```

**Example 2: Form Submission Event**

"Contact Form Submission" is the event name

inquiry\_type and service\_name are event labels

```javascript
ptengine.track('contact_form_submit', {
    inquiry_type: 'about_product',
    service_name: 'heatmap_feature'
});
```

> **INFO** *Ptengine tags are designed to be loaded asynchronously to prevent affecting your website's loading speed.*

**Key Points☝️**

Labels can be freely designed to match "what you want to understand."

Code implementation support from Ptengine is also available (paid service).

### Use Cases in Ptengine🚀

With Ptengine, you can easily set up and use event labels.

**Implementation Steps🛠️** First, decide "what information you want to understand" (example: reasons why purchases don't happen, trends in popular products, etc.).

```
Design the necessary event labels, and have developers implement the JavaScript code.

View the data in the Ptengine dashboard and leverage it with heatmaps and analytics features.
```

**Use Case Examples📊** Compare cart addition rates and bounce rates by product category and price range to identify areas for improvement.

```
Analyze drop-off reasons at each stage of service sign-ups and optimize forms and guidance.

Understand behavioral trends by user attributes and apply them to personalized delivery and coupon campaigns.
```

## Summary📝

**Event Labels** are an important mechanism for recording the "details" and "context" of user behavior.

By leveraging this, you can deeply analyze "why that behavior occurred" and "what characteristics it has," leading to business problem discovery and improved results.

With Ptengine, you can easily get started with setting up and using event labels, so please make full use of them as a powerful tool for understanding users and improving your site.


---

# 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/en/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.