Dimensions¶
You can use dimensions to request additional entity metadata that is not provided by default in the cube tables.
If you want attributes from a certain dimension to be included in the report, then you must include the dimension’s ID field in the field list. For example, if you would like to include “Ad Landing URL” in a report from the performance_stats cube, then the “Ad ID” must also be requested along with the “Ad Landing URL” field.
The following dimensions are available for querying:
Advertiser
Name |
Description |
Type |
---|---|---|
Advertiser ID |
The ID of the advertiser account. |
long |
Advertiser Name |
The name of the advertiser account. |
string |
Advertiser Timezone |
The advertiser account timezone, e.g., America/New_York. |
enum |
Advertiser Currency |
Advertiser currency, e.g., USD |
string |
Advertiser Tracking URL |
Represents the optional template at the Advertiser level to specify additional tracking parameters or redirects. New in the v3 Native & Search API. |
string |
Campaign
Name |
Description |
Type |
---|---|---|
Advertiser ID |
The ID of the account associated with the campaign. |
long |
Campaign ID |
The ID of the campaign. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Campaign Name |
The name of the campaign. |
string |
Campaign Bid Strategy |
Represents the bidding strategy specified at the campaign level. |
string |
Campaign Start Date |
The start date of the campaign. |
yyyy-mm-dd format |
Campaign End Date |
The end date of the campaign. |
yyyy-mm-dd format |
Campaign Status |
The status of the campaign (ACTIVE, PAUSED, DELETED). |
enum |
Budget |
The lifetime budget at the campaign level. |
BigDecimal |
Budget Type |
The type of budget. |
enum |
Campaign Objective |
The objective of the campaign as defined in the campaign settings. |
string |
Campaign Tracking URL |
Represents the optional template at the Campaign level to specify additional tracking parameters or redirects. New in the v3 Native & Search API. |
string |
Campaign Custom Parameters |
Represents the optional ValueTrack parameters at the Campaign level to which you can assign your own IDs. New in the v3 Native & Search API. |
string |
Conversion Counting |
The latest setting of how conversions are counted for the campaign (ALL_PER_INTERACTION, ONE_PER_INTERACTION). |
string |
Ad Group
Name |
Description |
Type |
---|---|---|
Advertiser ID |
The ID of the account associated with the ad group. |
long |
Campaign ID |
The ID of the campaign associated with the ad group. |
long |
Ad Group ID |
The ID of the ad group. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Ad Group Name |
The name of the ad group. |
string |
Ad Group Status |
The status of the ad group (ACTIVE, PAUSED, DELETED). |
enum |
Ad Group Tracking URL |
Represents the optional template at the Ad Group level to specify additional additional tracking parameters or redirects. New in the v3 Native & Search API. |
string |
Campaign Custom Parameters |
Represents the optional ValueTrack parameters at the Ad Group level to which you can assign your own IDs. New in the v3 Native & Search API. |
string |
Ad
Name |
Description |
Type |
---|---|---|
Advertiser ID |
The ID of the account associated with the ad. |
long |
Campaign ID |
The ID of the campaign associated with the ad. |
long |
Ad Group ID |
The ID of the ad group associated with the ad. |
long |
Ad ID |
The ID of the ad. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Ad Title |
The title of the ad that will be shown to the user. Limited to 50 characters. |
string |
Ad Title 2 |
The second line title of the ad that will be shown to the user. The limit is 30 characters of text. When used with Ad Title, then the Ad Title attribute is also limited to 30 characters of text. Supported for both v1 and v2 API calls. |
string |
Ad Description |
The description of the ad that will be shown to the user. This field supports keyword insertion. Max length is 150 characters. |
string |
Ad SponsoredBy |
The string shown against the sponsored by label in the ad. |
string |
Ad Landing URL |
The URL where the user was redirected to upon clicking the ad. |
string |
Ad Display URL |
The user-friendly URL that is displayed to the user. |
string |
Ad Image URL |
The URL of the (uploaded thumbnail) image. |
string |
Ad Final URL |
Represents the final URL for the Ad that a user ultimately sees in the browser bar after clicking an ad. New in the v3 Native & Search API. |
string |
Ad Mobile Final URL |
Represents the final mobile URL for the Ad after all cross domain redirects. New in the v3 Native & Search API. |
string |
Ad Tracking URL |
Represents the optional template at the Ad level to specify additional tracking parameters or redirects. New in the v3 Native & Search API. |
string |
Ad Custom Parameters |
Represents the optional the optional ValueTrack parameters at the Ad level to which you can assign your own IDs. New in the v3 Native & Search API. |
string |
Keyword
Name |
Description |
Type |
---|---|---|
Keyword ID |
The id of the keyword. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Keyword Value |
The keyword text. |
string |
Keyword Match Type |
The keyword match type. |
string |
Keyword Status |
The keyword status. |
string |
Keyword Param 1 |
The param1 value for the keyword. |
string |
Keyword Landing URL |
The keyword landing URL. |
string |
Keyword Final URL |
Represents the final URL for the Keyword that a user ultimately sees in the browser bar after clicking an ad. New in the v3 Native & Search API. |
string |
Keyword Mobile Final URL |
Represents the final mobile URL for the Keyword after all cross domain redirects. New in the v3 Native & Search API. |
string |
Keyword Tracking URL |
Represents the optional template at the Keyword level to specify additional tracking parameters or redirects. New in the v3 Native & Search API. |
string |
Keyword Custom Parameters |
Represents the optional ValueTrack parameters at the Keyword level to which you can assign your own IDs. New in the v3 Native & Search API. |
string |
Ad Extension
Name |
Description |
Type |
---|---|---|
Ad Extn ID |
The ID of the ad extension. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Ad Extn Type |
The type of the ad extension. |
enum |
Ad Extn Parent Type |
The parent type of the ad extension. |
enum |
Ad Extn Title |
The title of the ad extension. Populated only for sitelinks. |
string |
Ad Extn Phone Number |
The phone number associated with the ad extension. Applies to call extensions. |
string |
Geo
Name |
Description |
Type |
---|---|---|
WOE ID |
The location ID. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
WOE Type |
country, state, city, dma, zip |
enum |
WOE Name |
The location Name. |
string |
product_categories
Name |
Description |
Type |
---|---|---|
Category ID |
ID of the product category |
long |
Parent Category ID |
ID of the parent product category |
long |
Category Name |
Product category name |
string |
Category Path |
The full category path |
string |
structured_snippet
Name |
Description |
Type |
---|---|---|
Structured Snippet Extn ID |
The ID of the Structured Snippet extension. This is the primary key for this dimension and should be included in the report in order for other dimension attributes to be queried. |
long |
Structured Snippet Header |
Structured Snippet header for which the ad click happens. |
string |
Structured Snippet Values |
Structured Snippet values for which the ad click happens. |
string |
Status |
Tells if the structured snippet extension is ON or not. |
string |