Revenue & metrics

AdSense reports: dimensions, metrics, saved reports, CSV exports and finding what changed

Last updated Published By the editorial team5 min6 sources

Key takeaways

  • AdSense reports combine breakdowns (dimensions such as date, site, country, platform or ad unit) with metrics (values such as page views, impressions, clicks and estimated earnings).
  • A saved report keeps the date range and settings you customized so you can reopen it later.
  • The AdSense Management API can generate reports as JSON or CSV; CSV reports default to and allow up to 1,000,000 rows.
  • Google notes that earnings up to yesterday are accurate, while more recent earnings are estimated because of possible spam or exchange rate fluctuations.
  • To find what changed, split page RPM into traffic, impressions per page view and impression RPM, then drill down by breakdown.
A Grafana monitoring dashboard with several time-series charts
Image: Grafana dashboard (2016),Linux Screenshots from USA,CC BY 2.0,via Wikimedia Commons.

AdSense reports are a table of breakdowns (dimensions such as date, site, country, platform or ad unit) and metrics (page views, impressions, clicks, estimated earnings, RPM). You pick a date range, a breakdown and the metrics, then save the configuration as a saved report. For bulk work, the AdSense Management API exports the same data as CSV, up to 1,000,000 rows per report.

What are metrics and breakdowns?

Google’s help center defines metrics as “the values that you’re measuring. For example, you can measure your account performance by looking at your earnings, number of clicks, number of page views, and so on.” Breakdowns are the dimension you group rows by.

The most complete official list of both is the AdSense Management API reference, which mirrors what the reports can show. The Dimension reference and Metric reference are summarised below.

Breakdowns you will use most

Breakdown What it groups by (official description, shortened) Typical question
Date, week, month Calendar periods When did it change?
Site (owned site domain) Domain name of a verified site Which site?
Page URL URL of the page where the ad was served (may be canonicalized) Which pages earn?
URL channel, custom channel Your own groupings of URLs or ad units Which section or template?
Ad unit Ad unit within which an ad was served Which slot?
Ad format How the ad is shown, such as “In-page”, “Anchor”, “Vignette” Which Auto ads format?
Country Region of the user viewing the ad Which markets?
Platform Platform type, such as “High-end mobile devices”, “Desktop” Which devices?
Bid type “CPC bids”, “CPM bids” for a served ad Clicks or impressions?
Buyer network Ad network that returned the winning ads Who is buying?
Targeting type “Contextual”, “Personalized”, “Run of Network” Effect of consent and personalization
Traffic source Such as “Google”, “Bing”, “Facebook”, “Other” Which referrers monetize?
Product Such as “AdSense for Content”, “AdSense for Search” Content vs search revenue

Metrics you will use most

Metric Official definition, shortened Formula
Page views Number of page views Count
Ad requests Ad units that requested ads (or search queries) Count
Matched ad requests Requests that returned at least one ad Count
Impressions Ad requests where at least one ad was downloaded and began to load Count
Clicks Clicks on a standard content ad Count
Estimated earnings Publisher earnings; recent days are estimates Currency
Page RPM Revenue per thousand page views Earnings / page views x 1,000
Impression RPM Revenue per thousand impressions Earnings / impressions x 1,000
CPC Earnings per click Earnings / clicks
Impression CTR Share of impressions resulting in a click Clicks / impressions
Coverage Ratio of requested ad units or queries to those returned Matched / requests
Active View viewable Share of measurable impressions that were viewable Viewable / measurable

For the RPM family, see RPM vs CPM vs eCPM and page RPM vs impression RPM.

How do I build and save a custom report?

  1. Open Reports in your AdSense account.
  2. Choose a date range. Avoid ending on today: recent earnings are estimates.
  3. Choose a breakdown (for example country). Add a second breakdown if you need a cross-tab (for example country by platform).
  4. Select the metrics. A good default set: page views, impressions, clicks, estimated earnings, page RPM, impression RPM.
  5. Add filters if you only want one site, one country or one ad unit.
  6. Save it. Google’s saved reports page defines a saved report as “a report with specific settings that you’ve customized and saved to use in the future,” including the date range and settings.

Some advanced metrics are only offered in a specific metric family tab. For example, Google notes that ad RPM is only available under the “Advanced” tab.

How do I export reports to CSV?

In the web interface you can download a report table. For repeatable exports, the AdSense Management API v2 has two methods:

Method Output Default and maximum rows
accounts.reports.generate JSON (ReportResult) 100,000
accounts.reports.generateCsv CSV 1,000,000

A request using the generateCsv method (OAuth scope https://www.googleapis.com/auth/adsense.readonly is enough for reading):

GET https://adsense.googleapis.com/v2/accounts/pub-0000000000000000/reports:generateCsv
    ?dateRange=LAST_30_DAYS
    &dimensions=DATE
    &dimensions=COUNTRY_CODE
    &metrics=PAGE_VIEWS
    &metrics=IMPRESSIONS
    &metrics=ESTIMATED_EARNINGS
    &metrics=PAGE_VIEWS_RPM
    &orderBy=-ESTIMATED_EARNINGS

Notes from the reference pages:

  • Account names use the format accounts/pub-[0-9]+.
  • Valid dateRange values include TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS and LAST_30_DAYS (both excluding the current day), and CUSTOM with startDate and endDate, which is the default if no range is given (ReportingDateRange).
  • orderBy sorts ascending with + or no prefix, descending with -.
  • currencyCode (ISO-4217) overrides the account currency; reportingTimeZone defaults to the account time zone.
  • Some metrics, such as web search result pages, only work in the Google time zone.

For free, scriptable analysis of your exports alongside open data, see the data tools section.

How do I find what changed?

When earnings move, work from the top down. Each step halves the search space.

  1. Pick comparable periods. Same weekdays, same length, and ideally the same period last year to remove seasonality (AdSense seasonality).
  2. Decompose page RPM. Page RPM = impression RPM x impressions per page view. Check which of page views, impressions per page view and impression RPM moved.
  3. Drill down by the most likely breakdown:
What moved First breakdowns to check Typical causes
Page views Site, page URL, traffic source Search ranking change, lost referral, tracking change
Impressions per page view Ad unit, ad format, platform Code removed, template change, consent message, Auto ads settings
Coverage (matched / requests) Ad unit, country Fewer ads available, blocking controls
Impression RPM Country, platform, bid type, targeting type Season, demand, country mix, personalization share
CTR Ad unit, platform Layout change; or a sudden spike that needs investigation
  1. Check the date breakdown for a step change on a specific day and match it to anything you deployed.
  2. Check account messages and the Policy center for restrictions that limit ad serving. See policy center explained.

Watch for traffic quality signals

A sudden CTR jump with no layout change, or a surge from one country or traffic source, deserves attention, not celebration. It can indicate invalid traffic, which is removed from finalized earnings. See invalid traffic explained.

Common mistakes

  • Comparing partial days. Today’s figures are estimates.
  • Averaging RPMs across rows. Recompute from totals: total earnings / total page views x 1,000.
  • Sorting by RPM. Low-volume rows top the list; sort by earnings.
  • Reading “Country” as your location. It is the viewer’s region.
  • Mixing currencies. Exports use the account currency unless you set currencyCode.

To see AdSense revenue next to user behaviour (sessions, landing pages, engagement), link Google Analytics 4: linking AdSense and Google Analytics.

Frequently asked questions

What is the difference between a dimension and a metric in AdSense reports?

A dimension (called a breakdown in the AdSense interface) is how rows are grouped, such as date, site, country, platform or ad unit. A metric is the value measured for each row, such as page views, impressions, clicks, estimated earnings or page RPM. Google's help center describes metrics as the values you are measuring for your account performance.

How do I export AdSense data to CSV?

Reports in the AdSense interface can be downloaded, and the AdSense Management API has a dedicated accounts.reports.generateCsv method that returns a CSV formatted ad hoc report. Through the API, CSV reports default to and are capped at 1,000,000 rows, while JSON reports from accounts.reports.generate default to and are capped at 100,000 rows.

Why do today's numbers change later?

The AdSense Management API documentation explains that earnings up to yesterday are accurate, while more recent earnings are estimated due to the possibility of spam or exchange rate fluctuations. Finalized monthly earnings can also be lower than estimates after invalid traffic is removed. Avoid drawing conclusions from the current day.

Can I see AdSense earnings per page URL?

Yes. The reporting dimensions include the page URL on which the ad was served. Google notes the URL may be a canonicalized version of the one used in the original request, and lists caveats for this breakdown. URL channels, which group URLs by pattern, are another way to report by section.

Sources

  1. Metrics · Google AdSense Help
  2. Saved reports · Google AdSense Help
  3. Metric (AdSense Management API reference) · Google for Developers
  4. Dimension (AdSense Management API reference) · Google for Developers
  5. Method: accounts.reports.generateCsv · Google for Developers
  6. ReportingDateRange · Google for Developers