> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/your-workspace/metrics-interface.md).

# Metrics Interface

The workspace surface for monthly performance — 3 sub-pages (Search Performance, Site Analytics, Social Performance) with stat cards, deltas, AI summaries, and trend charts. Read-only — the data is ge

> **The workspace home for performance — open the page, read the cards, read the bullets.**

The Metrics Interface is the workspace surface where the brand reads monthly performance. Data lands here from the [Reporting Agents](/docs/reporting-agents/growth.md) — the brand never enters numbers, never imports CSVs, never reconciles spreadsheets. The Interface opens, the latest month's data renders automatically, and the AI summary for each channel sits alongside its metrics.

## How It Works

The Interface ships as part of the workspace template under the name **Reports**. It has 3 sub-pages in the side nav, one per data source:

* **Search Performance** — Google Search Console metrics: Clicks, Impressions, CTR, Avg Position.
* **Site Analytics** — Google Analytics 4 metrics: Sessions, Engaged Sessions, Avg Session Duration, Events Per Session.
* **Social Performance** — per-platform follower count and engagement rate across every connected channel.

Each sub-page has the same reading order: hero stat cards with month-on-month deltas, a trend chart, and the AI summary for that channel and month.

The data is read-only at this surface. Edits to the metric values would be meaningless — the underlying data is recomputed monthly by the Reporting Agents from the platform APIs.

## What You See

![Reports Interface — Social Performance page with follower and engagement cards per active channel, month-on-month deltas in percentage points, and the Followers Trend log-scale chart](https://2935174940-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9WhvO5Y38RJO9oNIdz9G%2Fuploads%2Fgit-blob-2d2b7e04a372068cc7681d92f41c5b9d9e3aef9e%2Finterface-reports-social-performance.png?alt=media)

## What You Get

* Single workspace surface for every channel's monthly performance — no juggling separate platform UIs.
* Three sub-pages, one per data source — Search Performance, Site Analytics, Social Performance.
* AI summary per channel per month — 3 plain-English bullets describing what happened.
* Trend chart per sub-page — direction visible without analysis.
* Inactive social platforms render as placeholder cards — no clutter, but the layout stays consistent month to month.
* Read-only — the brand never accidentally edits a number that gets overwritten on the next cron.

## How You Use It

* **Read the month** — open the Interface. The latest month renders by default on every sub-page. Scan the AI summary alongside the stat cards.
* **Compare across channels** — click through the 3 sub-pages in the side nav. Same reading order each page.
* **Check direction** — every metric shows a delta vs prior month, colour-coded green for better, red for worse. Avg Position is inverted (lower is better, so the colour follows the right direction). Engagement Rate deltas show as percentage points (pp), not percentages.
* **Spot a trend** — scroll to the trend chart on any sub-page. If direction is regressing, the chart makes it obvious before any human assembles a report.
