# Performance & Metrics

> Current Froomle documentation · [View canonical page](https://docs.froomle.com/froomle-doc-main/v2/guide/topics/performance-metrics.html)

Froomle provides detailed metrics to help you understand the performance of your recommendations and the behavior of your users.

<a id="_metrics_overview"></a>

## Metrics overview

Metrics are aggregated in time slices and can be filtered by module, page type, or channel. Key groups include:

-   **General metrics** (pageviews, item interactions, purchases).
    
-   **Integration metrics** (requests, recommendation\_sets, clicks, impressions).
    
-   **Attribution metrics** (attributed revenue, attributed purchases).
    

<a id="_metric_definitions_overview"></a>

## Metric definitions (overview)

The dashboard and API expose the following common metrics:

<a id="_general_metrics"></a>

### General metrics

| Name | Description |
| --- | --- |
| pageviews | Aggregates view events across all known pages. |
| item\_interactions | Aggregates item\_interaction events. |
| add\_to\_carts | Aggregates add\_to\_cart events across all pages and page types. |
| purchased\_items | Aggregates purchases of individual items. |
| batch\_opens | Aggregates batch open events across all integration types. |
| revenue | Aggregates the total price of purchases. |

<a id="_integration_metrics"></a>

### Integration metrics

| Name | Description |
| --- | --- |
| clicks | Aggregates click\_on\_recommendation events across all integration types. |
| requests | Aggregates all requests across all integration types. |
| recommendation\_sets | Recommendations generated by Froomle, distinct by request\_id. |
| impressions\_sets | Impressions across all integration types, distinct by request\_id. |
| batch\_clicks | Aggregates batch\_click\_on\_recommendation events. |
| batch\_requests | Aggregates batch requests across all integration types. |
| batch\_recommendation\_sets | Batch recommendations generated by Froomle, distinct by request\_id. |
| batch\_impressions\_sets | Batch impressions across all integration types, distinct by request\_id. |

<a id="_attribution_metrics"></a>

### Attribution metrics

| Name | Description |
| --- | --- |
| attributed\_purchased\_items | Purchases of items recommended by Froomle within the attribution window. |
| attributed\_revenue | Revenue from purchases attributed to Froomle recommendations. |
| attributed\_item\_interactions | Item interactions attributed to Froomle recommendations. |

<a id="_typical_news_publisher_metrics"></a>

## Typical news publisher metrics

These are common metrics used by news publishers when evaluating recommendation performance:

-   **Item CTR** - Clicks divided by impressions at the individual item level.
    
-   **List CTR** - Clicks divided by impressions for the full recommendation list (module level).
    
-   **Page CTR** - Clicks divided by pageviews where a recommendation module was shown.
    
-   **Recommendation coverage** - Share of pageviews where a recommendation module rendered successfully.
    
-   **Clicks per session** - How many recommendation clicks occur within a user session.
    
-   **Recirculation rate** - Share of sessions with at least one recommendation click.
    
-   **Article recirculation rate** - Percentage of sessions that continue after viewing an article.
    
-   **Article depth** - Average number of articles read per session.
    
-   **Session duration** - Measured as pages per session, article-detail pages per session, and total time.
    
-   **Subscriber conversion rate** - Share of users who convert after interacting with recommendations.
    
-   **Paid vs. free mix** - Proportion of recommended clicks on paid vs. free articles.
    
-   **Freshness distribution** - Share of clicks on items within a recency window.
    
-   **Retention** - Percentage of users who return per day.
    

<a id="_related_topics"></a>

## Related topics

-   [Event model and tracking contract](https://docs.froomle.com/froomle-doc-main/v2/guide/topics/tracking-events.html)
    
-   [A/B testing and benchmarking](https://docs.froomle.com/froomle-doc-main/v2/guide/topics/ab-testing-benchmarking.html)