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 Meta Audience Network's 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.