Reporting

The AdMob API has the ability to generate the following reports:

Network report
The network report provides data on AdMob's performance and generates the same data found in the AdMob UI network report.
Mediation report
The mediation report includes third-party performance. If you are unfamiliar with the mediation report, take a look at the Help Center article.

Dimensions

In reports, dimensions are used for grouping purposes, and if no dimensions are specified, the report returns a single row of the requested metrics for the entire account. Each report has various dimensions, see network report and mediation report dimensions for more details.

Examples:

Report type Dimension Description
Mediation report AD_SOURCE The unique ID of the ad source (for example, "5450213213286189855" and "AdMob Network" as label value).
Network report AD_TYPE Type of the ad (for example, "text" or "image").

Metrics

Metrics represent the different measurements you can make on that data. When a report is requested, the metrics are calculated according to the chosen dimensions. A report must include at least one metric. Each report has various metrics, see network report and mediation report metrics for more details.

Examples:

Report type Metric Description
Mediation report OBSERVED_ECPM The third-party ad network's estimated average eCPM.
Network report SHOW_RATE The ratio of ads that are displayed over ads that are returned, defined as impressions / matched requests. The value is a double precision (approximate) decimal value.

Filters

Filters allow you to restrict the rows that get included in the report by specifying a dimension to filter on and the filter expression.

For example, the filter below can be applied to a mediation report to view Facebook's network performance. Take a look at the complete list of ad sources that can be viewed in the mediation report.

Dimension Filter Filter Expression Description
AD_SOURCE matchesAny = {10568273599589928883} Filters report rows based on ad source.

Reduce report limits

Reports have a limit of 100,000 rows. When a report with over 100,000 rows is requested, the report will be truncated and the first 100,000 rows will be returned. See the report response body for additional information on the response format.

To ensure you are receiving all rows, try reducing the size of the report by:

  • Reducing the date range in the request.
  • Reducing the number of dimensions as they act as a multiplier. Adding a dimension multiplies the number of rows, whereas adding a new metric to a report produces a new column.