recommendation

A recommendation.

Attributed resources
ad_group
campaign
campaign_budget
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

recommendation.ad_group
Field description	Output only. The ad group targeted by this recommendation. This will be set only when the recommendation affects a single ad group. This field will be set for the following recommendation types: KEYWORD, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, TEXT_AD
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

recommendation.call_extension_recommendation
Field description	Output only. The Call extension recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.CallExtensionRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.callout_extension_recommendation
Field description	Output only. The Callout extension recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.CalloutExtensionRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.campaign
Field description	Output only. The campaign targeted by this recommendation. This will be set only when the recommendation affects a single campaign. This field will be set for the following recommendation types: CALL_EXTENSION, CALLOUT_EXTENSION, ENHANCED_CPC_OPT_IN, USE_BROAD_MATCH_KEYWORD, KEYWORD, KEYWORD_MATCH_TYPE, UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, RESPONSIVE_SEARCH_AD, RESPONSIVE_SEARCH_AD_ASSET, SEARCH_PARTNERS_OPT_IN, DISPLAY_EXPANSION_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TARGET_ROAS_OPT_IN, TEXT_AD, UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX , RAISE_TARGET_CPA_BID_TOO_LOW, FORECASTING_SET_TARGET_ROAS
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

recommendation.campaign_budget
Field description	Output only. The budget targeted by this recommendation. This will be set only when the recommendation affects a single campaign budget. This field will be set for the following recommendation types: CAMPAIGN_BUDGET, FORECASTING_CAMPAIGN_BUDGET, MARGINAL_ROI_CAMPAIGN_BUDGET, MOVE_UNUSED_BUDGET
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

recommendation.campaign_budget_recommendation
Field description	Output only. The campaign budget recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.CampaignBudgetRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.dismissed
Field description	Output only. Whether the recommendation is dismissed or not.
Category	`ATTRIBUTE`
Data Type	`BOOLEAN`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

recommendation.display_expansion_opt_in_recommendation
Field description	Output only. The Display Expansion opt-in recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.DisplayExpansionOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.enhanced_cpc_opt_in_recommendation
Field description	Output only. The Enhanced Cost-Per-Click Opt-In recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.EnhancedCpcOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.forecasting_campaign_budget_recommendation
Field description	Output only. The forecasting campaign budget recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.CampaignBudgetRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.forecasting_set_target_roas_recommendation
Field description	Output only. The forecasting set target ROAS recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.ForecastingSetTargetRoasRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.impact
Field description	Output only. The impact on account performance as a result of applying the recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.RecommendationImpact`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.keyword_match_type_recommendation
Field description	Output only. The keyword match type recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.KeywordMatchTypeRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.keyword_recommendation
Field description	Output only. The keyword recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.KeywordRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.marginal_roi_campaign_budget_recommendation
Field description	Output only. The marginal ROI campaign budget recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.CampaignBudgetRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.maximize_clicks_opt_in_recommendation
Field description	Output only. The MaximizeClicks Opt-In recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.MaximizeClicksOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.maximize_conversions_opt_in_recommendation
Field description	Output only. The MaximizeConversions Opt-In recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.MaximizeConversionsOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.move_unused_budget_recommendation
Field description	Output only. The move unused budget recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.MoveUnusedBudgetRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.optimize_ad_rotation_recommendation
Field description	Output only. The Optimize Ad Rotation recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.OptimizeAdRotationRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.raise_target_cpa_bid_too_low_recommendation
Field description	Output only. The raise target CPA bid too low recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.RaiseTargetCpaBidTooLowRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.resource_name
Field description	Immutable. The resource name of the recommendation. `customers/{customer_id}/recommendations/{recommendation_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

recommendation.responsive_search_ad_asset_recommendation
Field description	Output only. The responsive search ad asset recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.ResponsiveSearchAdAssetRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.responsive_search_ad_improve_ad_strength_recommendation
Field description	Output only. The responsive search ad improve ad strength recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.ResponsiveSearchAdImproveAdStrengthRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.responsive_search_ad_recommendation
Field description	Output only. The add responsive search ad recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.ResponsiveSearchAdRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.search_partners_opt_in_recommendation
Field description	Output only. The Search Partners Opt-In recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.SearchPartnersOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.sitelink_extension_recommendation
Field description	Output only. The Sitelink extension recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.SitelinkExtensionRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.target_cpa_opt_in_recommendation
Field description	Output only. The TargetCPA opt-in recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.TargetCpaOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.target_roas_opt_in_recommendation
Field description	Output only. The Target ROAS opt-in recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.TargetRoasOptInRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.text_ad_recommendation
Field description	Output only. Add expanded text ad recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.TextAdRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.type
Field description	Output only. The type of recommendation.
Category	`ATTRIBUTE`
Data Type	ENUM CALLOUT_EXTENSION CALL_EXTENSION CAMPAIGN_BUDGET DISPLAY_EXPANSION_OPT_IN ENHANCED_CPC_OPT_IN FORECASTING_CAMPAIGN_BUDGET FORECASTING_SET_TARGET_ROAS KEYWORD KEYWORD_MATCH_TYPE MARGINAL_ROI_CAMPAIGN_BUDGET MAXIMIZE_CLICKS_OPT_IN MAXIMIZE_CONVERSIONS_OPT_IN MOVE_UNUSED_BUDGET OPTIMIZE_AD_ROTATION RAISE_TARGET_CPA_BID_TOO_LOW RESPONSIVE_SEARCH_AD RESPONSIVE_SEARCH_AD_ASSET RESPONSIVE_SEARCH_AD_IMPROVE_AD_STRENGTH SEARCH_PARTNERS_OPT_IN SITELINK_EXTENSION TARGET_CPA_OPT_IN TARGET_ROAS_OPT_IN TEXT_AD UNKNOWN UNSPECIFIED UPGRADE_LOCAL_CAMPAIGN_TO_PERFORMANCE_MAX UPGRADE_SMART_SHOPPING_CAMPAIGN_TO_PERFORMANCE_MAX USE_BROAD_MATCH_KEYWORD
Type URL	`google.ads.googleads.v12.enums.RecommendationTypeEnum.RecommendationType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

recommendation.upgrade_local_campaign_to_performance_max_recommendation
Field description	Output only. The upgrade a Local campaign to a Performance Max campaign recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.UpgradeLocalCampaignToPerformanceMaxRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.upgrade_smart_shopping_campaign_to_performance_max_recommendation
Field description	Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

recommendation.use_broad_match_keyword_recommendation
Field description	Output only. The use broad match keyword recommendation.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v12.resources.Recommendation.UseBroadMatchKeywordRecommendation`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-06-05 UTC.

Blog
Visit our blog for important announcements.
Forum
Interact with our community of developer experts.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.