Placement Performance Report

The Placements Performance report includes all statistics aggregated at the placement level, one row per placement. If other segment fields are used, you may get more than one row per placement. See segmentation for more information. This is a multiple attribution report.

This report returns rows for managed and excluded placements at the ad group level. To see placements excluded at the campaign level, use the CAMPAIGN_NEGATIVE_PLACEMENTS_PERFORMANCE_REPORT instead.

To differentiate between managed and excluded placements:

• Managed placements will have IsNegative = FALSE and Id not equal to two dashes (--). If you are only interested in managed placements, add IsNegative = FALSE AND Id > 0 to your request.
• Excluded placements will have IsNegative = TRUE and Id not equal to two dashes (--). If you are only interested in excluded placements, add IsNegative = TRUE AND Id > 0 to your request.

By default, this report only returns rows where AdNetworkType1 = CONTENT. To include results for other networks, include a predicate on AdNetworkType1 in your request. For example, to include YouTube placements, add AdNetworkType1 IN [YOUTUBE_SEARCH, YOUTUBE_WATCH] to your request.

Attribute AccountCurrencyCode AccountDescriptiveName AccountTimeZone AdGroupId AdGroupName AdGroupStatus BaseAdGroupId BaseCampaignId BiddingStrategyId BiddingStrategyName BiddingStrategyType BidModifier CampaignId CampaignName CampaignStatus CpcBid CpcBidSource CpmBid CpmBidSource Criteria CriteriaDestinationUrl CustomerDescriptiveName DisplayName ExternalCustomerId FinalAppUrls FinalMobileUrls FinalUrls Id IsNegative IsRestrict Status TrackingUrlTemplate UrlCustomParameters

Segment AdNetworkType1 AdNetworkType2 ClickType ConversionCategoryName ConversionTrackerId ConversionTypeName Date DayOfWeek Device ExternalConversionSource Month MonthOfYear Quarter Week Year

Metric ActiveViewCpm ActiveViewCtr ActiveViewImpressions ActiveViewMeasurability ActiveViewMeasurableCost ActiveViewMeasurableImpressions ActiveViewViewability AllConversionRate AllConversions AllConversionValue AverageCost AverageCpc AverageCpe AverageCpm AverageCpv Clicks ConversionRate Conversions ConversionValue Cost CostPerAllConversion CostPerConversion CrossDeviceConversions Ctr EngagementRate Engagements GmailForwards GmailSaves GmailSecondaryClicks Impressions InteractionRate Interactions InteractionTypes ValuePerAllConversion ValuePerConversion VideoQuartile100Rate VideoQuartile25Rate VideoQuartile50Rate VideoQuartile75Rate VideoViewRate VideoViews ViewThroughConversions

Download this table in CSV format

PLACEMENT_PERFORMANCE_REPORT
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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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
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
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: ConversionCategoryName 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: ConversionCategoryName 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 ConversionCategoryName 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: ConversionCategoryName 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 ConversionCategoryName ConversionTrackerId ConversionTypeName ExternalConversionSource
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
BiddingStrategyId	The ID of the BiddingStrategyConfiguration. Type Long Display Name Bid Strategy ID XML Attribute bidStrategyID Behavior Attribute Filterable True Supports Zero Impressions True
BiddingStrategyName	The name of the BiddingStrategyConfiguration. Type String Display Name Bid Strategy Name XML Attribute bidStrategyName Behavior Attribute Filterable True Supports Zero Impressions True
BiddingStrategyType	The type of the BiddingStrategyConfiguration. Type BiddingStrategyType Display Name Bid Strategy Type XML Attribute bidStrategyType Behavior Attribute Filterable True Supports Zero Impressions True Predicate values / display values MANUAL_CPC cpc MANUAL_CPV cpv MANUAL_CPM cpm PAGE_ONE_PROMOTED Target search page location TARGET_SPEND Maximize clicks TARGET_CPA Target CPA TARGET_ROAS Target ROAS MAXIMIZE_CONVERSIONS Maximize Conversions MAXIMIZE_CONVERSION_VALUE Maximize Conversion Value TARGET_OUTRANK_SHARE Target Outranking Share NONE None UNKNOWN unknown
BidModifier	The bid modifier. To filter by this field, use values greater than 0 and less than or equal to 1. 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 Bid adj. XML Attribute bidAdj 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
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: ConversionCategoryName 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: AverageCpe AverageCpv EngagementRate Engagements VideoQuartile100Rate VideoQuartile25Rate VideoQuartile50Rate VideoQuartile75Rate VideoViewRate VideoViews ViewThroughConversions
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: ActiveViewCpm ActiveViewCtr ActiveViewImpressions ActiveViewMeasurability ActiveViewMeasurableCost ActiveViewMeasurableImpressions ActiveViewViewability AverageCost AverageCpc AverageCpe AverageCpm AverageCpv Clicks Cost Ctr EngagementRate Engagements Impressions InteractionRate InteractionTypes Interactions 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: ActiveViewCpm ActiveViewCtr ActiveViewImpressions ActiveViewMeasurability ActiveViewMeasurableCost ActiveViewMeasurableImpressions ActiveViewViewability AverageCost AverageCpc AverageCpe AverageCpm AverageCpv Clicks Cost Ctr EngagementRate Engagements Impressions InteractionRate InteractionTypes Interactions 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: ActiveViewCpm ActiveViewCtr ActiveViewImpressions ActiveViewMeasurability ActiveViewMeasurableCost ActiveViewMeasurableImpressions ActiveViewViewability AverageCost AverageCpc AverageCpe AverageCpm AverageCpv Clicks Cost Ctr EngagementRate Engagements Impressions InteractionRate InteractionTypes Interactions 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: ConversionCategoryName 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
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
CpcBid	Cost per click bid. Values can be one of: a) a money amount in micros, b) "auto: x" or "auto" if AdWords is automatically setting the bid via the chosen bidding strategy, or c) "--" if no CPC bid applies to the row. 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 Max. CPC XML Attribute maxCPC Behavior Attribute Filterable True Supports Zero Impressions True
CpcBidSource	Source of the CPC bid. Type BidSource Display Name Max CPC source XML Attribute maxCPCSource Behavior Attribute Filterable True Supports Zero Impressions True Predicate values / display values ADGROUP ad groups CRITERION ad group criteria ADGROUP_BIDDING_STRATEGY ad group bidding strategy CAMPAIGN_BIDDING_STRATEGY campaign bidding strategy
CpmBid	CPM (cost per thousand impressions) bid. 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 Max. CPM XML Attribute maxCPM Behavior Attribute Filterable True Supports Zero Impressions True
CpmBidSource	Source of the CPM bid. Type BidSource Display Name Max CPM Source XML Attribute maxCPMSource Behavior Attribute Filterable True Supports Zero Impressions True Predicate values / display values ADGROUP ad groups CRITERION ad group criteria ADGROUP_BIDDING_STRATEGY ad group bidding strategy CAMPAIGN_BIDDING_STRATEGY campaign bidding strategy
Criteria	Descriptive string for the Criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide. Type String Display Name Placement XML Attribute placement Behavior Attribute Filterable True Supports Zero Impressions True
CriteriaDestinationUrl	Destination URL of the criterion that triggered ads. Type String Display Name Destination URL XML Attribute destinationURL Behavior Attribute Filterable True Supports Zero Impressions True
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
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: ConversionCategoryName 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
DisplayName	Descriptive name for the criterion. For more information on the format of criteria types in reports, see the Criteria prefixes section of the reporting guide. Type String Display Name Criteria Display Name XML Attribute criteriaDisplayName 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 ConversionCategoryName 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 ConversionCategoryName 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: ActiveViewCpm ActiveViewCtr ActiveViewImpressions ActiveViewMeasurability ActiveViewMeasurableCost ActiveViewMeasurableImpressions ActiveViewViewability AverageCost AverageCpc AverageCpe AverageCpm AverageCpv Clicks Cost Ctr EngagementRate Engagements Impressions InteractionRate InteractionTypes Interactions 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
FinalAppUrls	List of final app URLs of the main object of this row. List entries will start with one of: a) "android-app:" (for Android apps) or b) "os-app:" (for iOS apps). AppUrlList elements are returned in JSON list format. Type AppUrlList Display Name App final URL XML Attribute appFinalURL Behavior Attribute Filterable True Supports Zero Impressions True
FinalMobileUrls	List of final mobile URLs of the main object of this row. UrlList elements are returned in JSON list format. Type UrlList Display Name Mobile final URL XML Attribute mobileFinalURL Behavior Attribute Filterable True Supports Zero Impressions True
FinalUrls	List of final URLs of the main object of this row. UrlList elements are returned in JSON list format. Type UrlList Display Name Final URL XML Attribute finalURL 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
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
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
Id	ID of the main object of this row. Type Long Display Name Criterion ID XML Attribute criterionID Behavior Attribute Filterable True Supports Zero Impressions True
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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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: ConversionCategoryName 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 True Predicate values / display values TRUE true FALSE false
IsRestrict	A value of 'true' indicates that the criterion type is used for bidding and restricting targeting. A value of 'false' indicates that the criterion type is used only for bidding. This will have the opposite value from that of targetAll for the criteria's corresponding AdGroup.TargetingSettingDetail. For example, if the TargetingSettingDetail for criterionTypeGroup = PLACEMENT has targetAll = true, then the IsRestrict field will be false for Placement criteria. Type Enum Display Name Is restricting XML Attribute isRestricting Behavior Attribute Filterable True Supports Zero Impressions True Predicate values / display values TRUE true FALSE false
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
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 UserStatus Display Name Placement state XML Attribute placementState Behavior Attribute Filterable True Supports Zero Impressions True Predicate values / display values ENABLED enabled REMOVED removed PAUSED paused
TrackingUrlTemplate	Tracking template of the main object of this row. Type String Display Name Tracking template XML Attribute trackingTemplate Behavior Attribute Filterable True Supports Zero Impressions True
UrlCustomParameters	Custom URL parameters of the main object of this row. 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
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
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 ConversionCategoryName 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 ConversionCategoryName 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 ConversionCategoryName 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 ConversionCategoryName 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 ConversionCategoryName 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 ConversionCategoryName 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