> For the complete documentation index, see [llms.txt](https://docs.bloomanalytics.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bloomanalytics.io/my-metrics/platform-metrics.md).

# Platform Metrics

Platform Metrics surfaces each connected ad platform's own reported conversion value, ad spend, and ROAS directly from its API, alongside GA4.

### What is Platform Metrics?

Platform Metrics surfaces each connected ad platform's own reported metrics, conversion value, ad spend, and ROAS, directly from that platform's API. It replicates the same three variables across Facebook, Google, Pinterest, Snapchat, TikTok, and also pulls engagement data from Google Analytics 4. It is built for media buyers who want to see platform native numbers without logging into each ad platform separately, and for merchants who want to compare a platform's self reported ROAS against Bloom's own blended MER and aMER metrics.

### How it Works

The components map channel specific telemetry variables directly from the layout framework, replicated across each native ad platform integration. Each platform (Facebook, Google, Pinterest, Snapchat, TikTok) reports its own Conversion Value, ROAS (API), and Ad Spend, exactly as that platform's API returns it. GA4 contributes a separate set of traffic and engagement metrics from the Google Analytics 4 API.

**How ROAS (API) is Calculated**

For every ad platform, ROAS (API) is that platform's Conversion Value divided by its Ad Spend, as returned by the platform's own API. Bloom does not recalculate it; the number is the platform's self-reported figure.

### Data Available

**Facebook Metrics**

| **Metric**                | **Description**                                                                                                                                                                                                                   |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Facebook Conversion Value | The total monetary value generated from conversions attributed to the Facebook ads. Helps in evaluating the effectiveness of advertising campaigns in terms of the actual revenue they bring to the business.                     |
| Facebook ROAS (API)       | It measures the revenue generated for every dollar spent on Facebook advertising. It helps in optimizing the advertising budget and evaluating the effectiveness of the campaigns. Facebook Conversion Value / Facebook Ad Spend. |
| Facebook Ad Spend         | It refers to the total amount of money allocated to advertising on the Facebook platform, including ads shown on Facebook to reach targeted audiences and achieve specific marketing objectives.                                  |

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2Fja5Sf8SKEnHfSnE3zfOz%2Fimage.png?alt=media&amp;token=e9cc2737-1d62-40f4-8bde-b712b3adfc72" alt="Facebook Metrics in Bloom"><figcaption></figcaption></figure>

**Google Metrics**

| **Metric**              | **Description**                                                                                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Google Conversion Value | This refers to the total monetary value generated from conversions resulting from the Google Ads campaigns.                                                                  |
| Google ROAS (API)       | It is used to evaluate the effectiveness of your advertising campaigns in generating revenue relative to the amount spent on ads. Google Conversion Value / Google Ad Spend. |
| Google Ad Spend         | Track ad cost and spend from each Google ad campaign and other ad metrics.                                                                                                   |

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2FN5pg2ur823pEpFclW5Wa%2Fimage.png?alt=media&amp;token=5dd400df-c9b2-4e68-9e53-275e3c61c3d0" alt="Google Metrics in Bloom"><figcaption></figcaption></figure>

**Pinterest Metrics**

| **Metric**                 | **Description**                                                                                                                                                                                                               |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pinterest Conversion Value | Total revenue generated from conversions attributed to Pinterest advertising or organic activity. Helps store owners understand the monetary impact of their Pinterest efforts, whether from paid campaigns or organic reach. |
| Pinterest ROAS (API)       | It refers to the use of Pinterest's API to calculate and track the Return on Ad Spend (ROAS) from Pinterest ad campaigns. Pinterest Conversion Value / Pinterest Ad Spend.                                                    |
| Pinterest Ad Spend         | It refers to the total amount of money spent on running paid advertising campaigns on Pinterest.                                                                                                                              |

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2FakbT1MXO5axQBWiNmYaw%2Fimage.png?alt=media&amp;token=328c8af0-03d0-4361-ad0f-5af50ef7867a" alt="Pinterest Metrics in Bloom"><figcaption></figcaption></figure>

**Snapchat Metrics**

| **Metric**                | **Description**                                                                                                                                                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Snapchat Conversion Value | Refers to the total monetary value generated from conversions resulting from your Snapchat advertising campaigns.                                                                                                                |
| Snapchat ROAS (API)       | It measures the revenue generated from Snapchat advertising campaigns relative to the ad spend, specifically accessed through Snapchat's API (Application Programming Interface). Snapchat Conversion Value / Snapchat Ad Spend. |
| Snapchat Ad Spend         | The total amount of money spent on advertising campaigns run through Snapchat that aim to drive traffic and sales to the Shopify store.                                                                                          |

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2FkvE3a5b7Kec3305jbySX%2Fimage.png?alt=media&amp;token=2421c064-f3b0-43fc-9376-760aefea6483" alt="Snapchat Metrics in Bloom"><figcaption></figcaption></figure>

**TikTok Metrics**

| **Metric**              | **Description**                                                                                                                                                                                                                                  |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| TikTok Conversion Value | The total revenue generated from users who completed a desired action after interacting with your TikTok ads. It helps in understanding the financial impact of advertising efforts and in assessing the overall effectiveness in driving sales. |
| TikTok ROAS (API)       | It refers to the metric that calculates the revenue generated for every dollar spent on TikTok advertising, specifically when using the TikTok Ads API to retrieve performance data. Tiktok Conversion Value / Tiktok Ad Spend.                  |
| TikTok Ad Spend         | It refers to the total amount of money invested in advertising campaigns on the TikTok platform. It helps to assess the effectiveness of marketing strategies and determine the return on investment (ROI) from TikTok ads.                      |

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2FKLxKNdEymV98U6aHtNkT%2Fimage.png?alt=media&amp;token=5e923152-e66f-47b0-b2a8-43f7b9d2c8d5" alt="TikTok Metrics in Bloom"><figcaption></figcaption></figure>

**GA4 Metrics**

<table data-header-hidden data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Metric</strong></td><td><strong>Description</strong></td></tr><tr><td>Total Users</td><td>The total number of people who visited your site or app in the specified date range.</td></tr><tr><td>New Sessions</td><td>A session is a group of user interactions with your website or app that take place within a given time frame.</td></tr><tr><td>Returning Sessions</td><td>The number of people who have visited your site or app before in the specified date range.</td></tr><tr><td>Sessions</td><td>In Analytics, a session initiates when a user either opens your app in the foreground or views a page or screen and no session is currently active, for example, their previous session has timed out.</td></tr><tr><td>Bounce Rate %</td><td>The percentage of sessions that were not engaged.</td></tr><tr><td>Engaged Sessions Rate %</td><td>The percentage of engaged sessions on your website or mobile app.</td></tr><tr><td>Total Duration in minutes</td><td>Total Duration (often expressed as Average Session Duration) is the total amount of time (in seconds or minutes) users spend on your site or app.</td></tr><tr><td>Page Views per Session</td><td>In Google Analytics 4 (GA4), Views per Session is the average number of web pages or app screens a user views during a single visit.</td></tr><tr><td>Adds to Cart Rate %</td><td>The Add-to-Cart Rate in Google Analytics 4 (GA4) represents the percentage of users or item views that lead to an item being added to the shopping cart.</td></tr></tbody></table>

<figure><img src="https://749049708-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9Cj862knfGNqzzPFauD6%2Fuploads%2FQNk1LWKX6knzdAWHNqXc%2Fimage.png?alt=media&amp;token=88b95fee-ed04-44b6-a88c-958e7de8b131" alt="GA4 Metrics in Bloom"><figcaption></figcaption></figure>

### How to Use it

1. Open a channel's Platform Metrics view to see its self-reported ROAS (API).
2. Cross-reference that number against the blended MER shown in Marketing Metrics to see whether the channel's strong platform-reported number holds up once all channels and margin are factored in.