# Smart Heatmap

{% hint style="info" %}
"Too much content, no time to read it all" and "Too much jargon, can't understand it even when I do."

If these frustrations sound familiar,

just **click the button to the right of the title to** summon your AI assistant to answer your questions and clear things up!

<img src="/files/cJtDeSQuyK5XHlDuSIXk" alt="" data-size="original">
{% endhint %}

Ptengine's Smart Heatmap analyzes user behavior — **stay time / exits / clicks / conversions** — in real time, based on data captured by your installed tracking tag.

The Smart Summary feature reads the actual page structure, combines it with collected data, and uses AI to automatically explain "why" the observed behavior is happening.

Through 8 feature tabs, you can examine every aspect of user behavior on your pages.

***

## What this tool can tell you (use cases)

| What you want to know                             | Which feature to use                                                  |
| ------------------------------------------------- | --------------------------------------------------------------------- |
| Quickly understand the overall page situation     | [Smart Summary](/en/insight/smart-heatmap/smart-summary.md)           |
| Which content users focus on                      | [Stay Heatmap](/en/insight/smart-heatmap/stay-heatmap.md)             |
| Where users exit the page                         | [Exit Heatmap](/en/insight/smart-heatmap/exit-heatmap.md)             |
| Which buttons and links get clicked               | [Click Heatmap](/en/insight/smart-heatmap/click-heatmap.md)           |
| Which content drives conversions                  | [Conversion Heatmap](/en/insight/smart-heatmap/conversion-heatmap.md) |
| Numerical reports for page / blocks / elements    | [Data Report](/en/insight/smart-heatmap/numerical-report.md)          |
| Compare before/after, segments, or multiple views | [Comparison Heatmap](/en/insight/smart-heatmap/comparison.md)         |
| Save heatmap images for reports                   | [Screenshot](/en/insight/smart-heatmap/screenshot.md)                 |

***

## 8 feature tabs

| Tab                                                                   | Type        | Summary                                                 |
| --------------------------------------------------------------------- | ----------- | ------------------------------------------------------- |
| [Smart Summary](/en/insight/smart-heatmap/smart-summary.md)           | AI Analysis | AI auto-generates page-level and block-level insights   |
| [Stay Heatmap](/en/insight/smart-heatmap/stay-heatmap.md)             | Heatmap     | Visualize user stay time per block                      |
| [Exit Heatmap](/en/insight/smart-heatmap/exit-heatmap.md)             | Heatmap     | Visualize where users exit per block                    |
| [Click Heatmap](/en/insight/smart-heatmap/click-heatmap.md)           | Heatmap     | Visualize click behavior on page elements               |
| [Conversion Heatmap](/en/insight/smart-heatmap/conversion-heatmap.md) | Heatmap     | Evaluate conversion contribution by block / element     |
| [Data Report](/en/insight/smart-heatmap/numerical-report.md)          | Data Report | Comprehensive performance for page / blocks / elements  |
| [Comparison Heatmap](/en/insight/smart-heatmap/comparison.md)         | Comparison  | Compare multiple heatmaps side by side                  |
| [Toolbar](/en/insight/smart-heatmap/toolbar.md)                       | Common      | Page switching, period, segment, share, page save, etc. |

***

## Before you start — setup order matters

To make the most of Smart Heatmap, complete the following setup in order:

```
① Configure Conversion (CV)
② Configure Blocks
③ Configure Elements
```

| Setup        | What it unlocks                                                                   |
| ------------ | --------------------------------------------------------------------------------- |
| ① Conversion | CV analysis in Conversion Heatmap / Data Report; better Smart Summary accuracy    |
| ② Blocks     | Block-level Stay / Exit / Conversion analysis; Smart Summary block interpretation |
| ③ Elements   | Click and element-conversion analysis; CTA designation                            |

> **You don't need to be perfect — just get started.** All settings can be adjusted later.

For step-by-step instructions:

* [Getting Started: 3 Setup Steps](/en/insight/smart-heatmap/getting-started.md)
* [Block & Element Setup](/en/insight/smart-heatmap/block-element-settings.md)

***

## Migrating from Classic Heatmap?

Use the migration table to find where each classic-version feature lives in Smart Heatmap.

→ [Migration from Classic Heatmap](/en/insight/smart-heatmap/migration-from-classic.md)

***

## Dynamic site support

Ptengine has used dynamic-heatmap technology since the beginning, with **rendering engines that handle dynamic pages** rather than static page captures.

Hamburger menus, mega menus, sliders, accordion content, responsive layouts, advanced interactive designs, and SPAs are all supported.

The toolbar's **Interactive Mode (画面操作モード)** lets you view heatmaps with tabs/accordions in their open states. See [Toolbar](/en/insight/smart-heatmap/toolbar.md) for details.

***

## Notes

Heatmaps may not capture data correctly in these cases:

* Pages with iframe embeds
* Sites with JavaScript-generated dynamic IDs
* Pages where height or content changes frequently
* Pages with duplicate IDs

See [Special Cases & Troubleshooting](/en/insight/smart-heatmap/special-cases.md) for handling.

Recommended browsers: Chrome, Microsoft Edge, Firefox. Installing the [Ptengine Assistant](/en/getting-started/what-is-ptengine/ptengine-assistant.md) Chrome extension improves compatibility.


---

# 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/insight/smart-heatmap.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.
