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_asset_recommendation

Field description Output only. The call asset recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.CallAssetRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.callout_asset_recommendation

Field description Output only. The callout asset recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.CalloutAssetRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.campaign

Field description Output only. The campaign targeted by this recommendation. 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, SHOPPING_ADD_AGE_GROUP, SHOPPING_ADD_COLOR, SHOPPING_ADD_GENDER, SHOPPING_ADD_SIZE, SHOPPING_ADD_GTIN, SHOPPING_ADD_MORE_IDENTIFIERS, SHOPPING_ADD_PRODUCTS_TO_CAMPAIGN, SHOPPING_FIX_DISAPPROVED_PRODUCTS, SHOPPING_MIGRATE_REGULAR_SHOPPING_CAMPAIGN_OFFERS_TO_PERFORMANCE_MAX, DYNAMIC_IMAGE_EXTENSION_OPT_IN, RAISE_TARGET_CPA, LOWER_TARGET_ROAS, FORECASTING_SET_TARGET_CPA, SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN, IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN
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.v16.resources.Recommendation.CampaignBudgetRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.campaigns

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

recommendation.custom_audience_opt_in_recommendation

Field description Output only. The custom audience opt in recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.CustomAudienceOptInRecommendation
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.v16.resources.Recommendation.DisplayExpansionOptInRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.dynamic_image_extension_opt_in_recommendation

Field description Output only. Recommendation to enable dynamic image extensions on the account, allowing Google to find the best images from ad landing pages and complement text ads.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.DynamicImageExtensionOptInRecommendation
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.v16.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.v16.resources.Recommendation.CampaignBudgetRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.forecasting_set_target_cpa_recommendation

Field description Output only. The forecasting set target CPA recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ForecastingSetTargetCpaRecommendation
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.v16.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.v16.resources.Recommendation.RecommendationImpact
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.improve_demand_gen_ad_strength_recommendation

Field description Output only. The improve Demand Gen ad strength recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ImproveDemandGenAdStrengthRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.improve_google_tag_coverage_recommendation

Field description Output only. Recommendation to deploy Google Tag on more pages.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ImproveGoogleTagCoverageRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.improve_performance_max_ad_strength_recommendation

Field description Output only. The improve Performance Max ad strength recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ImprovePerformanceMaxAdStrengthRecommendation
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.v16.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.v16.resources.Recommendation.KeywordRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.lead_form_asset_recommendation

Field description Output only. The lead form asset recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.LeadFormAssetRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.lower_target_roas_recommendation

Field description Output only. Recommendation to lower Target ROAS.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.LowerTargetRoasRecommendation
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.v16.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.v16.resources.Recommendation.MaximizeClicksOptInRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.maximize_conversion_value_opt_in_recommendation

Field description Output only. The Maximize Conversion Value opt-in recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.MaximizeConversionValueOptInRecommendation
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.v16.resources.Recommendation.MaximizeConversionsOptInRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.migrate_dynamic_search_ads_campaign_to_performance_max_recommendation

Field description Output only. The Dynamic Search Ads to Performance Max migration recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
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.v16.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.v16.resources.Recommendation.OptimizeAdRotationRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.performance_max_final_url_opt_in_recommendation

Field description Output only. Recommendation to turn on Final URL expansion for your Performance Max campaigns.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.PerformanceMaxFinalUrlOptInRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.performance_max_opt_in_recommendation

Field description Output only. The Performance Max Opt In recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.PerformanceMaxOptInRecommendation
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.v16.resources.Recommendation.RaiseTargetCpaBidTooLowRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.raise_target_cpa_recommendation

Field description Output only. Recommendation to raise Target CPA.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.RaiseTargetCpaRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.refresh_customer_match_list_recommendation

Field description Output only. The refresh customer list recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.RefreshCustomerMatchListRecommendation
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.v16.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.v16.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.v16.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.v16.resources.Recommendation.SearchPartnersOptInRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.set_target_cpa_recommendation

Field description Output only. The set target CPA recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ForecastingSetTargetCpaRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.set_target_roas_recommendation

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

recommendation.shopping_add_age_group_recommendation

Field description Output only. The shopping add age group recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_color_recommendation

Field description Output only. The shopping add color recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_gender_recommendation

Field description Output only. The shopping add gender recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_gtin_recommendation

Field description Output only. The shopping add GTIN recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_more_identifiers_recommendation

Field description Output only. The shopping add more identifiers recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_products_to_campaign_recommendation

Field description Output only. The shopping add products to campaign recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingAddProductsToCampaignRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_add_size_recommendation

Field description Output only. The shopping add size recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingOfferAttributeRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_fix_disapproved_products_recommendation

Field description Output only. The shopping fix disapproved products recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingFixDisapprovedProductsRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_fix_merchant_center_account_suspension_warning_recommendation

Field description Output only. The shopping fix Merchant Center account suspension warning recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingMerchantCenterAccountSuspensionRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_fix_suspended_merchant_center_account_recommendation

Field description Output only. The shopping fix suspended Merchant Center account recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingMerchantCenterAccountSuspensionRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_migrate_regular_shopping_campaign_offers_to_performance_max_recommendation

Field description Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
Filterable False
Selectable True
Sortable False
Repeated False

recommendation.shopping_target_all_offers_recommendation

Field description Output only. The shopping target all offers recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.ShoppingTargetAllOffersRecommendation
Filterable False
Selectable True
Sortable False
Repeated False
Field description Output only. The sitelink asset recommendation.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v16.resources.Recommendation.SitelinkAssetRecommendation
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.v16.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.v16.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.v16.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
Type URL google.ads.googleads.v16.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.v16.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.v16.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.v16.resources.Recommendation.UseBroadMatchKeywordRecommendation
Filterable False
Selectable True
Sortable False
Repeated False