> 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.md).

# 可视化事件

事件，就是用户在网站上做出的有意为之的动作——点了某个按钮、滚到了页面某处、完成了注册、下了单。

把这些动作记下来，你才能从“有多少人来过”，往前走到“他们来了之后到底做了什么”。

***

## 想做什么，看哪篇 <a href="#what-to-read" id="what-to-read"></a>

| 想做什么                  | 看这篇                                                                                  |
| --------------------- | ------------------------------------------------------------------------------------ |
| 不写代码，点几下就把一个按钮设成事件    | [可视化事件设置方法](https://helps.ptengine.com/cn/insight/event/setup.md)                    |
| 设完了，确认事件有没有真的被触发      | [事件发包的检查](https://helps.ptengine.com/cn/insight/event/verify-firing.md)              |
| 需要采集点击次数以外的信息（金额、品类…） | [自定义事件的设置方法](https://helps.ptengine.com/cn/experience/setting/custom-event-setup.md) |

***

## 两种事件，先搞清楚该用哪种 <a href="#two-event-types" id="two-event-types"></a>

|     | 可视化事件                     | 自定义事件            |
| --- | ------------------------- | ---------------- |
| 怎么设 | 在页面上点选元素，无需 JavaScript 知识 | 写 JavaScript 代码  |
| 能采集 | **只有点击次数**                | 点击次数 + 自定义信息     |
| 举例  | “加入购物车”被点了多少次             | 下单用户买的是什么品类、金额多少 |
| 适合  | 快速验证某个按钮有没有人点             | 需要把业务数据一起带回来     |

> 先用可视化事件把基础的点击量跑起来；确实需要更细的数据时，再上自定义事件。

***

## 能用来做什么 <a href="#what-you-can-do" id="what-you-can-do"></a>

**评估用户行为**

* CTA 按钮到底有多少人点
* 商品详情页“加入购物车”的点击次数
* 页面上某块内容的点击情况

**做细分对比**

* 不同流量来源进来的用户，行为有什么差别
* 触发过某事件 / 没触发过的用户，后续表现差多少

**往下游串**

* 把关键事件设成[转化](https://helps.ptengine.com/cn/insight/conversion.md)，看它带来的成果
* 按事件把人圈成[用户组](https://helps.ptengine.com/cn/experience/user-group.md)，再针对性投放体验

***

## 事件分析界面怎么看 <a href="#how-to-read-the-report" id="how-to-read-the-report"></a>

进入 Insight 的“事件”标签页，左侧有**事件分析**和**事件探索**两个入口，默认进的是**事件分析**。界面从上到下分三块。事件尚未设置或数据未采集时显示的是另一个界面。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-228ddd8f8bbdbfa8bf1eb9a0d4e55bf1faab637d%2Finsight-event-overview-01.png?alt=media" alt="事件分析界面全貌：上方选择栏、中间趋势图、下方事件列表"><figcaption></figcaption></figure>

**① 事件选择栏**

从左到右依次是时间范围设置 → 事件筛选 → CSV 导出。

* 时间范围可按区间，也可精确到单日
* 点击事件筛选框，会列出该时间段内发生过的事件名；选“所有事件”则显示全部
* 选中某个具体事件后，可以再叠加其他筛选条件

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-42a9ef0f5845a410be03cb258b4074a4d21f6c58%2Finsight-event-toolbar-01.png?alt=media" alt="事件选择栏：日期范围、事件筛选、CSV 导出"><figcaption></figcaption></figure>

**② 事件趋势图**

展示所选时间段内事件的变化。

* 显示口径可在“事件数”和“访问次数”之间切换——**访问次数指的是发生过该事件的会话数**，和事件数不是一回事（一次访问里可能触发多次同一事件）
* 支持按日 / 周 / 月查看
* 最多可同时对比 5 个事件；点击图上方的事件名可以单独隐藏或显示某条线

图右上角两个下拉就是口径和粒度：左边选**事件**或**访问次数**，右边选**按天** / 按周 / 按月。旁边的**比较**要先选定具体事件才可用。

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-a4ef3604d26c3d88ae3b85d6b852384fbb2faf7e%2Finsight-event-trend-01.png?alt=media" alt="事件趋势图：图例、比较按钮、口径与粒度下拉"><figcaption></figcaption></figure>

**③ 事件列表**

列出事件名及对应的事件数、访问次数。

* 右侧漏斗图标可对事件数据做细分
* 眼睛图标可展开该事件的详细报告
* 点击指标名可改变排序

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-20e93be637648614a5fb7067b9bfd8775b00a581%2Finsight-event-list-01.png?alt=media" alt="事件列表：每行右侧的漏斗图标与眼睛图标"><figcaption></figcaption></figure>

***

## 开始之前 <a href="#before-you-start" id="before-you-start"></a>

* 事件基于已部署的 Ptengine 基础代码，尚未部署请先参考 [基础代码的安装方法](https://helps.ptengine.com/cn/start-guide/quick/tag-setup.md)
* 事件名**设定后无法修改**，同名事件会被视为同一个事件合并计数——设之前先想好命名
* 事件设置完成后约 5 分钟开始采集，数据通常 2 小时内反映到界面

***

## 注意事项 <a href="#notes" id="notes"></a>

* 事件只从设置那一刻起开始积累，查不到设置之前的历史数据
* 设不了事件、或设了没数据，参考 [无法配置事件的情况](https://helps.ptengine.com/cn/faq/insight-setting/event-cannot-set.md) 与 [事件/转化常见问题](https://helps.ptengine.com/cn/faq/others/event-conversion-faq.md)
* 同类按钮想合并成一个事件统计，参考 [如何将同一类型的按钮合并为一个事件](https://helps.ptengine.com/cn/faq/insight-setting/event-merging.md)
