> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runconverge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics

export const Icon = ({name}) => {
  return <div className="h-4 w-4 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle">
            <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100" style={{
    maskImage: `url('https://mintlify.b-cdn.net/v6.5.1/solid/${name}.svg')`,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
        </div>;
};

export const IconText = ({name, text, iconSource = "mintlify", iconLocation = "before", iconType = "solid"}) => {
  const sourceUrl = iconSource === 'local' ? `url('/images/icons/${name}.svg')` : `url('https://mintlify.b-cdn.net/v6.5.1/${iconType}/${name}.svg')`;
  return <>
            <div className="inline-block pl-2">
                {iconLocation === 'before' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 " style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
                <span className="inline-block align-middle font-semibold fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 pl-1 pr-2">{text}</span>
                {iconLocation === 'after' && <div className="h-3.5 w-3.5 fill-gray-800 dark:fill-gray-100 text-gray-800 dark:text-gray-100 inline-block align-middle mr-2">
                        <svg className="w-4 h-4 bg-gray-800 dark:bg-gray-100 pr-3" style={{
    maskImage: sourceUrl,
    maskRepeat: "no-repeat",
    maskPosition: "center center"
  }} />
                    </div>}
            </div>
        </>;
};

Insights consist of one or multiple metrics.
Metrics are based on Events, Ad Platforms, or a combination of both.

<Frame>
  <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/three-metrics.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=2a035eb633db60bb3f75596f8ebcbe77" alt="three-metrics" width="2209" height="1092" data-path="images/insights-dashboards/three-metrics.png" />
</Frame>

## Types of Metrics

When you click on **Add metric**, you have metrics in 4 categories.

### Popular

A small curated set of metrics from the other types that are often searched for.

<Frame>
  <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/popular-metrics.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=4b9766ff96d2bed626eb68ab70af3838" alt="img" width="625" height="203" data-path="images/insights-dashboards/popular-metrics.png" />
</Frame>

### Events

Metrics based on the Events you track with the Converge [Sources](/sources/source-concepts)

<Frame>
  <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/event-metrics.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=d972baca3ffbea7c7bd779a9ee650dda" alt="img" width="625" height="203" data-path="images/insights-dashboards/event-metrics.png" />
</Frame>

### Ad platforms

Metrics based on the Marketing Sources you connected under [Marketing Sources](/ad-platforms/overview)

<Frame>
  <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/ad-platform-metrics.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=94f7668c4a12fc7f9a5c53ea2d67f69d" alt="img" width="625" height="203" data-path="images/insights-dashboards/ad-platform-metrics.png" />
</Frame>

### Formula

A custom formula based on existing metrics.

<Frame>
  <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/formula-metrics.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=818d313afc22bf1a56e8259cb73667dc" alt="img" width="625" height="131" data-path="images/insights-dashboards/formula-metrics.png" />
</Frame>

## Aggregations

When you select Event Metrics such as **Added To Cart**, you might be looking for:

* The total number of **Added To Cart** events
* The total sessions with an **Added To Cart** event
* The **Added To Cart** conversion rate
* The Cost per **Added To Cart**
* etc.

Similarly, if you select Ad Platform Metrics such as **Clicks**, you might be looking for:

* The total number of **Clicks**
* The **CTR**
* The **CPM**
* etc.

These different ways of counting the underlying event or ad platform metric are called **Aggregations**.
Every time you pick a metric, you will need to choose an aggregation as well.

### Available Event Aggregations

<Frame>
  <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/event-aggregations.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=2910aab81ba064e2df58a087702f673c" alt="event aggregations" width="639" height="286" data-path="images/insights-dashboards/event-aggregations.png" />
</Frame>

| Aggregation                 | Description                                                                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Events**                  | Total number of times an event occurred over the chosen period                                                                            |
| **Sessions**                | Total number of sessions with the specified event occurring at least once over the chosen period                                          |
| **Profiles**                | Total number of profiles who triggered the specified event at least once over the chosen period                                           |
| **Session conversion rate** | Total number of sessions with the specified event occurring at least once divided by total sessions over the chosen period                |
| **Profile conversion rate** | Total number of profiles with the specified event occurring at least once divided by total profiles with a Session over the chosen period |
| **CPA**                     | CPA of the chosen event. Without a specific Channel filter, this is equal to the **Blended CPA**                                          |
| **ROAS**                    | ROAS of the chosen event. Without a specific Channel filter, this is equal to the **Blended ROAS**                                        |
| **Event Properties**        | Allows you to do an aggregation of a specific event property                                                                              |

### Available Ad Platform Aggregations

<Frame>
  <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/ad-platform-aggregations.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=de2e0cb0871395eba634b5439a581f63" alt="ad platform aggregations" width="639" height="286" data-path="images/insights-dashboards/ad-platform-aggregations.png" />
</Frame>

| Metric                                                          | Aggregation | Description                                |
| --------------------------------------------------------------- | ----------- | ------------------------------------------ |
| <IconText name="eye" text="Impressions" />                      | Sum         | Total number of impressions                |
|                                                                 | CPM         | Cost per impression                        |
| <IconText name="arrow-pointer" text="Clicks" />                 | Sum         | Total number of clicks                     |
|                                                                 | CTR         | Click-through rate                         |
|                                                                 | CPC         | Cost per click                             |
| <IconText name="coins" text="Spend" />                          | Sum         | Total spend                                |
| <IconText name="basket-shopping" text="Purchase Conversions" /> | Sum         | Total purchase conversions                 |
|                                                                 | CPA         | Cost per purchase conversion               |
|                                                                 | Revenue     | Conversion value of purchase conversions   |
|                                                                 | ROAS        | Return on ad spend of purchase conversions |
| <IconText name="basket-shopping" text="Custom Conversions" />   | Sum         | Total conversions                          |
|                                                                 | CPA         | Cost per conversion                        |
|                                                                 | Revenue     | Conversion value of conversions            |
|                                                                 | ROAS        | ROAS of conversions                        |

## Renaming a Metric

1. Click on the <Icon name="pencil" />-icon next to the metric you want to rename.
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/rename-icon.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=e5bd29b8ae1f22bf4db6f763de829e99" alt="" width="1012" height="122" data-path="images/insights-dashboards/rename-icon.png" />
   </Frame>
2. Give your metric a new name and click on <Icon name="check" />
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/rename-confirm-new-name.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=9889ac51264c9af10360a6aac88e8ac3" alt="" width="1131" height="260" data-path="images/insights-dashboards/rename-confirm-new-name.png" />
   </Frame>
3. Notice that in your insight, the metric is appropriately renamed
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/renamed-metric-proof.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=2e622571ef5b5d2852261d9fbf187298" alt="" width="2212" height="512" data-path="images/insights-dashboards/renamed-metric-proof.png" />
   </Frame>

## Hiding a Metric

You might want to combine some metrics in Formula Mode and only show a subset of the metrics you've used in the query.

For example, say that we want to show the **New Customer %**, which is defined as `100% * New Customers / Total Orders`.
The query would look something like this.

<Frame>
  <img src="https://mintcdn.com/converge/zWlDFBz7l1F_0PFn/images/insights-dashboards/custom-formula-new-customer-percentage.png?fit=max&auto=format&n=zWlDFBz7l1F_0PFn&q=85&s=2543a8ec938bad5bcf19b26e64996b98" alt="new customer formula" width="2212" height="934" data-path="images/insights-dashboards/custom-formula-new-customer-percentage.png" />
</Frame>

To make sure that the Insight only consists of Metric **C**, you can hide metrics A & B as follows:

1. Click on the <Icon name="eye" />-icon next to the metric you want to hide. In this example, this would be metrics A and B.
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/rename-icon.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=e5bd29b8ae1f22bf4db6f763de829e99" alt="" width="1012" height="122" data-path="images/insights-dashboards/rename-icon.png" />
   </Frame>

2. The metrics should have disappeared from the insight.
   <Frame>
     <img src="https://mintcdn.com/converge/ecGnucKsPgTlQzkL/images/insights-dashboards/hidden-custom-formula-new-customer-percentage.png?fit=max&auto=format&n=ecGnucKsPgTlQzkL&q=85&s=7b1a47ca6372c42f79f61b172d9d2eea" alt="" width="2212" height="934" data-path="images/insights-dashboards/hidden-custom-formula-new-customer-percentage.png" />
   </Frame>
