Reporting

You can run reports for your new AdMob account using the AdSense Management API.

Concepts

Here are some important concepts as they apply to AdMob:

Account

An AdSense account has an ID of the format pub-xxxxxxxxxxxxxxxx. You need this ID to access most endpoints in the AdSense Management API reference. (In the AdMob UI, the Publisher ID can be found under Account information on the Settings page.)

Ad Client

An ad client specifies a relationship between an account and a product. Your new AdMob account comes with an ad client ID in the format ca-app-pub-xxxxxxxxxxxxxxxx (you can retrieve your ad clients using the Accounts.adclients.list call in the AdSense Management API). Use this ad client ID for all your AdMob reporting needs.

Ad Unit

An ad unit specifies an individual placeholder for ads. Change it to ca-app-pub-xxxxxxxxxxxxxxxx:nnnnnnnnnn for use in the AdSense Management API. (In the AdMob UI, you can find the ad unit ID under Apps > your app > Ad units > Ad unit ID.)

You can also retrieve your ad units by using the Accounts.adunits.list call in the API.

There are plenty of samples you can check out in the AdSense Management API documentation.

Dimensions

The following dimensions are specific to AdMob:

AdSense API and corresponding AdMob dimension
AD_CLIENT_ID	Publisher ID The ID of an ad client. Example: ca-app-pub-1234567890123456.
AD_UNIT_CODE	Ad unit ID The code of an ad unit. This value is not necessarily unique across ad clients. Example: 1234567890.
AD_UNIT_NAME	Ad unit name The name of an ad unit. Example: 'your banner name'.
AD_UNIT_SIZE_CODE	Format (Code) The format of an ad unit. Examples: banner, native.
AD_UNIT_SIZE_NAME	Format (Name) The format name of an ad unit. Examples: Banner, Native advanced.
APP_NAME	App The name of the app. This field is truncated to 80 characters and won't be updated even if the app name changes in the app store. Examples: Line Up, Flood-It!.
APP_ID	Google Play ID / iOS Bundle ID The Google Play ID (prefixed with a 2:) or iOS bundle ID (prefixed with a 1:) of an app. Examples: 2:com.labpixies.lineup, 1:476954712.
APP_PLATFORM	Platform The app platform. Examples: Android, iOS.
BID_TYPE_CODE	Bid type (Code) The type of a bid. Examples: cpc, cpm.
BID_TYPE_NAME	Bid type (Name) A bid type name. Examples: CPC bids, CPM bids.
COUNTRY_CODE	Country (Code) The CLDR Region Code. Examples: US, FR.
COUNTRY_NAME	Country (Name) Region name. Examples: United States, France.
DATE	Date A date in YYYYMMDD format.
MONTH	Month A month in YYYYMM format.
PLATFORM_TYPE_CODE	Device (Code) The code of a platform type. Examples: HighEndMobile, Tablet.
PLATFORM_TYPE_NAME	Device (Name) The name of a platform type. Examples: High-end mobile devices, Tablets.
PRODUCT_NAME	Product The name of a product. Examples: AdMob (Mobile Applications), AdSense for Search.
WEEK	Week The date of the first day of a week in YYYYMMDD format.

Metrics

The following metrics are specific to AdMob:

AdSense API and corresponding AdMob metrics
EARNINGS	AdMob Network Estimated Earnings Your earnings accrued so far, based on Pacific Time (PT). This amount is an estimate that is subject to change when your earnings are verified for accuracy at the end of every month.
REACHED_AD_REQUESTS	AdMob Network Requests The total number of your app's requests that resulted in actual ad serving requests being sent. Ad requests that are filtered by certain platform features, such as frequency capping and audience targeting, will not be counted here.
MATCHED_REACHED_AD_REQUESTS	Matched Requests The number of times an ad was served in response to a request from your app.
VIEWED_IMPRESSIONS	Impressions The total number of ads shown to users of an app.
CLICKS	Clicks The number of times a user clicks an ad.
REACHED_AD_REQUESTS_MATCH_RATE	Match Rate The percentage of ad requests that were filled with an ad. This value is calculated using Matched requests / AdMob Network requests. Example: If an app's Matched requests are equal to 40 and the total AdMob Network requests for the app is 50, then the app's Match rate will be 80%.
REACHED_AD_REQUESTS_SHOW_RATE	Show Rate Percentage of returned ads that were displayed in the app to the user. Calculated using Impressions / Matched requests. Example: If the total number of Matched requests is 80, but your app only shows 60 of these, then the app's Show rate will be 75%.

Tips

If you want to see only your AdMob earnings, make sure you set a filter with your AdMob account ID. For example:

filter: "AD_CLIENT_ID==ca-app-pub-xxxxxxxxxxxxxxxx"

Similarly, if you want to see your earnings for a single app, you can set a filter with your app ID. For example:

filter: "APP_ID==2:com.labpixies.lineup"