Skip to main content

How to build a custom report

The Reports page lets you build fully customised reports by combining dimensions (how to group the data) and metrics (what numbers to show). Unlike the Performance page, which shows predefined views, the reporting system lets you answer specific questions — any date range, any combination of filters, any level of granularity. Reports can be saved for future use or scheduled to run automatically.

Step 1 — Name your report and set the date range​

Give the report a descriptive name so you can find it in your Saved Reports list. Use the date picker to select any date range. The date range can always be changed when you re-run a saved report.

Step 2 — Choose your dimensions​

Dimensions are the categories your report groups data by — think of them as the row headers of a spreadsheet. Choosing the right dimensions depends on the question you are trying to answer:

  • To see daily revenue broken down by site: select Date + Domain
  • To compare how different ad formats perform: select Product (or Media Type for a higher-level view)
  • To understand your mobile vs desktop eCPM gap: select Device
  • To identify which countries are generating the most impressions: select Country
  • To analyse a specific PMP deal: select Deal ID or Deal Name

You can combine multiple dimensions — for example, Date + Domain + Device gives you daily earnings per site per device type.

Step 3 — Choose your metrics​

Metrics are the numbers shown for each dimension row. Impressions + Earnings + eCPM together give you the complete revenue picture for any dimension combination. Add Viewable Impressions if you want to calculate viewability rates. Add the Video metrics (First Quartile through Completes) if you are analysing video performance.

Step 4 — Add filters (optional)​

Filters narrow your results without changing the dimensions or metrics. You can filter by dimension values — for example, show only a specific domain or product — or by metric thresholds. Filters are useful when you want to focus a report on a specific subset of your inventory.

Step 5 — Select currency and run​

Choose EUR or USD as your report currency, then click Run to generate the preview. When the results look right:

  • Save — stores the report configuration for future use
  • Save and run — stores it and keeps the current results
  • Add a recurring report — schedules it to run automatically

Exporting your report​

The Export button below the preview table lets you download the report as a CSV file or export it directly to Google Drive/Sheets.

Practical tips
  • Start with a short date range (7 days) and a single dimension when building a new report type. Once the output looks right, extend the date range or add dimensions.
  • Saved reports remember your dimension and metric selections but not the date range — you can re-run them for any period without rebuilding from scratch.
  • If you are trying to diagnose a revenue drop, a report combining Date + Domain + Product with Impressions, Earnings, and eCPM over the last 14 days is usually the most efficient starting point.

See also: Available report dimensions · Video completion metrics explained