Stay organized with collections
Save and categorize content based on your preferences.
The AdSense Management API reporting system exposes the flexibility and customization capabilities of the AdSense website. Reports are generated by specifying a list of dimensions and metrics.
Dimensions
Each time AdSense displays an ad, every event associated with that ad is logged with a set of attributes: date, country, channel, ad unit, etc. These attributes are called dimensions.
Dimensions are used for grouping purposes in reports.
Metrics
When a report is requested, the logged events are added together according to the chosen dimensions. Metrics represent the different measurements you can make on that data.
Some metrics are calculated, instead of being measured directly.
Using multiple dimensions wisely
The generated report consists of a series of rows, each having one or more fields. Adding a new metric to a report produces a new column but adding a dimension multiplies the number of rows.
For example, a report with DATE as a dimension will generate a set of rows, one row for each day with activity. Adding a new dimension, like CUSTOM_CHANNEL_NAME, will generate a row per day and per existing channel. As a guideline it's fine to use as many metrics as you like, but try not to use more than two dimensions per report.
Incompatible dimensions and metrics
There are some metrics and dimensions that cannot be combined in a single report. For example, a conflict will arise when trying to fetch URL and custom channels at the same time. This limitation is the same as in the AdSense website (Performance reports tab).
[null,null,["Last updated 2025-03-17 UTC."],[[["\u003cp\u003eThe AdSense Management API reporting system mirrors the AdSense website, allowing for flexible and customizable reports by specifying dimensions and metrics.\u003c/p\u003e\n"],["\u003cp\u003eDimensions, like date or platform type, group data for analysis, while metrics, such as earnings or clicks, measure performance.\u003c/p\u003e\n"],["\u003cp\u003eWhile you can use multiple metrics freely, it's recommended to limit the use of dimensions to two per report to avoid excessive data complexity.\u003c/p\u003e\n"],["\u003cp\u003eSome dimension and metric combinations are incompatible and cannot be used together within the same report, similar to limitations in the AdSense website's Performance reports.\u003c/p\u003e\n"],["\u003cp\u003eYou can further explore handling results, choosing the right dimensions, specifying date ranges, and reviewing a comprehensive list of available metrics and dimensions through the provided links.\u003c/p\u003e\n"]]],["The AdSense Management API allows customizable reports through dimensions and metrics. Dimensions, like `DATE` or `PLATFORM_TYPE_NAME`, group ad event data by attributes. Metrics, such as `ESTIMATED_EARNINGS` or `CLICKS`, measure data based on these groupings; some are calculated, like `COST_PER_CLICK`. Adding dimensions increases report rows, so use sparingly. While metrics can be combined freely, the number of dimensions has to be minimal, as some dimensions and metrics are incompatible.\n"],null,["# Dimensions and Metrics\n\nThe AdSense Management API reporting system exposes the flexibility and customization capabilities of the AdSense website. Reports are generated by specifying a list of dimensions and metrics.\n\nDimensions\n----------\n\nEach time AdSense displays an ad, every event associated with that ad is logged with a set of attributes: date, country, channel, ad unit, etc. These attributes are called dimensions.\n\nDimensions are used for grouping purposes in reports.\n| **Some examples:**\n|\n| `DATE`\n| : Groups data in individual days.\n|\n| `MONTH`\n| : Groups data in months.\n|\n| `PLATFORM_TYPE_NAME`\n| : Groups data into platform types, such as `\"Desktop\"` or `\"Tablet\"`\n\nMetrics\n-------\n\nWhen a report is requested, the logged events are added together according to the chosen dimensions. Metrics represent the different measurements you can make on that data.\n| **Some examples:**\n|\n| `ESTIMATED_EARNINGS`\n| : Measures how much the publisher earned.\n|\n| `CLICKS`\n| : Measures how many times ads were clicked on the publisher's property.\n\nSome metrics are calculated, instead of being measured directly.\n| **Some examples:**\n|\n| `COST_PER_CLICK`\n| : Measures how much the publisher earns each time a user clicks on their ad.\n|\n| `AD_REQUESTS_RPM`\n| : Measures the revenue per thousand ad requests.\n\nUsing multiple dimensions wisely\n--------------------------------\n\nThe generated report consists of a series of rows, each having one or more fields. Adding a new metric to a report produces a new column but adding a dimension multiplies the number of rows.\n\nFor example, a report with `DATE` as a dimension will generate a set of rows, one row for each day with activity. Adding a new dimension, like `CUSTOM_CHANNEL_NAME`, will generate a row per day and per existing channel. As a guideline it's fine to use as many metrics as you like, but try not to use more than two dimensions per report.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nIncompatible dimensions and metrics\n-----------------------------------\n\nThere are some metrics and dimensions that cannot be combined in a single report. For example, a conflict will arise when trying to fetch URL and custom channels at the same time. This limitation is the same as in the AdSense website (Performance reports tab).\n\nNext steps\n----------\n\n- [Handling the Results](/adsense/management/reporting/handling_results)\n- [Using the Right Dimension](/adsense/management/reporting/right_dimension)\n- [Specifying a Date Range](/adsense/management/reporting/date_ranges)\n- [List of Metrics and Dimensions](/adsense/management/metrics-dimensions)"]]
