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

# Ad Performance

> Read-only Roblox Sponsored Campaigns reporting, bridged securely through a browser extension

Ad Performance brings your Roblox **Sponsored Campaigns** metrics into RoLearn's
Monitor surface, so ad spend and results sit alongside your CCU and revenue data.

<Note>
  Ad Performance is an **Enterprise** feature. The dashboard is read-only — v1
  reports on campaigns; it does not create or stop them.
</Note>

## Why a browser extension

Roblox's `adconfiguration.roblox.com` Sponsored-Campaigns endpoints are
**cookie-only** — they authenticate with your `.ROBLOSECURITY` cookie, which is
`HttpOnly` and cannot be read by any script. So a thin RoLearn browser extension
runs those calls **inside your own logged-in browser** and forwards only the
resulting metric JSON to RoLearn.

<Warning>
  RoLearn never sees, stores, or transmits your Roblox cookie. The browser
  attaches it automatically to roblox.com requests; the extension reads only the
  returned campaign metrics.
</Warning>

## Setup

<Steps>
  <Step title="Pair the extension">
    In the RoLearn web app (Enterprise), pair the extension. This issues a
    per-user ads token (`rk_live_…` with an ads scope) that the extension uses to
    push data — `POST /api/ads/extension/pair`.
  </Step>

  <Step title="Let it discover your campaigns">
    The extension reads your campaign catalog and pushes it
    (`POST /api/ads/catalog`). You then choose which campaigns (or all) to track.
  </Step>

  <Step title="Read the dashboard">
    The extension forwards daily metrics (`POST /api/ads/metrics`); the Monitor
    dashboard reads them via `GET /api/ads/performance`.
  </Step>
</Steps>

The scope is **per-user** (not per-team), and the pairing / dashboard endpoints
are gated to the Enterprise plan.