# Visual Event Settings

> **SUCCESS**
>
> **Overview**
>
> Ptengine Insight event settings include two types: visual settings and [manual settings (custom events)](/en/getting-started/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

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

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

### Text Version Guide

### 1. Select a Web Page

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

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

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

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

**Measurement scope:**

Applicable domain

```
Applicable page

URL rules (when targeting multiple pages)
```

### 5. Confirm Settings

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

## How to Confirm Settings

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

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

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

### 3. Confirm Configured Events

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

### 4. Screen Operation Mode

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

### 5. Hide Toolbar

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

## **Confirming Settings After Configuration**

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.


---

# 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/getting-started/quick/visual-event-setup.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.