> 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/insight/smart-heatmap/metric-reference.md).

# Metrics Reference

A comprehensive list of all metrics used in Ptengine heatmap, organized by level. Use this when checking metric definitions, formulas, and purposes.

***

## Page-Level Metrics

Metrics showing overall page performance. Primarily used in "Numerical Report" and "Smart Summary" tabs.

| Metric Name          | Definition                                                                                                        | Unit    |
| -------------------- | ----------------------------------------------------------------------------------------------------------------- | ------- |
| Visits               | Number of site visits (sessions). Multiple visits by the same user each count as 1 visit.                         | Count   |
| Unique Users (UU)    | Number of people visiting the site within the period. The same user counts as 1 UU regardless of visit frequency. | Count   |
| Page Views (PV)      | Number of times the page was displayed. Each page load counts as 1 PV.                                            | Count   |
| New Rate             | % of new visits in total visits. Calculation: new visits ÷ total visits                                           | %       |
| Bounce Rate          | % of visits exiting from landing page without visiting other pages. Calculation: bounce visits ÷ total visits     | %       |
| Average Stay Time    | Average stay time on a specific page. Calculation: total stay time ÷ total PV for page                            | Seconds |
| First View Exit Rate | % of visits exiting from first view (initial visible area upon page load)                                         | %       |
| Entrances            | Number of times this page served as entry/landing page                                                            | Count   |
| Average Page Views   | Average number of pages viewed per visit                                                                          | Pages   |
| Click Count          | Total clicks (PC) or taps (mobile) on page, regardless of link presence                                           | Count   |
| Click Rate           | Click rate for the page                                                                                           | %       |
| CTA Click Rate       | Click rate for CTA (Call To Action) buttons                                                                       | %       |
| Conversion Rate      | % of visits achieving set site goals. Calculation: conversions ÷ total visits                                     | %       |
| Completion Count     | Number of visits achieving conversion                                                                             | Count   |

***

## Block-Level Metrics

Metrics showing performance for each block (section) within the page. Used in "Stay," "Exit," and "Conversion" heatmaps.

### Impression ※PV-based

| Metric Name      | Definition                                 | Formula                                               |
| ---------------- | ------------------------------------------ | ----------------------------------------------------- |
| Impression Rate  | % of PVs that scrolled to reach this block | PVs reaching block top ÷ total PVs                    |
| Impression Count | Number of times this block was displayed   | PVs reaching block top (= impression rate × total PVs |

### Stay ※PV-based

| Metric Name             | Definition                                                                                            | Formula                                       |
| ----------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| Block Average Stay Time | Average time this block was visible in the viewport (seconds). Shows how long users viewed the block. | Sum of block viewport time ÷ impression count |

### Exit ※PV-based

| Metric Name     | Definition                                                               | Formula                                                                     |
| --------------- | ------------------------------------------------------------------------ | --------------------------------------------------------------------------- |
| Block Exit Rate | % of PVs viewing this block where it was the deepest reach point on page | PVs with this block as deepest point ÷ PVs viewing block (impression count) |
| Exit Count      | Actual number of PVs exiting at this block                               | Exit rate × impression count                                                |

### Conversion ※Session-based

| Metric Name            | Definition                                                                              | Formula                                                                             |
| ---------------------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Block Conversion Count | Sessions staying 5+ seconds on this block and converting                                | Sessions meeting dwell condition and converting                                     |
| Block Conversion Rate  | % of sessions meeting dwell condition that converted. Default condition: **5+ seconds** | Block conversion count ÷ sessions meeting dwell condition (real\_duration ≥ 5000ms) |

> **Block Conversion Rate Concept**: Rather than users merely "reaching" a block, it shows conversion % among those who "thoroughly reviewed" the block 5+ seconds. This reveals how much the content impacts purchase decisions.
>
> **Calculation Unit**: Block conversion rate uses **session basis** (unlike impression/exit rates using PV basis). This is because conversion is determined across the entire session.

### Block-Level Metrics Calculation Unit Summary

| Metric Category | Calculation Unit  | Target Metrics                                |
| --------------- | ----------------- | --------------------------------------------- |
| Impression      | **PV-based**      | Impression rate, impression count             |
| Stay            | **PV-based**      | Block average stay time                       |
| Exit            | **PV-based**      | Block exit rate, exit count                   |
| Conversion      | **Session-based** | Block conversion count, block conversion rate |

> Impression, stay, and exit measure behavior per page view, so they use **PV-based** calculation. Conversion determines goal achievement across the entire session, so it uses **session-based** calculation.

***

## Element-Level Metrics

Metrics showing performance of individual page elements (buttons, links, images, etc.). Used in "Click" heatmap and "Conversion" heatmap element analysis.

| Metric Name           | Definition                                                                    | Formula                                           |
| --------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------- |
| Click Count           | Number of clicks on target element                                            | —                                                 |
| Click Share           | % of total page clicks accounted for by target element                        | Target clicks ÷ total page clicks                 |
| Visits                | Number of visits (sessions) clicking this element                             | —                                                 |
| CV Contribution Count | Sessions converting after clicking this element                               | Sessions converting after element click           |
| CV Contribution Rate  | % of sessions clicking element that converted. **Session-based** calculation. | CV contribution count ÷ sessions clicking element |

***

## Supplementary: Analysis Metrics Used in Smart Summary

Smart Summary "Ad Effectiveness Analysis" and "Audience Analysis" use the following concepts alongside page-level metrics above.

| Concept                      | Description                                                                                                                              |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Session Count (visits)       | Visit count. Calculated on session basis rather than PV or UU.                                                                           |
| Four-Quadrant Classification | Analysis method classifying ad sources or audience segments into 4 groups using 2 axes: visit count (session count) and conversion rate. |
| Concentrated                 | When a specific ad source or segment represents 95%+ of traffic, treated as overall overview rather than comparative analysis.           |

***

## Related Pages

* [Heatmap Comprehensive Guide](https://gitlab.com/PtmindDev/ptx/ptengine-helps/-/blob/main/DOCS/en/insight/smart-heatmap/overview.md)
* [Stay Heatmap](/en/insight/smart-heatmap/stay-heatmap.md)
* [Exit Heatmap](/en/insight/smart-heatmap/exit-heatmap.md)
* [Click Heatmap](/en/insight/smart-heatmap/click-heatmap.md)
* [Conversion Heatmap](/en/insight/smart-heatmap/conversion-heatmap.md)
