Google Ads API is returning to beta status. Please read our blog post for more details.

recommendation

The recommendation referenced in the query.
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 (if exist).

recommendation.ad_group

Field descriptionThe 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, TEXT_AD
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.call_extension_recommendation

Field descriptionThe Call extension recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.CallExtensionRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.callout_extension_recommendation

Field descriptionThe Callout extension recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.CalloutExtensionRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.campaign

Field descriptionThe 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, KEYWORD, KEYWORD_MATCH_TYPE, MAXIMIZE_CLICKS_OPT_IN, MAXIMIZE_CONVERSIONS_OPT_IN, OPTIMIZE_AD_ROTATION, SEARCH_PARTNERS_OPT_IN, SITELINK_EXTENSION, TARGET_CPA_OPT_IN, TEXT_AD
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.campaign_budget

Field descriptionThe 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, MOVE_UNUSED_BUDGET
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.campaign_budget_recommendation

Field descriptionThe campaign budget recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.CampaignBudgetRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.dismissed

Field descriptionWhether the recommendation is dismissed or not.
CategoryATTRIBUTE
Data TypeBOOLEAN
Type URLgoogle.protobuf.BoolValue
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.enhanced_cpc_opt_in_recommendation

Field descriptionThe Enhanced Cost-Per-Click Opt-In recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.EnhancedCpcOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.impact

Field descriptionThe impact on account performance as a result of applying the recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.RecommendationImpact
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.keyword_match_type_recommendation

Field descriptionThe keyword match type recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.KeywordMatchTypeRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.keyword_recommendation

Field descriptionThe keyword recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.KeywordRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.maximize_clicks_opt_in_recommendation

Field descriptionThe MaximizeClicks Opt-In recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.MaximizeClicksOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.maximize_conversions_opt_in_recommendation

Field descriptionThe MaximizeConversions Opt-In recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.MaximizeConversionsOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.move_unused_budget_recommendation

Field descriptionThe move unused budget recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.MoveUnusedBudgetRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.optimize_ad_rotation_recommendation

Field descriptionThe Optimize Ad Rotation recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.OptimizeAdRotationRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.resource_name

Field descriptionThe resource name of the recommendation. `customers/{customer_id}/recommendations/{recommendation_id}`
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.search_partners_opt_in_recommendation

Field descriptionThe Search Partners Opt-In recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.SearchPartnersOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.sitelink_extension_recommendation

Field descriptionThe Sitelink extension recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.SitelinkExtensionRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.target_cpa_opt_in_recommendation

Field descriptionThe TargetCPA opt-in recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.TargetCpaOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.text_ad_recommendation

Field descriptionAdd expanded text ad recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v2.resources.Recommendation.TextAdRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.type

Field descriptionThe type of recommendation.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v2.enums.RecommendationTypeEnum.RecommendationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse