> 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/en/start-guide/quick/visual-event-setup.md).

# Visual Event Settings

> **SUCCESS**
>
> **Overview**
>
> Ptengine Insight event settings include two types: visual settings and [manual settings (custom events)](https://helps.ptengine.com/en/start-guide/quick/visual-event-setup.md).
>
> Visual event settings allow you to configure "events" to measure specific button clicks and other actions directly by viewing your website's screen without any programming knowledge (no-code).

## Common Use Cases <a href="#common-use-cases" id="common-use-cases"></a>

This feature is useful in various scenarios where you want to understand specific user behaviors on your site.

**Conversion measurement:** When you want to measure click counts on important buttons such as "Purchase," "Request materials," or "Contact us."

**Content evaluation:** When you want to analyze how frequently specific articles, banners, navigation menus, and other content are being clicked.

**UI/UX improvement:** When you want to collectively measure the usage of buttons that are consistently placed across multiple pages (e.g., the login button in the header) and gain insights for site improvements.

**Post-login action measurement:** When you want to measure element clicks on pages that require login, such as member pages. (Using screen operation mode)

## Visual Event Settings <a href="#visual-event-settings" id="visual-event-settings"></a>

Visual event settings allow you to configure events without code while directly viewing the screen. It's easy to use even without technical knowledge.

### Video Guide <a href="#video-guide" id="video-guide"></a>

### Text Version Guide <a href="#text-version-guide" id="text-version-guide"></a>

### 1. Select a Web Page <a href="#id-1.-select-a-web-page" id="id-1.-select-a-web-page"></a>

Open the event settings page.

Select the web page that contains the element for which you want to configure an event.

Enter URL directly

```
Select from "After parameter removal" or "Original page" list

Search by title/URL
```

### 2. Enter Event Settings Mode <a href="#id-2.-enter-event-settings-mode" id="id-2.-enter-event-settings-mode"></a>

The selected web page opens in a separate tab.

When you hover the mouse cursor over elements, a red frame appears, and you can configure events by clicking.

> **WARNING** Accordion menus and other elements that require click operations should use "screen operation mode."

### 3. Configure Measurement Target <a href="#id-3.-configure-measurement-target" id="id-3.-configure-measurement-target"></a>

When you click on an element, the number of clicks from the past 7 days is displayed. There are two ways to configure the measurement target:

**Selected element only:**

Identify a specific element in the HTML source

```
Recommended if an id attribute exists
```

**Custom:**

Identify elements by tag, class, href, or text

Turning on "Ignore DOM structure" applies it to the entire page

> **DANGER** If tags or attributes are changed during site modifications, the element may no longer be identifiable.

### 4. Configure Event Name and Measurement Scope <a href="#id-4.-configure-event-name-and-measurement-scope" id="id-4.-configure-event-name-and-measurement-scope"></a>

**Event name:** 20 characters or fewer (cannot be changed)

**Measurement scope:**

Applicable domain

```
Applicable page

URL rules (when targeting multiple pages)
```

### 5. Confirm Settings <a href="#id-5.-confirm-settings" id="id-5.-confirm-settings"></a>

Click "Confirm" to complete the settings. You can check the event list at the gear icon > Event Settings.

## How to Confirm Settings <a href="#how-to-confirm-settings" id="how-to-confirm-settings"></a>

Data collection begins approximately 3 minutes after configuration.

It takes 30 minutes to 1 hour for the data to be reflected in the event analysis dashboard.

For immediate verification, refer to "How to verify that events are firing correctly."

📌 Only events with 1 or more measurements are displayed on the event analysis screen.

Related Features

### 1. Modify or Delete Settings <a href="#id-1.-modify-or-delete-settings" id="id-1.-modify-or-delete-settings"></a>

Event name and measurement target/scope cannot be changed.

Creating a new event with the same name allows you to expand the measurement target.

### 2. Add Measurement Target to Existing Event <a href="#id-2.-add-measurement-target-to-existing-event" id="id-2.-add-measurement-target-to-existing-event"></a>

If you configure different page elements with the same event name, the existing event will be updated.

### 3. Confirm Configured Events <a href="#id-3.-confirm-configured-events" id="id-3.-confirm-configured-events"></a>

You can check the configured events on the current URL with "Confirm configured events."

### 4. Screen Operation Mode <a href="#id-4.-screen-operation-mode" id="id-4.-screen-operation-mode"></a>

Use when you need to work with pages after login or perform menu operations.

### 5. Hide Toolbar <a href="#id-5.-hide-toolbar" id="id-5.-hide-toolbar"></a>

You can hide the toolbar by clicking the "Hide" button in the top right.

## **Confirming Settings After Configuration** <a href="#confirming-settings-after-configuration" id="confirming-settings-after-configuration"></a>

Data collection begins approximately 3 minutes after configuration is complete.

It takes approximately 30 minutes to 1 hour for data to be reflected in the event analysis dashboard.
