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
|
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
|
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 |
|
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 |
Not compatible with the following fields:
HourOfDay
|
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 |
Not compatible with the following fields:
HourOfDay
|
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
|
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
|
CanManageClients
|
Indicates if the account is an MCC account (true) or a regular Google Ads account (false).
Type | Enum |
Display Name | Can manage clients |
XML Attribute | canManageClients |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
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
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
ConversionLagBucket
EngagementRate
Engagements
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
VideoViewRate
VideoViews
ViewThroughConversions
|
ContentBudgetLostImpressionShare
|
The estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. A percentage returned as "xx.xx%", or the special value "> 90%".
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 | Content Lost IS (budget) |
XML Attribute | contentLostISBudget |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
ContentImpressionShare
|
The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as "xx.xx%", or the special value "< 10%".
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 | Content Impr. share |
XML Attribute | contentImprShare |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
ContentRankLostImpressionShare
|
The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. A percentage returned as "xx.xx%", or the special value "> 90%".
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 | Content Lost IS (rank) |
XML Attribute | contentLostISRank |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
CostPerAllConversion
CostPerConversion
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
ValuePerConversion
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
CostPerAllConversion
CostPerConversion
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
ValuePerConversion
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
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
AveragePosition
ClickType
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
CostPerAllConversion
CostPerConversion
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
ValuePerConversion
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
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
HourOfDay
|
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
|
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:
HourOfDay
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
|
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 |
|
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 |
|
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
|
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
AveragePosition
Clicks
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
Cost
Ctr
EngagementRate
Engagements
Impressions
InteractionRate
InteractionTypes
Interactions
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
VideoViewRate
VideoViews
|
ExternalCustomerId
|
The Customer ID.
Type | Long |
Display Name | Customer ID |
XML Attribute | customerID |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
|
HourOfDay
|
The hour of day as a number between 0 and 23, inclusive.
Type | Integer |
Display Name | Hour of day |
XML Attribute | hourOfDay |
Behavior | Segment |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
AllConversionRate
AllConversionValue
CostPerAllConversion
CrossDeviceConversions
InvalidClickRate
InvalidClicks
Slot
ValuePerAllConversion
|
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
|
InvalidClickRate
|
The percentage ("x.xx%") of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
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 | Invalid click rate |
XML Attribute | invalidClickRate |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
HourOfDay
Slot
|
InvalidClicks
|
Number of clicks Google considers illegitimate and doesn't charge you for.
Type | Long |
Display Name | Invalid clicks |
XML Attribute | invalidClicks |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
HourOfDay
Slot
|
IsAutoTaggingEnabled
|
Indicates if auto tagging is enabled on the account.
Type | Enum |
Display Name | Auto tagging enabled |
XML Attribute | autoTaggingEnabled |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
IsTestAccount
|
Indicates if the account is a test account.
Type | Enum |
Display Name | Test account |
XML Attribute | testAccount |
Behavior | Attribute |
Filterable | True |
Supports Zero Impressions | True |
Predicate values / display values
|
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 |
|
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 |
|
SearchBudgetLostImpressionShare
|
The estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. A percentage returned as "xx.xx%", or the special value "> 90%".
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 | Search Lost IS (budget) |
XML Attribute | searchLostISBudget |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
SearchExactMatchImpressionShare
|
The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. A percentage returned as "xx.xx%", or the special value "< 10%".
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 | Search Exact match IS |
XML Attribute | searchExactMatchIS |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
SearchImpressionShare
|
The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. A percentage returned as "xx.xx%", or the special value "< 10%".
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 | Search Impr. share |
XML Attribute | searchImprShare |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
SearchRankLostImpressionShare
|
The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. A percentage returned as "xx.xx%", or the special value "> 90%".
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 | Search Lost IS (rank) |
XML Attribute | searchLostISRank |
Behavior | Metric |
Filterable | True |
Supports Zero Impressions | True |
Not compatible with the following fields:
ClickType
ConversionAdjustment
ConversionAdjustmentLagBucket
ConversionCategoryName
ConversionLagBucket
ConversionTrackerId
ConversionTypeName
ExternalConversionSource
Slot
|
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
ContentBudgetLostImpressionShare
ContentImpressionShare
ContentRankLostImpressionShare
CrossDeviceConversions
HourOfDay
InvalidClickRate
InvalidClicks
SearchBudgetLostImpressionShare
SearchExactMatchImpressionShare
SearchImpressionShare
SearchRankLostImpressionShare
TopImpressionPercentage
|
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
|
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 |
Not compatible with the following fields:
HourOfDay
|
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 |
|
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 |
|