How To: Distribution Partner Utilisation Analysis
When your ad delivery data is viewed in aggregate, top-line metrics like total impressions and revenue can look healthy. But distribution partners don't all perform equally — some convert inventory into confirmed revenue reliably, while others generate a disproportionate share of unrealised revenue or leave ad slots unfilled entirely.
These differences are invisible until you break the data out at the partner level. This guide shows you how.
⏱ Time to build: ~10 minutes
📦 Module: Analysis (Pivot Table + Correlation Table views)
Related pages:
Analysis Module — views, formulas, conditional formatting, metric filtering
FreeWheel Metrics Reference — Realised/Unrealised revenue definitions, event type dependencies
Metrics, Dimensions & Filters — platform-wide concepts
📋 On This Page
Section | What it covers |
|---|---|
Exploration 1: Partner Revenue Scorecard | Pivot Table with formula and conditional formatting — one row per partner, colour-coded |
Exploration 2: Unrealised Revenue Heat Map | Correlation Table showing which partner × device combinations carry the most uncertain revenue |
Turning It Into a Standing Report | Report dashboard design for week-over-week tracking |
Choosing Your Dimensions | Which partner dimension to use depending on your data source |
Prerequisites | Event types and fields required |
Exploration 1 — Partner Revenue Scorecard
Goal: One row per distribution partner, with a calculated percentage showing how much of that partner's revenue is unconfirmed — so you're not manually comparing two revenue columns.
🔧 Setup
Analysis → new exploration → Pivot Table view
Metrics:
Metric | What it tells you |
|---|---|
Ad Slots | Inventory available on each partner |
Gross Impressions | Ads that were actually delivered |
Fill Rate (%) | How much of the available inventory was used |
Gross Ad Server Revenue - Realised | Revenue that's confirmed — delivered and counted |
Gross Ad Server Revenue - Unrealised | Revenue where delivery or counting couldn't be confirmed |
eCPM | Demand quality — value per thousand impressions |
Gross Invalid Impressions | Invalid traffic volume per partner |
Dimensions (in this order):
Your primary partner dimension (see Choosing Your Dimensions below)
Device Type
FW: Ad Unit Type (FreeWheel) or an equivalent position/format dimension
Date range: Last 14 days
Order by: Gross Ad Server Revenue - Realised DESC
➕ Add a formula: Unrealised Revenue %
Click the formula icon and create:
(Gross Ad Server Revenue - Unrealised / (Gross Ad Server Revenue - Realised + Gross Ad Server Revenue - Unrealised)) * 100
This produces a single percentage per partner row. At a glance: a partner at 10–15% is healthy. A partner at 40%+ has a significant confirmation gap worth investigating.
🎨 Add conditional formatting
Apply conditional formatting to make problem areas stand out without scanning numbers:
Rule | Colour | Why |
|---|---|---|
Unrealised Revenue % above 30% | 🔴 Red | Revenue confirmation problem — ads served but beacons not completing |
Fill Rate (%) below 70% | 🟠 Amber | Unfilled inventory — ad slots available but nothing served into them |
🔍 Reading the results
At the collapsed level, each row is a distribution partner ranked by confirmed revenue. The Unrealised % formula and colour coding immediately surface which partners warrant attention.
Expand any partner row to drill into Device Type → Ad Unit Type. The issue is rarely the partner overall — it's typically concentrated on a specific device or ad position within that partner.
💡 Tip: Use the quick-filter button (funnel icon next to each row) to instantly filter the entire exploration to a specific partner or device slice for deeper analysis.
🏷 Filtering by inventory type
If your account has custom dimensions that segment inventory (e.g., FAST vs Live Linear vs On Demand), add these as exploration-level filters before running the pivot. This lets you run the same scorecard across different content types to see whether partner performance varies.
Exploration 2 — Unrealised Revenue Heat Map
Goal: See exactly where unrealised revenue concentrates across two dimensions at once — without expanding rows or scrolling through a table.
🔧 Setup
Analysis → new exploration → Correlation Table view
Metric: Gross Ad Server Revenue - Unrealised
Dimensions:
Rows: Your primary partner dimension
Columns: Device Type
This renders as a visual grid — partners down one axis, device types across the other, with cells sized and coloured by unrealised revenue. The hot spots are immediately visible.
🔄 Variations
Swap Device Type for other dimensions depending on what you're investigating:
Swap in | What it reveals |
|---|---|
FW: Ad Unit Type | Whether the gap is in pre-roll, mid-roll, or post-roll |
FW: Sales Channel Type | Whether direct or programmatic inventory drives the gap |
Territory | Geographic concentration of unrealised revenue |
📊 Turning It Into a Standing Report
The explorations above are ad-hoc investigation tools. Once you've identified findings worth tracking, build a Report dashboard to monitor the same metrics over time.
Widget Type | Configuration | What it shows |
|---|---|---|
Timeseries | Realised + Unrealised revenue by partner, daily | Revenue trends per partner — are gaps improving or widening? |
Multi Column | Fill Rate, eCPM, Unrealised % (calculated) by partner | Partner scorecard snapshot for the current period |
Horizontal Bar | Unrealised Revenue by partner | Visual ranking of where the most uncertain revenue sits |
Correlation Table | Unrealised Revenue × Partner × Device Type | Standing heat map, updated with each report refresh |
💡 Tip: Set date range overrides per widget — the timeseries might show 30 days while the scorecard shows 7. Each widget can also override its data source independently if you need to combine FreeWheel and SpringServe data in the same report.
Contact your account team if you'd like help building this.
🧭 Choosing Your Dimensions
The right partner dimension depends on your data source and how your distribution relationships are structured.
Data Source | Dimension | What It Represents |
|---|---|---|
FreeWheel | FW: Distribution Partner | Distribution partner in FreeWheel's value chain |
FreeWheel | FW: Endpoint | Distribution endpoint (e.g., Samsung TV Plus, Roku Channel) — more granular |
SpringServe | SS: Partner | SpringServe supply/demand partner |
⚠️ Cross-data-source note: Revenue metrics (Realised/Unrealised) are derived from FreeWheel IMPRESSION events. If your primary partner dimension is a SpringServe dimension (SS: Partner), verify that revenue metrics populate against it in your account. If they don't, run separate explorations per data source.
✅ Prerequisites
Requirement | Why |
|---|---|
IMPRESSION event type | Gross Impressions, Realised/Unrealised Revenue, eCPM, Gross Invalid Impressions |
AD AVAIL event type | Ad Slots, Fill Rate |
SERVER RESPONSE event type (optional) | FW: Buyer Response — adds demand-side visibility |
Partner dimension fields enabled |
|
Revenue fields enabled | Powers the Realised/Unrealised conditional metrics |
If any of these aren't active in your account, contact your account team. See the Getting Started: FreeWheel Setup Guide for configuration details.