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"