AdGroupAudienceView
The ad group audience asset view in the query.
Table Specific Information
Select
Google Ads does not allow every column to be selected in a single query as some data will conflict if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes will be returned. In general, these defaults are the same fields that are exposed through the Ads console.
To use the nondefault fields, explicitly select them in your query.
Filters can also be used in the WHERE clause. The supported operators are the =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, and NOT IN operators. All filters must be joined by the AND keyword as OR is not supported by the Ads API.
Columns
| Name | Type | Description |
| AdGroupAdRotationMode | String | AdGroupAdRotationMode column for table AdGroupAudienceView |
| AdGroupBaseAdGroup | String | AdGroupBaseAdGroup column for table AdGroupAudienceView |
| AdGroupCampaign | String | AdGroupCampaign column for table AdGroupAudienceView |
| AdGroupCpcBidMicros | Long | AdGroupCpcBidMicros column for table AdGroupAudienceView |
| AdGroupCpmBidMicros | Long | AdGroupCpmBidMicros column for table AdGroupAudienceView |
| AdGroupCpvBidMicros | Long | AdGroupCpvBidMicros column for table AdGroupAudienceView |
| AdGroupDisplayCustomBidDimension | String | AdGroupDisplayCustomBidDimension column for table AdGroupAudienceView |
| AdGroupEffectiveTargetCpaMicros | Long | AdGroupEffectiveTargetCpaMicros column for table AdGroupAudienceView |
| AdGroupEffectiveTargetCpaSource | String | AdGroupEffectiveTargetCpaSource column for table AdGroupAudienceView |
| AdGroupEffectiveTargetRoas | Double | AdGroupEffectiveTargetRoas column for table AdGroupAudienceView |
| AdGroupEffectiveTargetRoasSource | String | AdGroupEffectiveTargetRoasSource column for table AdGroupAudienceView |
| AdGroupExplorerAutoOptimizerSettingOptIn | Bool | AdGroupExplorerAutoOptimizerSettingOptIn column for table AdGroupAudienceView |
| AdGroupFinalUrlSuffix | String | AdGroupFinalUrlSuffix column for table AdGroupAudienceView |
| AdGroupId | Long | AdGroupId column for table AdGroupAudienceView |
| AdGroupLabels | String | AdGroupLabels column for table AdGroupAudienceView |
| AdGroupName | String | AdGroupName column for table AdGroupAudienceView |
| AdGroupPercentCpcBidMicros | Long | AdGroupPercentCpcBidMicros column for table AdGroupAudienceView |
| AdGroupResourceName | String | AdGroupResourceName column for table AdGroupAudienceView |
| AdGroupStatus | String | AdGroupStatus column for table AdGroupAudienceView |
| AdGroupTargetCpaMicros | Long | AdGroupTargetCpaMicros column for table AdGroupAudienceView |
| AdGroupTargetCpmMicros | Long | AdGroupTargetCpmMicros column for table AdGroupAudienceView |
| AdGroupTargetRoas | Double | AdGroupTargetRoas column for table AdGroupAudienceView |
| AdGroupTargetingSettingTargetRestrictions | String | AdGroupTargetingSettingTargetRestrictions column for table AdGroupAudienceView |
| AdGroupTrackingUrlTemplate | String | AdGroupTrackingUrlTemplate column for table AdGroupAudienceView |
| AdGroupType | String | AdGroupType column for table AdGroupAudienceView |
| AdGroupUrlCustomParameters | String | AdGroupUrlCustomParameters column for table AdGroupAudienceView |
| AdGroupCriterionAdGroup | String | AdGroupCriterionAdGroup column for table AdGroupAudienceView |
| AdGroupCriterionAgeRangeType | String | AdGroupCriterionAgeRangeType column for table AdGroupAudienceView |
| AdGroupCriterionAppPaymentModelType | String | AdGroupCriterionAppPaymentModelType column for table AdGroupAudienceView |
| AdGroupCriterionApprovalStatus | String | AdGroupCriterionApprovalStatus column for table AdGroupAudienceView |
| AdGroupCriterionBidModifier | Double | AdGroupCriterionBidModifier column for table AdGroupAudienceView |
| AdGroupCriterionCpcBidMicros | Long | AdGroupCriterionCpcBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionCpmBidMicros | Long | AdGroupCriterionCpmBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionCpvBidMicros | Long | AdGroupCriterionCpvBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionCriterionId | Long | AdGroupCriterionCriterionId column for table AdGroupAudienceView |
| AdGroupCriterionCustomAffinityCustomAffinity | String | AdGroupCriterionCustomAffinityCustomAffinity column for table AdGroupAudienceView |
| AdGroupCriterionCustomIntentCustomIntent | String | AdGroupCriterionCustomIntentCustomIntent column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpcBidMicros | Long | AdGroupCriterionEffectiveCpcBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpcBidSource | String | AdGroupCriterionEffectiveCpcBidSource column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpmBidMicros | Long | AdGroupCriterionEffectiveCpmBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpmBidSource | String | AdGroupCriterionEffectiveCpmBidSource column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpvBidMicros | Long | AdGroupCriterionEffectiveCpvBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionEffectiveCpvBidSource | String | AdGroupCriterionEffectiveCpvBidSource column for table AdGroupAudienceView |
| AdGroupCriterionEffectivePercentCpcBidMicros | Long | AdGroupCriterionEffectivePercentCpcBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionEffectivePercentCpcBidSource | String | AdGroupCriterionEffectivePercentCpcBidSource column for table AdGroupAudienceView |
| AdGroupCriterionFinalMobileUrls | String | AdGroupCriterionFinalMobileUrls column for table AdGroupAudienceView |
| AdGroupCriterionFinalUrlSuffix | String | AdGroupCriterionFinalUrlSuffix column for table AdGroupAudienceView |
| AdGroupCriterionFinalUrls | String | AdGroupCriterionFinalUrls column for table AdGroupAudienceView |
| AdGroupCriterionGenderType | String | AdGroupCriterionGenderType column for table AdGroupAudienceView |
| AdGroupCriterionIncomeRangeType | String | AdGroupCriterionIncomeRangeType column for table AdGroupAudienceView |
| AdGroupCriterionKeywordMatchType | String | AdGroupCriterionKeywordMatchType column for table AdGroupAudienceView |
| AdGroupCriterionKeywordText | String | AdGroupCriterionKeywordText column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueHotelCityCityCriterion | String | AdGroupCriterionListingGroupCaseValueHotelCityCityCriterion column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueHotelClassValue | Long | AdGroupCriterionListingGroupCaseValueHotelClassValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueHotelCountryRegionCountryRegionCriterion | String | AdGroupCriterionListingGroupCaseValueHotelCountryRegionCountryRegionCriterion column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueHotelIdValue | String | AdGroupCriterionListingGroupCaseValueHotelIdValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueHotelStateStateCriterion | String | AdGroupCriterionListingGroupCaseValueHotelStateStateCriterion column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductBrandValue | String | AdGroupCriterionListingGroupCaseValueProductBrandValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductCustomAttributeIndex | String | AdGroupCriterionListingGroupCaseValueProductCustomAttributeIndex column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductCustomAttributeValue | String | AdGroupCriterionListingGroupCaseValueProductCustomAttributeValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductBiddingCategoryCountryCode | String | AdGroupCriterionListingGroupCaseValueProductBiddingCategoryCountryCode column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductBiddingCategoryId | Long | AdGroupCriterionListingGroupCaseValueProductBiddingCategoryId column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductBiddingCategoryLevel | String | AdGroupCriterionListingGroupCaseValueProductBiddingCategoryLevel column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductChannelChannel | String | AdGroupCriterionListingGroupCaseValueProductChannelChannel column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductChannelExclusivityChannelExclusivity | String | AdGroupCriterionListingGroupCaseValueProductChannelExclusivityChannelExclusivity column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductConditionCondition | String | AdGroupCriterionListingGroupCaseValueProductConditionCondition column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductItemIdValue | String | AdGroupCriterionListingGroupCaseValueProductItemIdValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductTypeLevel | String | AdGroupCriterionListingGroupCaseValueProductTypeLevel column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupCaseValueProductTypeValue | String | AdGroupCriterionListingGroupCaseValueProductTypeValue column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupParentAdGroupCriterion | String | AdGroupCriterionListingGroupParentAdGroupCriterion column for table AdGroupAudienceView |
| AdGroupCriterionListingGroupType | String | AdGroupCriterionListingGroupType column for table AdGroupAudienceView |
| AdGroupCriterionMobileAppCategoryMobileAppCategoryConstant | String | AdGroupCriterionMobileAppCategoryMobileAppCategoryConstant column for table AdGroupAudienceView |
| AdGroupCriterionMobileApplicationAppId | String | AdGroupCriterionMobileApplicationAppId column for table AdGroupAudienceView |
| AdGroupCriterionMobileApplicationName | String | AdGroupCriterionMobileApplicationName column for table AdGroupAudienceView |
| AdGroupCriterionNegative | Bool | AdGroupCriterionNegative column for table AdGroupAudienceView |
| AdGroupCriterionParentalStatusType | String | AdGroupCriterionParentalStatusType column for table AdGroupAudienceView |
| AdGroupCriterionPercentCpcBidMicros | Long | AdGroupCriterionPercentCpcBidMicros column for table AdGroupAudienceView |
| AdGroupCriterionPlacementUrl | String | AdGroupCriterionPlacementUrl column for table AdGroupAudienceView |
| AdGroupCriterionPositionEstimatesEstimatedAddClicksAtFirstPositionCpc | Long | AdGroupCriterionPositionEstimatesEstimatedAddClicksAtFirstPositionCpc column for table AdGroupAudienceView |
| AdGroupCriterionPositionEstimatesEstimatedAddCostAtFirstPositionCpc | Long | AdGroupCriterionPositionEstimatesEstimatedAddCostAtFirstPositionCpc column for table AdGroupAudienceView |
| AdGroupCriterionPositionEstimatesFirstPageCpcMicros | Long | AdGroupCriterionPositionEstimatesFirstPageCpcMicros column for table AdGroupAudienceView |
| AdGroupCriterionPositionEstimatesFirstPositionCpcMicros | Long | AdGroupCriterionPositionEstimatesFirstPositionCpcMicros column for table AdGroupAudienceView |
| AdGroupCriterionPositionEstimatesTopOfPageCpcMicros | Long | AdGroupCriterionPositionEstimatesTopOfPageCpcMicros column for table AdGroupAudienceView |
| AdGroupCriterionQualityInfoCreativeQualityScore | String | AdGroupCriterionQualityInfoCreativeQualityScore column for table AdGroupAudienceView |
| AdGroupCriterionQualityInfoPostClickQualityScore | String | AdGroupCriterionQualityInfoPostClickQualityScore column for table AdGroupAudienceView |
| AdGroupCriterionQualityInfoQualityScore | Int | AdGroupCriterionQualityInfoQualityScore column for table AdGroupAudienceView |
| AdGroupCriterionQualityInfoSearchPredictedCtr | String | AdGroupCriterionQualityInfoSearchPredictedCtr column for table AdGroupAudienceView |
| AdGroupCriterionResourceName | String | AdGroupCriterionResourceName column for table AdGroupAudienceView |
| AdGroupCriterionStatus | String | AdGroupCriterionStatus column for table AdGroupAudienceView |
| AdGroupCriterionSystemServingStatus | String | AdGroupCriterionSystemServingStatus column for table AdGroupAudienceView |
| AdGroupCriterionTopicPath | String | AdGroupCriterionTopicPath column for table AdGroupAudienceView |
| AdGroupCriterionTopicTopicConstant | String | AdGroupCriterionTopicTopicConstant column for table AdGroupAudienceView |
| AdGroupCriterionTrackingUrlTemplate | String | AdGroupCriterionTrackingUrlTemplate column for table AdGroupAudienceView |
| AdGroupCriterionType | String | AdGroupCriterionType column for table AdGroupAudienceView |
| AdGroupCriterionUrlCustomParameters | String | AdGroupCriterionUrlCustomParameters column for table AdGroupAudienceView |
| AdGroupCriterionUserInterestUserInterestCategory | String | AdGroupCriterionUserInterestUserInterestCategory column for table AdGroupAudienceView |
| AdGroupCriterionUserListUserList | String | AdGroupCriterionUserListUserList column for table AdGroupAudienceView |
| AdGroupCriterionWebpageConditions | String | AdGroupCriterionWebpageConditions column for table AdGroupAudienceView |
| AdGroupCriterionWebpageCriterionName | String | AdGroupCriterionWebpageCriterionName column for table AdGroupAudienceView |
| AdGroupCriterionYoutubeChannelChannelId | String | AdGroupCriterionYoutubeChannelChannelId column for table AdGroupAudienceView |
| AdGroupCriterionYoutubeVideoVideoId | String | AdGroupCriterionYoutubeVideoVideoId column for table AdGroupAudienceView |
| Id | Long | The ID of the campaign. |
| Name | String | The name of the campaign. |
| Status | String | The status of the campaign. |
| ServingStatus | String | The ad serving status of the campaign. |
| AdServingOptimizationStatus | String | The ad serving optimization status of the campaign. |
| AdvertisingChannelType | String | The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. |
| AdvertisingChannelSubType | String | Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. |
| TrackingUrlTemplate | String | The URL template for constructing a tracking URL. |
| UrlCustomParameters | String | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
| OptIn | String | Whether the campaign is opted in to real-time bidding. |
| TargetSearchNetwork | Bool | Whether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true). |
| TargetGoogleSearch | Bool | Whether ads will be served with google.com search results. |
| TargetContentNetwork | Bool | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
| TargetPartnerSearchNetwork | Bool | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
| Labels | String | The resource names of labels attached to this campaign. |
| CustomerId | Long | CustomerId column for table AdGroupAudienceView |
| CustomerDescriptiveName | String | Name of the Customer. |
| CustomerCurrencyCode | String | CurrencyCode of the customer. |
| CustomerTimeZone | String | DateTimeZone of the customer. |
| Manager | Bool | Whether the customer is a manager. |
| TestAccount | Bool | Boolean showing if the account is a test account. |
| AutoTaggingEnabled | Bool | Boolean shofing if the AutoTagging is enabled. |
| HasPartnersBadge | Bool | Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. |
| ConversionTrackingId | Long | The conversion tracking id used for this account. This id is automatically assigned after any conversion tracking feature is used. If the customer doesn't use conversion tracking, this is 0. This field is read-only. |
| CrossAccountConversionTrackingId | Long | The conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only. |
| CallConversionAction | String | Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true. |
| CallConversionReportingEnabled | Bool | Whether to enable call conversion reporting. |
| CallReportingEnabled | Bool | Enable reporting of phone call events by redirecting them via Google System. |
| ActiveViewCpm | Double | ActiveViewCpm column for table AdGroupAudienceView |
| ActiveViewCtr | Double | ActiveViewCtr column for table AdGroupAudienceView |
| ActiveViewImpressions | Long | ActiveViewImpressions column for table AdGroupAudienceView |
| ActiveViewMeasurability | Double | ActiveViewMeasurability column for table AdGroupAudienceView |
| ActiveViewMeasurableCostMicros | Long | ActiveViewMeasurableCostMicros column for table AdGroupAudienceView |
| ActiveViewMeasurableImpressions | Long | ActiveViewMeasurableImpressions column for table AdGroupAudienceView |
| ActiveViewViewability | Double | ActiveViewViewability column for table AdGroupAudienceView |
| AllConversions | Double | AllConversions column for table AdGroupAudienceView |
| AllConversionsFromInteractionsRate | Double | AllConversionsFromInteractionsRate column for table AdGroupAudienceView |
| AllConversionsFromInteractionsValuePerInteraction | Double | AllConversionsFromInteractionsValuePerInteraction column for table AdGroupAudienceView |
| AllConversionsValue | Double | AllConversionsValue column for table AdGroupAudienceView |
| AllConversionsValuePerCost | Double | AllConversionsValuePerCost column for table AdGroupAudienceView |
| AverageCost | Double | AverageCost column for table AdGroupAudienceView |
| AverageCpc | Double | AverageCpc column for table AdGroupAudienceView |
| AverageCpe | Double | AverageCpe column for table AdGroupAudienceView |
| AverageCpm | Double | AverageCpm column for table AdGroupAudienceView |
| AverageCpv | Double | AverageCpv column for table AdGroupAudienceView |
| Clicks | Long | Clicks column for table AdGroupAudienceView |
| Conversions | Double | Conversions column for table AdGroupAudienceView |
| ConversionsFromInteractionsRate | Double | ConversionsFromInteractionsRate column for table AdGroupAudienceView |
| ConversionsValue | Double | ConversionsValue column for table AdGroupAudienceView |
| CostMicros | Long | CostMicros column for table AdGroupAudienceView |
| CostPerAllConversions | Double | CostPerAllConversions column for table AdGroupAudienceView |
| CostPerConversion | Double | CostPerConversion column for table AdGroupAudienceView |
| CrossDeviceConversions | Double | CrossDeviceConversions column for table AdGroupAudienceView |
| Ctr | Double | Ctr column for table AdGroupAudienceView |
| EngagementRate | Double | EngagementRate column for table AdGroupAudienceView |
| Engagements | Long | Engagements column for table AdGroupAudienceView |
| GmailForwards | Long | GmailForwards column for table AdGroupAudienceView |
| GmailSaves | Long | GmailSaves column for table AdGroupAudienceView |
| GmailSecondaryClicks | Long | GmailSecondaryClicks column for table AdGroupAudienceView |
| Impressions | Long | Impressions column for table AdGroupAudienceView |
| InteractionEventTypes | String | InteractionEventTypes column for table AdGroupAudienceView |
| InteractionRate | Double | InteractionRate column for table AdGroupAudienceView |
| Interactions | Long | Interactions column for table AdGroupAudienceView |
| ValuePerAllConversions | Double | ValuePerAllConversions column for table AdGroupAudienceView |
| ValuePerConversion | Double | ValuePerConversion column for table AdGroupAudienceView |
| VideoQuartile100Rate | Double | VideoQuartile100Rate column for table AdGroupAudienceView |
| VideoQuartile25Rate | Double | VideoQuartile25Rate column for table AdGroupAudienceView |
| VideoQuartile50Rate | Double | VideoQuartile50Rate column for table AdGroupAudienceView |
| VideoQuartile75Rate | Double | VideoQuartile75Rate column for table AdGroupAudienceView |
| VideoViewRate | Double | VideoViewRate column for table AdGroupAudienceView |
| VideoViews | Long | VideoViews column for table AdGroupAudienceView |
| ViewThroughConversions | Long | ViewThroughConversions column for table AdGroupAudienceView |
| AdNetworkType | String | AdNetworkType column for table AdGroupAudienceView |
| ClickType | String | ClickType column for table AdGroupAudienceView |
| ConversionAction | String | ConversionAction column for table AdGroupAudienceView |
| ConversionActionCategory | String | ConversionActionCategory column for table AdGroupAudienceView |
| ConversionActionName | String | ConversionActionName column for table AdGroupAudienceView |
| Date | Date | Date column for table AdGroupAudienceView |
| DayOfWeek | String | DayOfWeek column for table AdGroupAudienceView |
| Device | String | Device column for table AdGroupAudienceView |
| ExternalConversionSource | String | ExternalConversionSource column for table AdGroupAudienceView |
| HotelDateSelectionType | String | HotelDateSelectionType column for table AdGroupAudienceView |
| Month | Date | Month column for table AdGroupAudienceView |
| MonthOfYear | String | MonthOfYear column for table AdGroupAudienceView |
| Quarter | Date | Quarter column for table AdGroupAudienceView |
| Slot | String | Slot column for table AdGroupAudienceView |
| Week | Date | Week column for table AdGroupAudienceView |
| Year | Int | Year column for table AdGroupAudienceView |
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.
| Name | Type | Description |
| ManagerId | Long | Id of the manager account on behalf of which you are requesting customer data. |