> 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/cn/insight/event/setup.md).

# 可视化事件设置方法

> 关于代码方式的事件监测，请参阅[自定义事件的设置方法](/cn/experience/setting/custom-event-setup.md)。

## 此功能的优势 <a href="#benefits-of-this-feature" id="benefits-of-this-feature"></a>

**无需编码：** 即使没有HTML或JavaScript知识，任何人都可以轻松设置事件。

**直观的操作：** 只需在实际网站屏幕上点击要监测的元素，即可以可视化的方式进行设置。

**快速分析：** 设置后立即开始采集数据，可以快速分析用户行为。

## 常见应用场景 <a href="#common-use-cases" id="common-use-cases"></a>

监测“购买”和“资料请求”等重要转化按钮的点击次数。

统一监测在多个页面上共同设置的“收藏”按钮和社交媒体分享按钮的点击次数。

监测汉堡菜单或手风琴菜单等需要操作才能显示的元素的点击次数。

了解网站内特定图像或横幅被点击的次数。

## 设置方法 <a href="#setup-method" id="setup-method"></a>

可视化事件可以通过以下3个步骤进行设置。

### 步骤1：选择要监测的元素 <a href="#step-1-select-elements-to-measure" id="step-1-select-elements-to-measure"></a>

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2FYuNneylPzdSkRw1ICnS3%2Fimage.png?alt=media&amp;token=270d4515-0d42-40ff-9259-ef77734b67b8" alt=""><figcaption></figcaption></figure>

从Ptengine管理屏幕右上角的齿轮图标中选择“事件设置”，然后点击“添加”按钮。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fht2Uyj5g9H4crRCLIoK7%2Fimage.png?alt=media&amp;token=ddabfed3-bdf3-4a67-a4ef-0c9082bf6642" alt=""><figcaption></figcaption></figure>

输入要设置事件的页面URL，点击“Go”按钮，设置屏幕将在另一个选项卡中打开。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2FUgn7EQ26iYW5Lx2c29dV%2Fimage.png?alt=media&amp;token=b31b69e5-5b9a-4de8-b156-a5b12436b6e7" alt=""><figcaption></figcaption></figure>

点击“确认”按钮后，选择要设置事件的元素。将鼠标光标悬停在可设置的元素上时，它们将显示为红色边框。 点击元素时，将显示该元素过去7天的点击次数。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2F9MKynI1AVfiNoxZnNh5O%2Fimage.png?alt=media&amp;token=975351e8-301f-47bd-b00a-3ded2a291edf" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2FMnIlChheihqOrzxrQjC1%2Fimage.png?alt=media&amp;token=c3626476-f06c-4c62-8339-d836cfcc5d40" alt=""><figcaption></figcaption></figure>

※如果要为需要点击操作才能显示的元素（如手风琴菜单）设置事件，需点击“交互模式”将元素展开再返回事件设置。

选择“元素范围”。

**①如果是“仅所选元素”的情况**

仅监测点击的特定元素。 当元素设置了“id”等需要精确指定的情况时，建议使用此选项。

例如，从HTML源代码的body元素中，将所选元素设置为事件目标。 `body > div:nth-child(5) > div:nth-child(2) > div:nth-child(1) > button:nth-child(3)` 这样，按顺序追踪嵌套的“框”来指定。 这就像从网页的“正文(body)”这个大框中，选择“第5个框中的第2个框中的第1个框中的第3个按钮”这样的目标“部件(元素)”。

如果“部件(元素)”有“id”名称，可以直接通过“id”选择，而无需考虑顺序。因此，如果要设置事件的“部件(元素)”有“id”，建议选择“**仅所选元素**”会更简单。

但是，**如果元素没有“id”，当网页结构改变时，事件可能无法正确监测，请重新设置事件**。

**②如果是“自定义”的情况**

当您想要一起监测与所选元素相同类型、相同父元素或具有相同属性的多个元素（例如：设计相同的按钮）时，建议使用此选项。 建议在滚动页面时确认设置的标签是否都适合作为监测对象。

但是，**如果由于网站改版等原因改变了上述指定的标签或属性，改变后的元素将无法识别，请注意。**

#### **步骤2：设置事件名称和监测范围** <a href="#step-2-set-event-name-and-measurement-range" id="step-2-set-event-name-and-measurement-range"></a>

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2F9n9DTFUzc90ZE6jTc4ln%2Fimage.png?alt=media&amp;token=cda23b0d-3b89-4f1b-a52c-02cfa8090641" alt=""><figcaption></figcaption></figure>

**输入事件名称**。 无论全角还是半角，上限为20个字符。

一旦设置的事件名称无法更改。名称相同的事件将视为同一事件合并计数。

**选择监测范围**。

**相应页面：** 仅针对步骤1中指定的页面。

* 相应域名： 针对与步骤1中指定的URL位于同一域名内的所有页面。
* URL规则： 可以使用“包含”、“正则表达式”、“前缀匹配”等规则指定特定的多个页面。

#### **步骤3：完成设置** <a href="#step-3-complete-the-setup" id="step-3-complete-the-setup"></a>

设置完成后，点击“确认”，当出现以下屏幕时，设置即完成。

设置的事件可以从档案名称旁边的齿轮图标 > 事件设置中的列表中确认。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2FrzwXD8dedTxSSRTFZnEg%2Fimage.png?alt=media&amp;token=c9a4dd07-6a13-40cd-8eee-5ae7d8e08a28" alt=""><figcaption></figcaption></figure>

### **关于修改和删除设置** <a href="#about-changing-and-deleting-settings" id="about-changing-and-deleting-settings"></a>

一旦设置的事件的“事件名称”和“监测对象/范围”无法更改。

可以从“事件设置”页面删除设置或编辑备注。

如果使用与现有事件相同的名称创建新事件，现有事件将以添加监测对象的形式进行更新。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2FKg5ELnfCMLIfur4lqS4N%2Fimage.png?alt=media&amp;token=97fb1409-6d57-48d5-bcbe-a8e6bc8cfd2a" alt=""><figcaption></figcaption></figure>

#### **删除事件/编辑备注** <a href="#delete-events-and-edit-notes" id="delete-events-and-edit-notes"></a>

从档案名称旁边的齿轮图标 > 事件设置进入列表页面，然后从屏幕右侧的编辑/删除按钮执行操作。

#### **为现有事件添加监测对象** <a href="#add-measurement-targets-to-existing-events" id="add-measurement-targets-to-existing-events"></a>

当设置添加不同页面元素作为事件时，

使事件名与现有事件名相同，

将不会在管理屏幕中添加为新事件，

现有事件将以更新的形式保存。

在事件列表屏幕上点击编辑按钮时，将打开此屏幕。

因此，通过添加另一个元素，可以扩展现有事件的监测范围。但请注意，如果重复设置相同的元素，监测也会重复。

### **交互模式** <a href="#screen-operation-mode" id="screen-operation-mode"></a>

如果要设置的事件的元素需要通过以下类似的界面操作来设定，请使用事件设置屏幕顶部工具栏左上角的交互模式开关。

适用场景例如：\
\
\- 有商品时的购物车\
\- 登录后的页面\
\- 汉堡菜单\
\- 手风琴菜单

默认情况下为OFF，但启用时可以进行屏幕操作。

### **元素层级选择** <a href="#element-hierarchy-selection" id="element-hierarchy-selection"></a>

为提升用户在可视化事件设置过程中的体验，我们新增了元素层级选择功能。当页面样式导致无法直接选中目标元素时，用户现在可以通过层级选择，逐级定位并选中目标元素，从而顺利完成事件的设置。这一功能极大地提升了复杂页面下事件配置的灵活性和准确性。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-1334169c87dcefe192832924c6cb928aa0dbb702%2Finsight-event-setup-1.png?alt=media" alt=""><figcaption></figcaption></figure>

### **隐藏工具栏** <a href="#hide-toolbar" id="hide-toolbar"></a>

可以通过事件设置屏幕右上的隐藏按钮隐藏工具栏。

点击绿色箭头将返回到原始状态。

### **与Experience的集成** <a href="#integration-with-experience" id="integration-with-experience"></a>

Insight的事件可以与Experience的事件进行集成。 但是，Experience是按用户数汇总的，而Insight是按会话为单位，因此数值不一定一致。

有关详细的设置方法，请参考Experience的[编辑器使用指南](/cn/experience/campaign/create-new/editor-usage.md)。

### **关于事件的常见问题** <a href="#frequently-asked-questions-about-events" id="frequently-asked-questions-about-events"></a>

1. [无法设置事件时](/cn/faq/insight-setting/event-cannot-set.md)
2. [PC页面和SP页面使用相同URL时](/cn/faq/start-guide/pc-sp-switch.md)
3. [如何将相同类型的按钮合并为一个事件](/cn/faq/insight-setting/event-merging.md)
4. [事件的手动设置](/cn/experience/setting/custom-event-setup.md)
