AbsoluteTopImpressionPercentage
|
The percent of your ad impressions that are shown as the very first ad above the organic search results. See this Help Center article for details. A percentage can be returned as a real number ranging from 0.0 to 1.0.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Impr. (Abs. Top) % |
XML Attribute | imprAbsTop |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
AccentColor
|
The accent color for the responsive display ad.
Type | String |
Display Name | Accent color (responsive) |
XML Attribute | accentColorResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AccountCurrencyCode
|
The currency of the Customer account.
Type | String |
Display Name | Currency |
XML Attribute | currency |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AccountDescriptiveName
|
The descriptive name of the Customer account.
Type | String |
Display Name | Account |
XML Attribute | account |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AccountTimeZone
|
Name of the timezone selected for the Customer account. For example: "(GMT-05:00) Eastern Time". This field does not reflect the current state of daylight saving time for the timezone.
Type | String |
Display Name | Time zone |
XML Attribute | timeZone |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ActiveViewCpm
|
Average cost of viewable impressions (ActiveViewImpressions).
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Active View avg. CPM |
XML Attribute | activeViewAvgCPM |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewCtr
|
How often people clicked your ad after it became viewable.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Active View viewable CTR |
XML Attribute | activeViewViewableCTR |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewImpressions
|
How often your ad has become viewable on a Display Network site.
Type | Long |
Display Name | Active View viewable impressions |
XML Attribute | activeViewViewableImpressions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewMeasurability
|
The ratio of impressions that could be measured by Active View over the number of served impressions.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Active View measurable impr. / impr. |
XML Attribute | activeViewMeasurableImprImpr |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewMeasurableCost
|
The cost of the impressions you received that were measurable by Active View.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Active View measurable cost |
XML Attribute | activeViewMeasurableCost |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewMeasurableImpressions
|
The number of times your ads are appearing on placements in positions where they can be seen.
Type | Long |
Display Name | Active View measurable impr. |
XML Attribute | activeViewMeasurableImpr |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ActiveViewViewability
|
The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Active View viewable impr. / measurable impr. |
XML Attribute | activeViewViewableImprMeasurableImpr |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AdGroupId
|
The ID of the AdGroup.
Type | Long |
Display Name | Ad group ID |
XML Attribute | adGroupID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AdGroupName
|
The name of the AdGroup.
Type | String |
Display Name | Ad group |
XML Attribute | adGroup |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AdGroupStatus
|
Status of the ad group.
Type | AdGroupStatus |
Display Name | Ad group state |
XML Attribute | adGroupState |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
AdNetworkType1
|
First level network type.
Type | AdNetworkType1 |
Display Name | Network |
XML Attribute | network |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
SEARCH | Search Network |
CONTENT | Display Network |
YOUTUBE_SEARCH | YouTube Search |
YOUTUBE_WATCH | YouTube Videos |
MIXED | Cross-network |
|
AdNetworkType2
|
Second level network type (includes search partners).
Type | AdNetworkType2 |
Display Name | Network (with search partners) |
XML Attribute | networkWithSearchPartners |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
SEARCH | Google search |
SEARCH_PARTNERS | Search partners |
CONTENT | Display Network |
YOUTUBE_SEARCH | YouTube Search |
YOUTUBE_WATCH | YouTube Videos |
MIXED | Cross-network |
|
AdStrengthInfo
|
The strength information of the ad.
Type | AdStrengthInfo |
Display Name | Ad strength |
XML Attribute | adStrength |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
AdType
|
The type of the Ad. If the ad's type is not supported in the report request's API version, this field will have the value "unknown".
Type | Type |
Display Name | Ad type |
XML Attribute | adType |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
DEPRECATED_AD | Other |
IMAGE_AD | Image ad |
PRODUCT_AD | Shopping ad |
TEMPLATE_AD | Display ad |
TEXT_AD | Text ad |
THIRD_PARTY_REDIRECT_AD | Third party ad |
DYNAMIC_SEARCH_AD | Dynamic search ad |
CALL_ONLY_AD | Call only ad |
EXPANDED_TEXT_AD | Expanded text ad |
RESPONSIVE_DISPLAY_AD | Responsive ad |
SHOWCASE_AD | Showcase ad |
GOAL_OPTIMIZED_SHOPPING_AD | Goal-optimized Shopping ad |
EXPANDED_DYNAMIC_SEARCH_AD | Expanded dynamic search ad |
GMAIL_AD | Gmail ad |
RESPONSIVE_SEARCH_AD | Responsive search ad |
MULTI_ASSET_RESPONSIVE_DISPLAY_AD | Responsive display ad |
UNIVERSAL_APP_AD | Universal app ad |
UNKNOWN | unknown |
|
AllConversionRate
|
AllConversions divided by total clicks that can be conversion-tracked. This is how often a click on your ad resulted in a conversion. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | All conv. rate |
XML Attribute | allConvRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
AllConversions
|
Best estimate of the total number of conversions that Google Ads drives. Includes website, cross-device, and phone call conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | All conv. |
XML Attribute | allConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
AllConversionValue
|
The total value of all of your conversions, including those that are estimated. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | All conv. value |
XML Attribute | allConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
AllowFlexibleColor
|
Whether the responsive display ad colors must be strictly used.
Type | Enum |
Display Name | Allow flexible color (responsive) |
XML Attribute | allowFlexibleColorResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
Automated
|
Indicates if this ad is automatically created by Google Ads.
Type | Enum |
Display Name | Auto-applied ad suggestion |
XML Attribute | autoAppliedAdSuggestion |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
AverageCost
|
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Avg. Cost |
XML Attribute | avgCost |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AverageCpc
|
The total cost of all clicks divided by the total number of clicks received.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Avg. CPC |
XML Attribute | avgCPC |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AverageCpe
|
The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Avg. CPE |
XML Attribute | avgCPE |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AverageCpm
|
Average Cost-per-thousand impressions (CPM).
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Avg. CPM |
XML Attribute | avgCPM |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AverageCpv
|
The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Avg. CPV |
XML Attribute | avgCPV |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AveragePageviews
|
Average number of pages viewed per session. Imported from Google Analytics.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Pages / session |
XML Attribute | pagesSession |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
AveragePosition
|
Your ad's position relative to those of other advertisers.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Avg. position |
XML Attribute | avgPosition |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
AverageTimeOnSite
|
Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Avg. session duration (seconds) |
XML Attribute | avgSessionDurationSeconds |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
BaseAdGroupId
|
The ID of base ad group of trial ad groups. For regular ad groups, this is equal to AdGroupId. For campaign-level user lists, this will always be 0.
Type | Long |
Display Name | Base Ad group ID |
XML Attribute | baseAdGroupID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
BaseCampaignId
|
The ID of base campaign of trial campaigns. For regular campaigns, this is equal to CampaignId.
Type | Long |
Display Name | Base Campaign ID |
XML Attribute | baseCampaignID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
BounceRate
|
Percentage of clicks where the user only visited a single page on your site, formatted as "x.xx%". Imported from Google Analytics.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Bounce rate |
XML Attribute | bounceRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
BusinessName
|
The business name in a reponsive display ad.
Type | String |
Display Name | Business name |
XML Attribute | businessName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CallOnlyPhoneNumber
|
The phone number of call-only ad.
Type | String |
Display Name | Call-only ad phone number |
XML Attribute | callOnlyAdPhoneNumber |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
CallToActionText
|
The call-to-action text for the responsive display ad.
Type | String |
Display Name | Call to action text (responsive) |
XML Attribute | callToActionTextResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CampaignId
|
The ID of the Campaign.
Type | Long |
Display Name | Campaign ID |
XML Attribute | campaignID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CampaignName
|
The name of the Campaign.
Type | String |
Display Name | Campaign |
XML Attribute | campaign |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CampaignStatus
|
The status of the Campaign.
Type | CampaignStatus |
Display Name | Campaign state |
XML Attribute | campaignState |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | unknown |
ENABLED | enabled |
PAUSED | paused |
REMOVED | removed |
|
ClickAssistedConversions
|
The total number of conversions for which this keyword, ad, ad group, or campaign contributed to one or more assisted clicks. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.
Type | Long |
Display Name | Click Assisted Conv. |
XML Attribute | clickAssistedConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
ClickAssistedConversionsOverLastClickConversions
|
The total number of conversions for which this keyword, ad, ad group, or campaign received in assisted clicks divided by the total number of conversions for which it triggered the last click.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Click Assisted Conv. / Last Click Conv. |
XML Attribute | clickAssistedConvLastClickConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
ClickAssistedConversionValue
|
The total value of all conversions for which this keyword, ad, ad group, or campaign triggered assisted clicks.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Click Assisted Conv. Value |
XML Attribute | clickAssistedConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
Clicks
|
The number of clicks.
Type | Long |
Display Name | Clicks |
XML Attribute | clicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ClickType
|
Indicates the click type for metric fields such as Impressions. Since ads that serve can be attributed to multiple click types, metric fields may be double-counted and thus totals may not be accurate, especially for Display network campaigns.
Type | ClickType |
Display Name | Click type |
XML Attribute | clickType |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
URL_CLICKS | Headline |
CALLS | Phone calls |
OTHER | Other |
PRODUCT_EXTENSION_CLICKS | Product plusbox offer |
SITELINKS | Sitelink |
PRODUCT_LISTING_AD_CLICKS | Shopping ad - Standard |
GET_DIRECTIONS | Driving direction |
OFFER_PRINTS | Print offer |
BREADCRUMBS | Breadcrumbs |
CALL_TRACKING | Manually dialed phone calls |
MOBILE_CALL_TRACKING | Mobile phone calls |
LOCATION_EXPANSION | Get location details |
STORE_LOCATOR | Show nearby locations |
IN_APP_LINK | Mobile app extension |
PRODUCT_LISTING_AD_LOCAL | Shopping ad - Local |
APP_DEEPLINK | App engagement ad deep link |
PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL | Shopping ad - MultiChannel Local |
PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE | Shopping ad - MultiChannel Online |
PRODUCT_LISTING_ADS_COUPON | Shopping ad - Coupon |
PRODUCT_LISTING_AD_TRANSACTABLE | Shopping ad - Sell on Google |
PRODUCT_AD_APP_DEEPLINK | Shopping ad - App Deeplink |
SHOWCASE_AD_CATEGORY_LINK | Shopping - Showcase - Category |
SHOWCASE_AD_LOCAL_STOREFRONT_LINK | Shopping - Showcase - Local storefront |
SHOWCASE_AD_ONLINE_PRODUCT_LINK | Shopping - Showcase - Online product |
SHOWCASE_AD_LOCAL_PRODUCT_LINK | Shopping - Showcase - Local product |
PRICE_EXTENSION | Price Extension |
VIDEO_WEBSITE_CLICKS | Website |
VIDEO_CALL_TO_ACTION_CLICKS | Call-to-Action overlay |
VIDEO_APP_STORE_CLICKS | App store |
VIDEO_CARD_ACTION_HEADLINE_CLICKS | Cards |
VIDEO_END_CAP_CLICKS | End cap |
CLICK_ON_ENGAGEMENT_AD | Click on engagement ad |
LOCATION_FORMAT_MAP | Map |
LOCATION_FORMAT_LANDING_PAGE | Go to landing page |
LOCATION_FORMAT_STORE_INFO | Go to store info |
LOCATION_FORMAT_DIRECTIONS | Directions |
LOCATION_FORMAT_CALL | Call |
LOCATION_FORMAT_TEXT | Text |
LOCATION_FORMAT_IMAGE | Image(s) |
BROADBAND_PLAN | Broadband Plan |
WIRELESS_PLAN | Wireless Plan |
VISUAL_SITELINKS | Visual Sitelinks |
PROMOTION_EXTENSION | Promotion Extension |
SWIPEABLE_GALLERY_AD_HEADLINE | Ad Headline |
SWIPEABLE_GALLERY_AD_SWIPES | Swipes |
SWIPEABLE_GALLERY_AD_SEE_MORE | See More |
SWIPEABLE_GALLERY_AD_SITELINK_ONE | Sitelink 1 |
SWIPEABLE_GALLERY_AD_SITELINK_TWO | Sitelink 2 |
SWIPEABLE_GALLERY_AD_SITELINK_THREE | Sitelink 3 |
SWIPEABLE_GALLERY_AD_SITELINK_FOUR | Sitelink 4 |
SWIPEABLE_GALLERY_AD_SITELINK_FIVE | Sitelink 5 |
HOTEL_PRICE | Hotel price |
HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION | Hotel Book-on-Google room selection |
MAPS_PIN_CLICK | Maps Pin Clicks |
UNKNOWN | unknown |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
AverageCpe
AverageCpv
AveragePageviews
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
ConversionLagBucket
EngagementRate
Engagements
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
PercentNewVisitors
TopImpressionPercentage
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
ViewThroughConversions
|
CombinedApprovalStatus
|
Approval status that combines review state and status.
Type | PolicyApprovalStatus |
Display Name | Approval status |
XML Attribute | approvalStatus |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | POLICY_APPROVAL_STATUS_UNKNOWN |
APPROVED | Approved |
APPROVED_LIMITED | Approved (limited) |
ELIGIBLE | Eligible |
UNDER_REVIEW | Under review |
DISAPPROVED | Disapproved |
SITE_SUSPENDED | Site suspended |
|
ConversionAdjustment
|
Whether the conversion was adjusted or the conversion is original one.
Type | Enum |
Display Name | Conversion adjustment |
XML Attribute | conversionAdjustment |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
TRUE | Adjustments |
FALSE | Original conversions |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
CostPerAllConversion
CostPerConversion
CostPerCurrentModelAttributedConversion
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
ValuePerConversion
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionAdjustmentLagBucket
|
The number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Type | ConversionAdjustmentLagBucket |
Display Name | Days to conversion or adjustment |
XML Attribute | daysToConversionOrAdjustment |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | Unknown |
CONVERSION_0_TO_1_DAY | <1 day (impr. to conv.) |
CONVERSION_1_TO_2_DAYS | 1-2 days (impr. to conv.) |
CONVERSION_2_TO_3_DAYS | 2-3 days (impr. to conv.) |
CONVERSION_3_TO_4_DAYS | 3-4 days (impr. to conv.) |
CONVERSION_4_TO_5_DAYS | 4-5 days (impr. to conv.) |
CONVERSION_5_TO_6_DAYS | 5-6 days (impr. to conv.) |
CONVERSION_6_TO_7_DAYS | 6-7 days (impr. to conv.) |
CONVERSION_7_TO_8_DAYS | 7-8 days (impr. to conv.) |
CONVERSION_8_TO_9_DAYS | 8-9 days (impr. to conv.) |
CONVERSION_9_TO_10_DAYS | 9-10 days (impr. to conv.) |
CONVERSION_10_TO_11_DAYS | 10-11 days (impr. to conv.) |
CONVERSION_11_TO_12_DAYS | 11-12 days (impr. to conv.) |
CONVERSION_12_TO_13_DAYS | 12-13 days (impr. to conv.) |
CONVERSION_13_TO_14_DAYS | 13-14 days (impr. to conv.) |
CONVERSION_14_TO_21_DAYS | 14-21 days (impr. to conv.) |
CONVERSION_21_TO_30_DAYS | 21-30 days (impr. to conv.) |
CONVERSION_30_TO_45_DAYS | 30-45 days (impr. to conv.) |
CONVERSION_45_TO_60_DAYS | 45-60 days (impr. to conv.) |
CONVERSION_60_TO_90_DAYS | 60-90 days (impr. to conv.) |
ADJUSTMENT_0_TO_1_DAY | <1 day (impr. to adj.) |
ADJUSTMENT_1_TO_2_DAYS | 1-2 days (impr. to adj.) |
ADJUSTMENT_2_TO_3_DAYS | 2-3 days (impr. to adj.) |
ADJUSTMENT_3_TO_4_DAYS | 3-4 days (impr. to adj.) |
ADJUSTMENT_4_TO_5_DAYS | 4-5 days (impr. to adj.) |
ADJUSTMENT_5_TO_6_DAYS | 5-6 days (impr. to adj.) |
ADJUSTMENT_6_TO_7_DAYS | 6-7 days (impr. to adj.) |
ADJUSTMENT_7_TO_8_DAYS | 7-8 days (impr. to adj.) |
ADJUSTMENT_8_TO_9_DAYS | 8-9 days (impr. to adj.) |
ADJUSTMENT_9_TO_10_DAYS | 9-10 days (impr. to adj.) |
ADJUSTMENT_10_TO_11_DAYS | 10-11 days (impr. to adj.) |
ADJUSTMENT_11_TO_12_DAYS | 11-12 days (impr. to adj.) |
ADJUSTMENT_12_TO_13_DAYS | 12-13 days (impr. to adj.) |
ADJUSTMENT_13_TO_14_DAYS | 13-14 days (impr. to adj.) |
ADJUSTMENT_14_TO_21_DAYS | 14-21 days (impr. to adj.) |
ADJUSTMENT_21_TO_30_DAYS | 21-30 days (impr. to adj.) |
ADJUSTMENT_30_TO_45_DAYS | 30-45 days (impr. to adj.) |
ADJUSTMENT_45_TO_60_DAYS | 45-60 days (impr. to adj.) |
ADJUSTMENT_60_TO_90_DAYS | 60-90 days (impr. to adj.) |
ADJUSTMENT_90_TO_145_DAY | 90-145 days (impr. to adj.) |
CONVERSION_UNKNOWN | Unknown (impr. to conv.) |
ADJUSTMENT_UNKNOWN | Unknown (impr. to adj.) |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
CostPerAllConversion
CostPerConversion
CostPerCurrentModelAttributedConversion
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
ValuePerConversion
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionCategoryName
|
A category that describes the action the user will take to complete a conversion. Prevents zero-conversion rows from being returned. Values: "Download", "Lead", "Purchase/Sale", "Signup", "View of a key page", and "Other".
Type | String |
Display Name | Conversion category |
XML Attribute | conversionCategory |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionLagBucket
|
Days between click and conversion.
Type | ConversionLagBucket |
Display Name | Days to conversion |
XML Attribute | daysToConversion |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | Unknown |
CONVERSION_0_TO_1_DAY | <1 day |
CONVERSION_1_TO_2_DAYS | 1-2 days |
CONVERSION_2_TO_3_DAYS | 2-3 days |
CONVERSION_3_TO_4_DAYS | 3-4 days |
CONVERSION_4_TO_5_DAYS | 4-5 days |
CONVERSION_5_TO_6_DAYS | 5-6 days |
CONVERSION_6_TO_7_DAYS | 6-7 days |
CONVERSION_7_TO_8_DAYS | 7-8 days |
CONVERSION_8_TO_9_DAYS | 8-9 days |
CONVERSION_9_TO_10_DAYS | 9-10 days |
CONVERSION_10_TO_11_DAYS | 10-11 days |
CONVERSION_11_TO_12_DAYS | 11-12 days |
CONVERSION_12_TO_13_DAYS | 12-13 days |
CONVERSION_13_TO_14_DAYS | 13-14 days |
CONVERSION_14_TO_21_DAYS | 14-21 days |
CONVERSION_21_TO_30_DAYS | 21-30 days |
CONVERSION_30_TO_45_DAYS | 30-45 days |
CONVERSION_45_TO_60_DAYS | 45-60 days |
CONVERSION_60_TO_90_DAYS | 60-90 days |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
ClickType
Clicks
Cost
CostPerAllConversion
CostPerConversion
CostPerCurrentModelAttributedConversion
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
ValuePerConversion
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionRate
|
The number of conversions divided by total clicks that can be tracked to conversions. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Conv. rate |
XML Attribute | convRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
Conversions
|
The number of conversions for all conversion actions that you have opted into optimization. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Conversions |
XML Attribute | conversions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
ConversionTrackerId
|
ID of the conversion tracker.
Type | Long |
Display Name | Conversion Tracker Id |
XML Attribute | conversionTrackerId |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionTypeName
|
The name of the conversion type. Prevents zero-conversion rows from being returned.
Type | String |
Display Name | Conversion name |
XML Attribute | conversionName |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ConversionValue
|
The sum of conversion values for all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Total conv. value |
XML Attribute | totalConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
Cost
|
The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Cost |
XML Attribute | cost |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
CostPerAllConversion
|
Total cost divided by all conversions.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Cost / all conv. |
XML Attribute | costAllConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionLagBucket
|
CostPerConversion
|
The Cost attributable to conversion-tracked clicks divided by the number of conversions.
Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if this field is a bid and Google Ads is automatically setting the bid via the chosen bidding strategy, or c) "--" if this field is a bid and no bid applies to the row.
Type | Money |
Display Name | Cost / conv. |
XML Attribute | costConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionLagBucket
|
CostPerCurrentModelAttributedConversion
|
Shows how your historic CostPerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Cost / conv. (current model) |
XML Attribute | costConvCurrentModel |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionLagBucket
|
CreativeDestinationUrl
|
Destination URL of the ad.
Type | String |
Display Name | Destination URL |
XML Attribute | destinationURL |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeFinalAppUrls
|
List of final app URLs of the ad. List entries will start with one of: a) "android-app:" (for Android apps) or b) "os-app:" (for iOS apps).
List elements are returned in JSON list format.
Type | List |
Display Name | App final URL |
XML Attribute | appFinalURL |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeFinalMobileUrls
|
List of final mobile URLs of the ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Mobile final URL |
XML Attribute | mobileFinalURL |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeFinalUrls
|
List of final URLs of the ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Final URL |
XML Attribute | finalURL |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeFinalUrlSuffix
|
The URL template for appending params to final URL of an ad.
Type | String |
Display Name | Final URL suffix |
XML Attribute | finalURLSuffix |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeTrackingUrlTemplate
|
Tracking template of the ad.
Type | String |
Display Name | Tracking template |
XML Attribute | trackingTemplate |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CreativeUrlCustomParameters
|
List of custom parameters of the ad.
CustomParameters elements are returned in JSON map format.
Type | CustomParameters |
Display Name | Custom parameter |
XML Attribute | customParameter |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
CriterionId
|
The Criterion ID.
Type | Long |
Display Name | Keyword ID |
XML Attribute | keywordID |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
|
CriterionType
|
The type of criterion.
Type | ApiCriterionType |
Display Name | Criteria Type |
XML Attribute | criteriaType |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | unknown |
AD_SCHEDULE | Ad Schedule |
AGE_RANGE | Age |
APP_PAYMENT_MODEL | App Payment Model |
CARRIER | Carrier |
CONTENT_LABEL | Content Label |
CUSTOM_AFFINITY | Custom Affinity |
GENDER | Gender |
LOCATION_GROUPS | Location Groups |
IP_BLOCK | IP Block |
KEYWORD | Keyword |
LANGUAGE | Language |
LOCATION | Location |
MOBILE_APPLICATION | Mobile Application |
MOBILE_APP_CATEGORY | Mobile App Category |
MOBILE_DEVICE | Mobile Device |
OPERATING_SYSTEM_VERSION | Operating System Version |
PARENT | Parental status |
PLACEMENT | Placement |
PLATFORM | Platform |
PREFERRED_CONTENT | Preferred Content |
PRODUCT_PARTITION | Product Partition |
PRODUCT_SCOPE | Product Scope |
PROXIMITY | Proximity |
USER_INTEREST | User Interest |
USER_LIST | User List |
VERTICAL | Vertical |
WEBPAGE | Webpage |
YOUTUBE_CHANNEL | YouTube Channel |
YOUTUBE_VIDEO | YouTube Video |
CUSTOM_IN_MARKET | Custom In-Market |
|
CrossDeviceConversions
|
Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in your AllConversions column. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Cross-device conv. |
XML Attribute | crossDeviceConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
Slot
|
Ctr
|
The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | CTR |
XML Attribute | ctr |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
CurrentModelAttributedConversions
|
Shows how your historic Conversions data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Conversions (current model) |
XML Attribute | conversionsCurrentModel |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
CurrentModelAttributedConversionValue
|
Shows how your historic ConversionValue data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Conv. value (current model) |
XML Attribute | convValueCurrentModel |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
CustomerDescriptiveName
|
The descriptive name of the Customer.
Type | String |
Display Name | Client name |
XML Attribute | clientName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Date
|
The date formatted as yyyy-MM-dd.
Type | Date |
Display Name | Day |
XML Attribute | day |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
DayOfWeek
|
The name of the day of the week, e.g., "Monday".
Type | DayOfWeek |
Display Name | Day of week |
XML Attribute | dayOfWeek |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
MONDAY | Monday |
TUESDAY | Tuesday |
WEDNESDAY | Wednesday |
THURSDAY | Thursday |
FRIDAY | Friday |
SATURDAY | Saturday |
SUNDAY | Sunday |
|
Description
|
The descriptive text of an expanded text ad or responsive display ad.
Type | String |
Display Name | Description |
XML Attribute | description |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Description1
|
Line 1 description of the Ad.
Type | String |
Display Name | Description line 1 |
XML Attribute | descriptionLine1 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Description2
|
Line 2 description of the Ad.
Type | String |
Display Name | Description line 2 |
XML Attribute | descriptionLine2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Device
|
Device type where the impression was shown.
Type | DeviceType |
Display Name | Device |
XML Attribute | device |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | Other |
DESKTOP | Computers |
HIGH_END_MOBILE | Mobile devices with full browsers |
TABLET | Tablets with full browsers |
CONNECTED_TV | Devices streaming video content to TV screens |
Not compatible with the following fields:
AveragePageviews
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
PercentNewVisitors
|
DevicePreference
|
Platform ID of the device preference. You can look up the corresponding name and other information in the Platforms reference.
Type | Long |
Display Name | Device preference |
XML Attribute | devicePreference |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
DisplayUrl
|
Display URL of the Ad.
Type | String |
Display Name | Display URL |
XML Attribute | displayURL |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
EngagementRate
|
How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Engagement rate |
XML Attribute | engagementRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
Engagements
|
The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Type | Long |
Display Name | Engagements |
XML Attribute | engagements |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
|
The ID of the landscape logo image.
Type | Long |
Display Name | Landscape logo ID (responsive) |
XML Attribute | landscapeLogoIDResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The ID of the logo image used in the ResponsiveDisplayAd.
Type | Long |
Display Name | Logo ID (responsive) |
XML Attribute | logoIDResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
"The ID of the marketing image used in the ResponsiveDisplayAd."
Type | Long |
Display Name | Image ID (responsive) |
XML Attribute | imageIDResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The ID of the square marketing image.
Type | Long |
Display Name | Square image ID (responsive) |
XML Attribute | squareImageIDResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ExpandedDynamicSearchCreativeDescription2
|
The description 2 of the expanded dynamic search ad.
Type | String |
Display Name | Expanded Dynamic Search Ad Description 2 |
XML Attribute | expandedDynamicSearchAdDescription2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ExpandedTextAdDescription2
|
The description 2 of the expanded text ad.
Type | String |
Display Name | Expanded Text Ad Description 2 |
XML Attribute | expandedTextAdDescription2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ExpandedTextAdHeadlinePart3
|
The headline part 3 of the expanded text ad.
Type | String |
Display Name | Expanded Text Ad Headline 3 |
XML Attribute | expandedTextAdHeadline3 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ExternalConversionSource
|
The source of conversion such as website, import from calls.
Type | ExternalConversionSource |
Display Name | Conversion source |
XML Attribute | conversionSource |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
UNKNOWN | Other |
WEBPAGE | Website |
ANALYTICS | Analytics |
UPLOAD | Import from clicks |
AD_CALL_METRICS | Calls from ads |
OFFERS | Offers |
ENGAGEMENT | Engagement ads |
WEBSITE_CALL_METRICS | Calls from website |
STORE_VISITS | Store visits |
ANDROID_IN_APP | Android in-app action |
ANDROID_DOWNLOAD | Android app install (from Google Play) |
IOS_IN_APP | iOS in-app action |
IOS_FIRST_OPEN | iOS app install (first open) |
APP_UNSPECIFIED | Mobile app |
ANDROID_FIRST_OPEN | Android app install (first open) |
UPLOAD_CALLS | Import from calls |
FIREBASE | Firebase |
CLICK_TO_CALL | Phone number clicks |
SALESFORCE | Salesforce.com |
STORE_SALES_CRM | Store sales (data partner) |
STORE_SALES_PAYMENT_NETWORK | Store sales (automated) |
GOOGLE_PLAY | Google Play |
THIRD_PARTY_APP_ANALYTICS | Third-party app analytics |
GOOGLE_ATTRIBUTION | Google Attribution |
STORE_SALES_DIRECT | Store sales (direct upload) |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
ActiveViewCpm
ActiveViewCtr
ActiveViewImpressions
ActiveViewMeasurability
ActiveViewMeasurableCost
ActiveViewMeasurableImpressions
ActiveViewViewability
AverageCost
AverageCpc
AverageCpe
AverageCpm
AverageCpv
AveragePageviews
AveragePosition
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
Clicks
Cost
Ctr
EngagementRate
Engagements
GmailForwards
GmailSaves
GmailSecondaryClicks
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
Impressions
InteractionRate
InteractionTypes
Interactions
PercentNewVisitors
TopImpressionPercentage
VideoQuartile100Rate
VideoQuartile25Rate
VideoQuartile50Rate
VideoQuartile75Rate
VideoViewRate
VideoViews
|
ExternalCustomerId
|
The Customer ID.
Type | Long |
Display Name | Customer ID |
XML Attribute | customerID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The format setting of the responsive display ad.
Type | DisplayAdFormatSetting |
Display Name | Ad format preference (responsive) |
XML Attribute | adFormatPreferenceResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | DISPLAY_AD_FORMAT_SETTING_UNKNOWN |
ALL_FORMATS | All formats |
NON_NATIVE | None native |
NATIVE | Native |
|
|
The ID of the header image in the GmailAd.
Type | Long |
Display Name | Gmail ad header image media id |
XML Attribute | gmailAdHeaderImageMediaId |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The ID of the logo image in the GmailAd teaser.
Type | Long |
Display Name | Gmail ad logo image media id |
XML Attribute | gmailAdLogoImageMediaId |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The ID of the marketing image in the GmailAd.
Type | Long |
Display Name | Gmail ad marketing image media id |
XML Attribute | gmailAdMarketingImageMediaId |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
GmailForwards
|
The number of times your ad was forwarded to someone else as a message.
Type | Long |
Display Name | Gmail forwards |
XML Attribute | gmailForwards |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
GmailSaves
|
The number of times someone has saved your Gmail ad to their inbox as a message.
Type | Long |
Display Name | Gmail saves |
XML Attribute | gmailSaves |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
GmailSecondaryClicks
|
The number of clicks to your landing page on the expanded state of Gmail ads.
Type | Long |
Display Name | Gmail clicks to website |
XML Attribute | gmailClicksToWebsite |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
GmailTeaserBusinessName
|
The business name in the GmailAd teaser.
Type | String |
Display Name | Gmail ad business name |
XML Attribute | gmailAdBusinessName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
GmailTeaserDescription
|
The description in the GmailAd teaser.
Type | String |
Display Name | Gmail ad description |
XML Attribute | gmailAdDescription |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
GmailTeaserHeadline
|
The headline in the GmailAd teaser.
Type | String |
Display Name | Gmail ad headline |
XML Attribute | gmailAdHeadline |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Headline
|
The ad headline for a TextAd. For other ad types such as TemplateAds, this field will contain a string representation of the key attributes of the ad.
Type | String |
Display Name | Ad |
XML Attribute | ad |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
HeadlinePart1
|
The first part of an expanded text ad headline.
Type | String |
Display Name | Headline 1 |
XML Attribute | headline1 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
HeadlinePart2
|
The second part of an expanded text ad headline.
Type | String |
Display Name | Headline 2 |
XML Attribute | headline2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Id
|
ID of the main object of this row.
Type | Long |
Display Name | Ad ID |
XML Attribute | adID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ImageAdUrl
|
Prefix this value with "https://tpc.googlesyndication.com/pageadimg/imgad?id=" to get the full URL.
Type | String |
Display Name | Image Ad URL |
XML Attribute | imageAdURL |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
ImageCreativeImageHeight
|
The height of the image ad. For other ad types, this will have no values.
Type | Integer |
Display Name | Image Height |
XML Attribute | imageHeight |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ImageCreativeImageWidth
|
The width of the image ad. For other ad types, this will have no values.
Type | Integer |
Display Name | Image Width |
XML Attribute | imageWidth |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ImageCreativeMimeType
|
Image mime type. Only populated for image ads.
Type | Integer |
Display Name | Image Mime Type |
XML Attribute | imageMimeType |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ImageCreativeName
|
Name for the image ad.
Type | String |
Display Name | Image ad name |
XML Attribute | imageAdName |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ImpressionAssistedConversions
|
Total number of conversions for which this object triggered assist impressions prior to the last click. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.
Type | Long |
Display Name | Impr. Assisted Conv. |
XML Attribute | imprAssistedConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
ImpressionAssistedConversionsOverLastClickConversions
|
Total number of conversions for which this object triggered assist impressions divided by the total number of conversions for which this object triggered the last click.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Impr. Assisted Conv. / Last Click Conv. |
XML Attribute | imprAssistedConvLastClickConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
ImpressionAssistedConversionValue
|
Total value of all conversions for which this object triggered assist impressions.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Impr. Assisted Conv. Value |
XML Attribute | imprAssistedConvValue |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
Impressions
|
Count of how often your ad has appeared on a search results page or website on the Google Network.
Type | Long |
Display Name | Impressions |
XML Attribute | impressions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
InteractionRate
|
How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Interaction Rate |
XML Attribute | interactionRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
Interactions
|
The number of interactions. An interaction is the main user action associated with an ad format--clicks for text and shopping ads, views for video ads, and so on.
Type | Long |
Display Name | Interactions |
XML Attribute | interactions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
InteractionTypes
|
The types of interactions that are reflected in the Interactions, InteractionRate, and AverageCost columns.
Type | EnumSet |
Display Name | Interaction Types |
XML Attribute | interactionTypes |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
IsNegative
|
Indicates if the criterion for this row is a negative (exclusion) criterion.
Type | Enum |
Display Name | Is negative |
XML Attribute | isNegative |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | False |
Predicate values / display values
|
LabelIds
|
List of label IDs for the main object of this row.
List elements are returned in JSON list format.
Type | List |
Display Name | Label IDs |
XML Attribute | labelIDs |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Labels
|
List of label names for the main object of this row.
List elements are returned in JSON list format.
Type | List |
Display Name | Labels |
XML Attribute | labels |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
LongHeadline
|
The long format of the headline in a responsive display ad.
Type | String |
Display Name | Long headline |
XML Attribute | longHeadline |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MainColor
|
The main color for the responsive display ad.
Type | String |
Display Name | Main color (responsive) |
XML Attribute | mainColorResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MarketingImageCallToActionText
|
The call-to-action text for the GmailAd.
Type | String |
Display Name | Gmail ad marketing image call to action text |
XML Attribute | gmailAdMarketingImageCallToActionText |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MarketingImageCallToActionTextColor
|
The call-to-action text color for the GmailAd.
Type | String |
Display Name | Gmail ad marketing image call to action text color |
XML Attribute | gmailAdMarketingImageCallToActionTextColor |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MarketingImageDescription
|
The description of the marketing image in the GmailAd.
Type | String |
Display Name | Gmail ad marketing image description |
XML Attribute | gmailAdMarketingImageDescription |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MarketingImageHeadline
|
The headline of the marketing image in the GmailAd.
Type | String |
Display Name | Gmail ad marketing image headline |
XML Attribute | gmailAdMarketingImageHeadline |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Month
|
The first day of the month, formatted as yyyy-MM-dd.
Type | String |
Display Name | Month |
XML Attribute | month |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
MonthOfYear
|
The name of the month of the year, e.g., "December".
Type | MonthOfYear |
Display Name | Month of Year |
XML Attribute | monthOfYear |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
JANUARY | January |
FEBRUARY | February |
MARCH | March |
APRIL | April |
MAY | May |
JUNE | June |
JULY | July |
AUGUST | August |
SEPTEMBER | September |
OCTOBER | October |
NOVEMBER | November |
DECEMBER | December |
|
MultiAssetResponsiveDisplayAdAccentColor
|
The accentColor setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Accent color (multi asset responsive display) |
XML Attribute | accentColorMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdAllowFlexibleColor
|
The allowFlexibleColor setting for a MultiAssetResponsiveDisplayAd.
Type | Enum |
Display Name | Allow flexible color (multi asset responsive display) |
XML Attribute | allowFlexibleColorMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
MultiAssetResponsiveDisplayAdBusinessName
|
The businessName setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Business name (multi asset responsive display) |
XML Attribute | businessNameMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdCallToActionText
|
The callToActionText setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Call to action text (multi asset responsive display) |
XML Attribute | callToActionTextMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdDescriptions
|
The descriptions setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Descriptions (multi asset responsive display) |
XML Attribute | descriptionsMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix
|
The dynamicSettingsPricePrefix setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Price prefix (multi asset responsive display) |
XML Attribute | pricePrefixMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdDynamicSettingsPromoText
|
The dynamicSettingsPromoText setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Promotion text (multi asset responsive display) |
XML Attribute | promotionTextMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
|
The formatSetting setting for a MultiAssetResponsiveDisplayAd.
Type | DisplayAdFormatSetting |
Display Name | Ad format preference (multi asset responsive display) |
XML Attribute | adFormatPreferenceMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | DISPLAY_AD_FORMAT_SETTING_UNKNOWN |
ALL_FORMATS | All formats |
NON_NATIVE | None native |
NATIVE | Native |
|
MultiAssetResponsiveDisplayAdHeadlines
|
The headline setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and TextAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Headlines (multi asset responsive display) |
XML Attribute | headlinesMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdLandscapeLogoImages
|
The landscapeLogoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Landscape logos (multi asset responsive display) |
XML Attribute | landscapeLogosMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdLogoImages
|
The logoImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Logos (multi asset responsive display) |
XML Attribute | logosMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdLongHeadline
|
The longHeadline setting for a MultiAssetResponsiveDisplayAd.
Type | AssetLink |
Display Name | Long headline (multi asset responsive display) |
XML Attribute | longHeadlineMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdMainColor
|
The mainColor setting for a MultiAssetResponsiveDisplayAd.
Type | String |
Display Name | Main color (multi asset responsive display) |
XML Attribute | mainColorMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdMarketingImages
|
The marketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Images (multi asset responsive display) |
XML Attribute | imagesMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
|
The squareMarketingImages setting for a MultiAssetResponsiveDisplayAd. List elements are returned in JSON list format. Each list element has fields from AssetLink and ImageAsset entities.
List elements are returned in JSON list format.
Type | List |
Display Name | Square images (multi asset responsive display) |
XML Attribute | squareImagesMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
MultiAssetResponsiveDisplayAdYouTubeVideos
|
YouTube video ID of the YouTube assets of multi-asset responsive display ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Youtube videos (multi asset responsive display) |
XML Attribute | youtubeVideosMultiAssetResponsiveDisplay |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
Path1
|
The text that appears in the ad with the displayed URL for an expanded text ad.
Type | String |
Display Name | Path 1 |
XML Attribute | path1 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Path2
|
In addition to "Path1", more text that appears in the ad with the displayed URL for an expanded text ad.
Type | String |
Display Name | Path 2 |
XML Attribute | path2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
PercentNewVisitors
|
Percentage of first-time sessions (from people who had never visited your site before), formatted as "x.xx%". Imported from Google Analytics.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | % new sessions |
XML Attribute | newSessions |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
Device
ExternalConversionSource
Slot
|
PolicySummary
|
Policy information for an ad.
Type | AdGroupAdPolicySummary |
Display Name | Policy |
XML Attribute | policy |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
PricePrefix
|
The prefix shown before prices.
Type | String |
Display Name | Price prefix (responsive) |
XML Attribute | pricePrefixResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
PromoText
|
The promotion text for the responsive display ad.
Type | String |
Display Name | Promotion text (responsive) |
XML Attribute | promotionTextResponsive |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Quarter
|
The first day of the quarter, formatted as yyyy-MM-dd. Uses the calendar year for quarters, e.g., the second quarter of 2014 starts on 2014-04-01.
Type | String |
Display Name | Quarter |
XML Attribute | quarter |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
ResponsiveSearchAdDescriptions
|
A JSON string including details about all descriptive text for a responsive search ad, including the asset text, pinning, and performance label.
List elements are returned in JSON list format.
Type | List |
Display Name | Responsive Search Ad descriptions |
XML Attribute | responsiveSearchAdDescriptions |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
ResponsiveSearchAdHeadlines
|
A JSON string including details about all headlines for a responsive search ad, including the asset text, pinning, and performance label.
List elements are returned in JSON list format.
Type | List |
Display Name | Responsive Search Ad headlines |
XML Attribute | responsiveSearchAdHeadlines |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
ResponsiveSearchAdPath1
|
The text that appears in the ad with the displayed URL for a responsive search ad.
Type | String |
Display Name | Responsive Search Ad path 1 |
XML Attribute | responsiveSearchAdPath1 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ResponsiveSearchAdPath2
|
In addition to "ResponsiveSearchAdPath1", more text that appears in the ad with the displayed URL for a responsive search ad.
Type | String |
Display Name | Responsive Search Ad path 2 |
XML Attribute | responsiveSearchAdPath2 |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
ShortHeadline
|
The short format of the headline in a responsive display ad.
Type | String |
Display Name | Short headline |
XML Attribute | shortHeadline |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
Slot
|
The position of the Ad.
Type | Slot |
Display Name | Top vs. Other |
XML Attribute | topVsOther |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
SearchRhs | Google search: Side |
SearchTop | Google search: Top |
SearchOther | Google search: Other |
Content | Google Display Network |
AfsTop | Search partners: Top |
AfsOther | Search partners: Other |
Mixed | Cross-network |
Unknown | |
Not compatible with the following fields:
AbsoluteTopImpressionPercentage
AveragePageviews
AverageTimeOnSite
BounceRate
ClickAssistedConversionValue
ClickAssistedConversions
ClickAssistedConversionsOverLastClickConversions
CrossDeviceConversions
ImpressionAssistedConversionValue
ImpressionAssistedConversions
ImpressionAssistedConversionsOverLastClickConversions
PercentNewVisitors
TopImpressionPercentage
|
Status
|
The status of the main object in this row. For example, in a Campaign Performance Report this will be the status of each row's Campaign. In an Ad Group Performance Report this will be the status of each row's AdGroup.
Type | Status |
Display Name | Ad state |
XML Attribute | adState |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
ENABLED | enabled |
PAUSED | paused |
DISABLED | disabled |
|
SystemManagedEntitySource
|
Indicates the source of a system-generated entity.
Type | SystemManagedEntitySource |
Display Name | System managed Entity Source |
XML Attribute | systemManagedEntitySource |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
UNKNOWN | Other |
AD_VARIATIONS | Ad Variations |
|
TopImpressionPercentage
|
The percent of your ad impressions that are shown anywhere above the organic search results. See this Help Center article for details. A percentage can be returned as a real number ranging from 0.0 to 1.0.
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Impr. (Top) % |
XML Attribute | imprTop |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
UniversalAppAdDescriptions
|
The list of descriptions of the Universal App ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Universal App Ad descriptions |
XML Attribute | universalAppAdDescriptions |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
UniversalAppAdHeadlines
|
The list of headers of the Universal App ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Universal App Ad headlines |
XML Attribute | universalAppAdHeadlines |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
|
The HTML5 media bundles attached to the ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Universal App Ad html5 media bundles |
XML Attribute | universalAppAdHtml5MediaBundles |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
UniversalAppAdImages
|
The marketing images attached to the ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Universal App Ad images |
XML Attribute | universalAppAdImages |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
UniversalAppAdMandatoryAdText
|
The ad text that must be displayed when the ad is served.
Type | AssetLink |
Display Name | Universal App Ad mandatory ad text |
XML Attribute | universalAppAdMandatoryAdText |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
UniversalAppAdYouTubeVideos
|
The YouTube videos attached to the ad.
List elements are returned in JSON list format.
Type | List |
Display Name | Universal App Ad youTube videos |
XML Attribute | universalAppAdYouTubeVideos |
Behavior | Attribute |
Filterable | False |
Supports Zero Impressions | True |
|
ValuePerAllConversion
|
The value, on average, of all conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Value / all conv. |
XML Attribute | valueAllConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
ValuePerConversion
|
The total value of your conversions divided by the total number of conversions. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Value / conv. |
XML Attribute | valueConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
ValuePerCurrentModelAttributedConversion
|
Shows how your historic ValuePerConversion data would look under the attribution model you've currently selected. This field is formatted with dot (".") for decimal separator, precision of two decimal positions and no thousands separator (e.g. 1000000.00).
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Value / conv. (current model) |
XML Attribute | valueConvCurrentModel |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
|
VideoQuartile100Rate
|
Percentage of impressions where the viewer watched all of your video. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Video played to 100% |
XML Attribute | videoPlayedTo100 |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
VideoQuartile25Rate
|
Percentage of impressions where the viewer watched 25% of your video. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Video played to 25% |
XML Attribute | videoPlayedTo25 |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
VideoQuartile50Rate
|
Percentage of impressions where the viewer watched 50% of your video. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Video played to 50% |
XML Attribute | videoPlayedTo50 |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
VideoQuartile75Rate
|
Percentage of impressions where the viewer watched 75% of your video. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | Video played to 75% |
XML Attribute | videoPlayedTo75 |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
VideoViewRate
|
The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. Percentage returned as "x.xx%".
To prevent calculation accuracy issues, fields whose data type is Double can be used only with the following operators in predicates: LESS_THAN or GREATER_THAN . This is also true for AWQL: Only the operators < and > are allowed in the WHERE clause.
Type | Double |
Display Name | View rate |
XML Attribute | viewRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
VideoViews
|
The number of times your video ads were viewed.
Type | Long |
Display Name | Views |
XML Attribute | views |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
|
ViewThroughConversions
|
The total number of view-through conversions. These happen when a customer sees a Display network ad, then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. This field is formatted using US locale, i.e., using comma "," for thousands and dot "." for decimals.
Type | Long |
Display Name | View-through conv. |
XML Attribute | viewThroughConv |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
|
Week
|
The date for the Monday of the week, formatted as yyyy-MM-dd.
Type | String |
Display Name | Week |
XML Attribute | week |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|
Year
|
The year, formatted as yyyy.
Type | Integer |
Display Name | Year |
XML Attribute | year |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
|