Recommendation

A recommendation.

Proto definition

Fields

ad_group

string

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

campaign

string

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

campaign_budget

string

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

campaigns[]

string

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

dismissed

bool

Output only. Whether the recommendation is dismissed or not.

impact

RecommendationImpact

Output only. The impact on account performance as a result of applying the recommendation.

recommendation

Union field. The details of recommendation.

recommendation can be only one of the following:

call_asset_recommendation

CallAssetRecommendation

Output only. The call asset recommendation.

callout_asset_recommendation

CalloutAssetRecommendation

Output only. The callout asset recommendation.

campaign_budget_recommendation

CampaignBudgetRecommendation

Output only. The campaign budget recommendation.

custom_audience_opt_in_recommendation

CustomAudienceOptInRecommendation

Output only. The custom audience opt in recommendation.

display_expansion_opt_in_recommendation

DisplayExpansionOptInRecommendation

Output only. The Display Expansion opt-in recommendation.

dynamic_image_extension_opt_in_recommendation

DynamicImageExtensionOptInRecommendation

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.

enhanced_cpc_opt_in_recommendation

EnhancedCpcOptInRecommendation

Output only. The Enhanced Cost-Per-Click Opt-In recommendation.

forecasting_campaign_budget_recommendation

CampaignBudgetRecommendation

Output only. The forecasting campaign budget recommendation.

forecasting_set_target_cpa_recommendation

ForecastingSetTargetCpaRecommendation

Output only. The forecasting set target CPA recommendation.

forecasting_set_target_roas_recommendation

ForecastingSetTargetRoasRecommendation

Output only. The forecasting set target ROAS recommendation.

improve_demand_gen_ad_strength_recommendation

ImproveDemandGenAdStrengthRecommendation

Output only. The improve Demand Gen ad strength recommendation.

improve_google_tag_coverage_recommendation

ImproveGoogleTagCoverageRecommendation

Output only. Recommendation to deploy Google Tag on more pages.

improve_performance_max_ad_strength_recommendation

ImprovePerformanceMaxAdStrengthRecommendation

Output only. The improve Performance Max ad strength recommendation.

keyword_match_type_recommendation

KeywordMatchTypeRecommendation

Output only. The keyword match type recommendation.

keyword_recommendation

KeywordRecommendation

Output only. The keyword recommendation.

lead_form_asset_recommendation

LeadFormAssetRecommendation

Output only. The lead form asset recommendation.

lower_target_roas_recommendation

LowerTargetRoasRecommendation

Output only. Recommendation to lower Target ROAS.

marginal_roi_campaign_budget_recommendation

CampaignBudgetRecommendation

Output only. The marginal ROI campaign budget recommendation.

maximize_clicks_opt_in_recommendation

MaximizeClicksOptInRecommendation

Output only. The MaximizeClicks Opt-In recommendation.

maximize_conversion_value_opt_in_recommendation

MaximizeConversionValueOptInRecommendation

Output only. The Maximize Conversion Value opt-in recommendation.

maximize_conversions_opt_in_recommendation

MaximizeConversionsOptInRecommendation

Output only. The MaximizeConversions Opt-In recommendation.

migrate_dynamic_search_ads_campaign_to_performance_max_recommendation

MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation

Output only. The Dynamic Search Ads to Performance Max migration recommendation.

move_unused_budget_recommendation

MoveUnusedBudgetRecommendation

Output only. The move unused budget recommendation.

optimize_ad_rotation_recommendation

OptimizeAdRotationRecommendation

Output only. The Optimize Ad Rotation recommendation.

performance_max_final_url_opt_in_recommendation

PerformanceMaxFinalUrlOptInRecommendation

Output only. Recommendation to turn on Final URL expansion for your Performance Max campaigns.

performance_max_opt_in_recommendation

PerformanceMaxOptInRecommendation

Output only. The Performance Max Opt In recommendation.

raise_target_cpa_bid_too_low_recommendation

RaiseTargetCpaBidTooLowRecommendation

Output only. The raise target CPA bid too low recommendation.

raise_target_cpa_recommendation

RaiseTargetCpaRecommendation

Output only. Recommendation to raise Target CPA.

refresh_customer_match_list_recommendation

RefreshCustomerMatchListRecommendation

Output only. The refresh customer list recommendation.

responsive_search_ad_asset_recommendation

ResponsiveSearchAdAssetRecommendation

Output only. The responsive search ad asset recommendation.

responsive_search_ad_improve_ad_strength_recommendation

ResponsiveSearchAdImproveAdStrengthRecommendation

Output only. The responsive search ad improve ad strength recommendation.

responsive_search_ad_recommendation

ResponsiveSearchAdRecommendation

Output only. The add responsive search ad recommendation.

search_partners_opt_in_recommendation

SearchPartnersOptInRecommendation

Output only. The Search Partners Opt-In recommendation.

set_target_cpa_recommendation

ForecastingSetTargetCpaRecommendation

Output only. The set target CPA recommendation.

set_target_roas_recommendation

ForecastingSetTargetRoasRecommendation

Output only. The set target ROAS recommendation.

shopping_add_age_group_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add age group recommendation.

shopping_add_color_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add color recommendation.

shopping_add_gender_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add gender recommendation.

shopping_add_gtin_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add GTIN recommendation.

shopping_add_more_identifiers_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add more identifiers recommendation.

shopping_add_products_to_campaign_recommendation

ShoppingAddProductsToCampaignRecommendation

Output only. The shopping add products to campaign recommendation.

shopping_add_size_recommendation

ShoppingOfferAttributeRecommendation

Output only. The shopping add size recommendation.

shopping_fix_disapproved_products_recommendation

ShoppingFixDisapprovedProductsRecommendation

Output only. The shopping fix disapproved products recommendation.

shopping_fix_merchant_center_account_suspension_warning_recommendation

ShoppingMerchantCenterAccountSuspensionRecommendation

Output only. The shopping fix Merchant Center account suspension warning recommendation.

shopping_fix_suspended_merchant_center_account_recommendation

ShoppingMerchantCenterAccountSuspensionRecommendation

Output only. The shopping fix suspended Merchant Center account recommendation.

shopping_migrate_regular_shopping_campaign_offers_to_performance_max_recommendation

ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation

Output only. The shopping migrate Regular Shopping Campaign offers to Performance Max recommendation.

shopping_target_all_offers_recommendation

ShoppingTargetAllOffersRecommendation

Output only. The shopping target all offers recommendation.

sitelink_asset_recommendation

SitelinkAssetRecommendation

Output only. The sitelink asset recommendation.

target_cpa_opt_in_recommendation

TargetCpaOptInRecommendation

Output only. The TargetCPA opt-in recommendation.

target_roas_opt_in_recommendation

TargetRoasOptInRecommendation

Output only. The Target ROAS opt-in recommendation.

text_ad_recommendation

TextAdRecommendation

Output only. Add expanded text ad recommendation.

upgrade_local_campaign_to_performance_max_recommendation

UpgradeLocalCampaignToPerformanceMaxRecommendation

Output only. The upgrade a Local campaign to a Performance Max campaign recommendation.

upgrade_smart_shopping_campaign_to_performance_max_recommendation

UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation

Output only. The upgrade a Smart Shopping campaign to a Performance Max campaign recommendation.

use_broad_match_keyword_recommendation

UseBroadMatchKeywordRecommendation

Output only. The use broad match keyword recommendation.

resource_name

string

Immutable. The resource name of the recommendation.

customers/{customer_id}/recommendations/{recommendation_id}

type

RecommendationType

Output only. The type of recommendation.

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

Last updated 2026-01-22 UTC.