# 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)


---

# 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/metric-reference.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.
