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 theAccounts.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: |
AD_UNIT_CODE |
Ad unit ID
The code of an ad unit. This value is not necessarily unique across ad clients. Example: |
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: |
AD_UNIT_SIZE_NAME |
Format (Name)
The format name of an ad unit. Examples: |
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: |
APP_ID |
Google Play ID / iOS Bundle ID
The Google Play ID (prefixed with a Examples: |
APP_PLATFORM |
Platform
The app platform. Examples: |
|
Bid type (Code)
The type of a bid. Examples: |
BID_TYPE_NAME |
Bid type (Name)
A bid type name. Examples: |
|
Country (Code)
The CLDR Region Code. Examples: |
|
Country (Name)
Region name. Examples: |
|
Date
A date in |
MONTH |
Month
A month in |
PLATFORM_TYPE_CODE |
Device (Code)
The code of a platform type. Examples: |
PLATFORM_TYPE_NAME |
Device (Name)
The name of a platform type. Examples: |
PRODUCT_NAME |
Product
The name of a product. Examples: |
WEEK |
Week
The date of the first day of a week in |
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"