SearchTermView
The search term 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 SearchTermView |
| AdGroupBaseAdGroup | String | AdGroupBaseAdGroup column for table SearchTermView |
| AdGroupCampaign | String | AdGroupCampaign column for table SearchTermView |
| AdGroupCpcBidMicros | Long | AdGroupCpcBidMicros column for table SearchTermView |
| AdGroupCpmBidMicros | Long | AdGroupCpmBidMicros column for table SearchTermView |
| AdGroupCpvBidMicros | Long | AdGroupCpvBidMicros column for table SearchTermView |
| AdGroupDisplayCustomBidDimension | String | AdGroupDisplayCustomBidDimension column for table SearchTermView |
| AdGroupEffectiveTargetCpaMicros | Long | AdGroupEffectiveTargetCpaMicros column for table SearchTermView |
| AdGroupEffectiveTargetCpaSource | String | AdGroupEffectiveTargetCpaSource column for table SearchTermView |
| AdGroupEffectiveTargetRoas | Double | AdGroupEffectiveTargetRoas column for table SearchTermView |
| AdGroupEffectiveTargetRoasSource | String | AdGroupEffectiveTargetRoasSource column for table SearchTermView |
| AdGroupExplorerAutoOptimizerSettingOptIn | Bool | AdGroupExplorerAutoOptimizerSettingOptIn column for table SearchTermView |
| AdGroupFinalUrlSuffix | String | AdGroupFinalUrlSuffix column for table SearchTermView |
| AdGroupId | Long | AdGroupId column for table SearchTermView |
| AdGroupLabels | String | AdGroupLabels column for table SearchTermView |
| AdGroupName | String | AdGroupName column for table SearchTermView |
| AdGroupPercentCpcBidMicros | Long | AdGroupPercentCpcBidMicros column for table SearchTermView |
| AdGroupResourceName | String | AdGroupResourceName column for table SearchTermView |
| AdGroupStatus | String | AdGroupStatus column for table SearchTermView |
| AdGroupTargetCpaMicros | Long | AdGroupTargetCpaMicros column for table SearchTermView |
| AdGroupTargetCpmMicros | Long | AdGroupTargetCpmMicros column for table SearchTermView |
| AdGroupTargetRoas | Double | AdGroupTargetRoas column for table SearchTermView |
| AdGroupTargetingSettingTargetRestrictions | String | AdGroupTargetingSettingTargetRestrictions column for table SearchTermView |
| AdGroupTrackingUrlTemplate | String | AdGroupTrackingUrlTemplate column for table SearchTermView |
| AdGroupType | String | AdGroupType column for table SearchTermView |
| AdGroupUrlCustomParameters | String | AdGroupUrlCustomParameters column for table SearchTermView |
| CampaignAdServingOptimizationStatus | String | CampaignAdServingOptimizationStatus column for table SearchTermView |
| CampaignAdvertisingChannelSubType | String | CampaignAdvertisingChannelSubType column for table SearchTermView |
| CampaignAdvertisingChannelType | String | CampaignAdvertisingChannelType column for table SearchTermView |
| CampaignAppCampaignSettingAppId | String | CampaignAppCampaignSettingAppId column for table SearchTermView |
| CampaignAppCampaignSettingAppStore | String | CampaignAppCampaignSettingAppStore column for table SearchTermView |
| CampaignAppCampaignSettingBiddingStrategyGoalType | String | CampaignAppCampaignSettingBiddingStrategyGoalType column for table SearchTermView |
| CampaignBaseCampaign | String | CampaignBaseCampaign column for table SearchTermView |
| CampaignBiddingStrategy | String | CampaignBiddingStrategy column for table SearchTermView |
| CampaignBiddingStrategyType | String | CampaignBiddingStrategyType column for table SearchTermView |
| CampaignCampaignBudget | String | CampaignCampaignBudget column for table SearchTermView |
| CampaignCommissionCommissionRateMicros | Long | CampaignCommissionCommissionRateMicros column for table SearchTermView |
| CampaignDynamicSearchAdsSettingDomainName | String | CampaignDynamicSearchAdsSettingDomainName column for table SearchTermView |
| CampaignDynamicSearchAdsSettingFeeds | String | CampaignDynamicSearchAdsSettingFeeds column for table SearchTermView |
| CampaignDynamicSearchAdsSettingLanguageCode | String | CampaignDynamicSearchAdsSettingLanguageCode column for table SearchTermView |
| CampaignDynamicSearchAdsSettingUseSuppliedUrlsOnly | Bool | CampaignDynamicSearchAdsSettingUseSuppliedUrlsOnly column for table SearchTermView |
| CampaignEndDate | Date | CampaignEndDate column for table SearchTermView |
| CampaignExperimentType | String | CampaignExperimentType column for table SearchTermView |
| CampaignFinalUrlSuffix | String | CampaignFinalUrlSuffix column for table SearchTermView |
| CampaignFrequencyCaps | String | CampaignFrequencyCaps column for table SearchTermView |
| CampaignGeoTargetTypeSettingNegativeGeoTargetType | String | CampaignGeoTargetTypeSettingNegativeGeoTargetType column for table SearchTermView |
| CampaignGeoTargetTypeSettingPositiveGeoTargetType | String | CampaignGeoTargetTypeSettingPositiveGeoTargetType column for table SearchTermView |
| CampaignHotelSettingHotelCenterId | Long | CampaignHotelSettingHotelCenterId column for table SearchTermView |
| CampaignId | Long | CampaignId column for table SearchTermView |
| CampaignLabels | String | CampaignLabels column for table SearchTermView |
| CampaignManualCpcEnhancedCpcEnabled | Bool | CampaignManualCpcEnhancedCpcEnabled column for table SearchTermView |
| CampaignManualCpm | String | CampaignManualCpm column for table SearchTermView |
| CampaignManualCpv | String | CampaignManualCpv column for table SearchTermView |
| CampaignMaximizeConversionValueTargetRoas | Double | CampaignMaximizeConversionValueTargetRoas column for table SearchTermView |
| CampaignMaximizeConversions | String | CampaignMaximizeConversions column for table SearchTermView |
| CampaignName | String | CampaignName column for table SearchTermView |
| CampaignNetworkSettingsTargetContentNetwork | Bool | CampaignNetworkSettingsTargetContentNetwork column for table SearchTermView |
| CampaignNetworkSettingsTargetGoogleSearch | Bool | CampaignNetworkSettingsTargetGoogleSearch column for table SearchTermView |
| CampaignNetworkSettingsTargetPartnerSearchNetwork | Bool | CampaignNetworkSettingsTargetPartnerSearchNetwork column for table SearchTermView |
| CampaignNetworkSettingsTargetSearchNetwork | Bool | CampaignNetworkSettingsTargetSearchNetwork column for table SearchTermView |
| CampaignPaymentMode | String | CampaignPaymentMode column for table SearchTermView |
| CampaignPercentCpcCpcBidCeilingMicros | Long | CampaignPercentCpcCpcBidCeilingMicros column for table SearchTermView |
| CampaignPercentCpcEnhancedCpcEnabled | Bool | CampaignPercentCpcEnhancedCpcEnabled column for table SearchTermView |
| CampaignRealTimeBiddingSettingOptIn | Bool | CampaignRealTimeBiddingSettingOptIn column for table SearchTermView |
| CampaignResourceName | String | CampaignResourceName column for table SearchTermView |
| CampaignSelectiveOptimizationConversionActions | String | CampaignSelectiveOptimizationConversionActions column for table SearchTermView |
| CampaignServingStatus | String | CampaignServingStatus column for table SearchTermView |
| CampaignShoppingSettingCampaignPriority | Int | CampaignShoppingSettingCampaignPriority column for table SearchTermView |
| CampaignShoppingSettingEnableLocal | Bool | CampaignShoppingSettingEnableLocal column for table SearchTermView |
| CampaignShoppingSettingMerchantId | Long | CampaignShoppingSettingMerchantId column for table SearchTermView |
| CampaignShoppingSettingSalesCountry | String | CampaignShoppingSettingSalesCountry column for table SearchTermView |
| CampaignStartDate | Date | CampaignStartDate column for table SearchTermView |
| CampaignStatus | String | CampaignStatus column for table SearchTermView |
| CampaignTargetCpaCpcBidCeilingMicros | Long | CampaignTargetCpaCpcBidCeilingMicros column for table SearchTermView |
| CampaignTargetCpaCpcBidFloorMicros | Long | CampaignTargetCpaCpcBidFloorMicros column for table SearchTermView |
| CampaignTargetCpaTargetCpaMicros | Long | CampaignTargetCpaTargetCpaMicros column for table SearchTermView |
| CampaignTargetCpm | String | CampaignTargetCpm column for table SearchTermView |
| CampaignTargetImpressionShareCpcBidCeilingMicros | Long | CampaignTargetImpressionShareCpcBidCeilingMicros column for table SearchTermView |
| CampaignTargetImpressionShareLocation | String | CampaignTargetImpressionShareLocation column for table SearchTermView |
| CampaignTargetImpressionShareLocationFractionMicros | Long | CampaignTargetImpressionShareLocationFractionMicros column for table SearchTermView |
| CampaignTargetRoasCpcBidCeilingMicros | Long | CampaignTargetRoasCpcBidCeilingMicros column for table SearchTermView |
| CampaignTargetRoasCpcBidFloorMicros | Long | CampaignTargetRoasCpcBidFloorMicros column for table SearchTermView |
| CampaignTargetRoasTargetRoas | Double | CampaignTargetRoasTargetRoas column for table SearchTermView |
| CampaignTargetSpendCpcBidCeilingMicros | Long | CampaignTargetSpendCpcBidCeilingMicros column for table SearchTermView |
| CampaignTargetSpendTargetSpendMicros | Long | CampaignTargetSpendTargetSpendMicros column for table SearchTermView |
| CampaignTargetingSettingTargetRestrictions | String | CampaignTargetingSettingTargetRestrictions column for table SearchTermView |
| CampaignTrackingSettingTrackingUrl | String | CampaignTrackingSettingTrackingUrl column for table SearchTermView |
| CampaignTrackingUrlTemplate | String | CampaignTrackingUrlTemplate column for table SearchTermView |
| CampaignUrlCustomParameters | String | CampaignUrlCustomParameters column for table SearchTermView |
| CampaignVanityPharmaVanityPharmaDisplayUrlMode | String | CampaignVanityPharmaVanityPharmaDisplayUrlMode column for table SearchTermView |
| CampaignVanityPharmaVanityPharmaText | String | CampaignVanityPharmaVanityPharmaText column for table SearchTermView |
| CampaignVideoBrandSafetySuitability | String | CampaignVideoBrandSafetySuitability column for table SearchTermView |
| CustomerAutoTaggingEnabled | Bool | CustomerAutoTaggingEnabled column for table SearchTermView |
| CustomerCallReportingSettingCallConversionAction | String | CustomerCallReportingSettingCallConversionAction column for table SearchTermView |
| CustomerCallReportingSettingCallConversionReportingEnabled | Bool | CustomerCallReportingSettingCallConversionReportingEnabled column for table SearchTermView |
| CustomerCallReportingSettingCallReportingEnabled | Bool | CustomerCallReportingSettingCallReportingEnabled column for table SearchTermView |
| CustomerConversionTrackingSettingConversionTrackingId | Long | CustomerConversionTrackingSettingConversionTrackingId column for table SearchTermView |
| CustomerConversionTrackingSettingCrossAccountConversionTrackingId | Long | CustomerConversionTrackingSettingCrossAccountConversionTrackingId column for table SearchTermView |
| CustomerCurrencyCode | String | CustomerCurrencyCode column for table SearchTermView |
| CustomerDescriptiveName | String | CustomerDescriptiveName column for table SearchTermView |
| CustomerFinalUrlSuffix | String | CustomerFinalUrlSuffix column for table SearchTermView |
| CustomerHasPartnersBadge | Bool | CustomerHasPartnersBadge column for table SearchTermView |
| CustomerId | Long | CustomerId column for table SearchTermView |
| CustomerManager | Bool | CustomerManager column for table SearchTermView |
| CustomerPayPerConversionEligibilityFailureReasons | String | CustomerPayPerConversionEligibilityFailureReasons column for table SearchTermView |
| CustomerRemarketingSettingGoogleGlobalSiteTag | String | CustomerRemarketingSettingGoogleGlobalSiteTag column for table SearchTermView |
| CustomerResourceName | String | CustomerResourceName column for table SearchTermView |
| CustomerTestAccount | Bool | CustomerTestAccount column for table SearchTermView |
| CustomerTimeZone | String | CustomerTimeZone column for table SearchTermView |
| CustomerTrackingUrlTemplate | String | CustomerTrackingUrlTemplate column for table SearchTermView |
| AbsoluteTopImpressionPercentage | Double | AbsoluteTopImpressionPercentage column for table SearchTermView |
| AllConversions | Double | AllConversions column for table SearchTermView |
| AllConversionsFromInteractionsRate | Double | AllConversionsFromInteractionsRate column for table SearchTermView |
| AllConversionsFromInteractionsValuePerInteraction | Double | AllConversionsFromInteractionsValuePerInteraction column for table SearchTermView |
| AllConversionsValue | Double | AllConversionsValue column for table SearchTermView |
| AllConversionsValuePerCost | Double | AllConversionsValuePerCost column for table SearchTermView |
| AverageCost | Double | AverageCost column for table SearchTermView |
| AverageCpc | Double | AverageCpc column for table SearchTermView |
| AverageCpe | Double | AverageCpe column for table SearchTermView |
| AverageCpm | Double | AverageCpm column for table SearchTermView |
| AverageCpv | Double | AverageCpv column for table SearchTermView |
| Clicks | Long | Clicks column for table SearchTermView |
| Conversions | Double | Conversions column for table SearchTermView |
| ConversionsFromInteractionsRate | Double | ConversionsFromInteractionsRate column for table SearchTermView |
| ConversionsFromInteractionsValuePerInteraction | Double | ConversionsFromInteractionsValuePerInteraction column for table SearchTermView |
| ConversionsValue | Double | ConversionsValue column for table SearchTermView |
| ConversionsValuePerCost | Double | ConversionsValuePerCost column for table SearchTermView |
| CostMicros | Long | CostMicros column for table SearchTermView |
| CostPerAllConversions | Double | CostPerAllConversions column for table SearchTermView |
| CostPerConversion | Double | CostPerConversion column for table SearchTermView |
| CrossDeviceConversions | Double | CrossDeviceConversions column for table SearchTermView |
| Ctr | Double | Ctr column for table SearchTermView |
| EngagementRate | Double | EngagementRate column for table SearchTermView |
| Engagements | Long | Engagements column for table SearchTermView |
| Impressions | Long | Impressions column for table SearchTermView |
| InteractionEventTypes | String | InteractionEventTypes column for table SearchTermView |
| InteractionRate | Double | InteractionRate column for table SearchTermView |
| Interactions | Long | Interactions column for table SearchTermView |
| TopImpressionPercentage | Double | TopImpressionPercentage column for table SearchTermView |
| ValuePerAllConversions | Double | ValuePerAllConversions column for table SearchTermView |
| ValuePerConversion | Double | ValuePerConversion column for table SearchTermView |
| VideoQuartile100Rate | Double | VideoQuartile100Rate column for table SearchTermView |
| VideoQuartile25Rate | Double | VideoQuartile25Rate column for table SearchTermView |
| VideoQuartile50Rate | Double | VideoQuartile50Rate column for table SearchTermView |
| VideoQuartile75Rate | Double | VideoQuartile75Rate column for table SearchTermView |
| VideoViewRate | Double | VideoViewRate column for table SearchTermView |
| VideoViews | Long | VideoViews column for table SearchTermView |
| ViewThroughConversions | Long | ViewThroughConversions column for table SearchTermView |
| AdNetworkType | String | AdNetworkType column for table SearchTermView |
| ConversionAction | String | ConversionAction column for table SearchTermView |
| ConversionActionCategory | String | ConversionActionCategory column for table SearchTermView |
| ConversionActionName | String | ConversionActionName column for table SearchTermView |
| Date | Date | Date column for table SearchTermView |
| DayOfWeek | String | DayOfWeek column for table SearchTermView |
| Device | String | Device column for table SearchTermView |
| ExternalConversionSource | String | ExternalConversionSource column for table SearchTermView |
| KeywordAdGroupCriterion | String | KeywordAdGroupCriterion column for table SearchTermView |
| KeywordInfoMatchType | String | KeywordInfoMatchType column for table SearchTermView |
| KeywordInfoText | String | KeywordInfoText column for table SearchTermView |
| Month | Date | Month column for table SearchTermView |
| MonthOfYear | String | MonthOfYear column for table SearchTermView |
| Quarter | Date | Quarter column for table SearchTermView |
| SearchTermMatchType | String | SearchTermMatchType column for table SearchTermView |
| Week | Date | Week column for table SearchTermView |
| Year | Int | Year column for table SearchTermView |
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. |