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

recommendation

The recommendation referenced in the query.

Selectable with

Attributed resources

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

ad_group
campaign
campaign_budget
customer

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.v1.resources.Recommendation.CallExtensionRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.callout_extension_recommendation

Field descriptionThe Callout extension recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v1.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.v1.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.v1.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.v1.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.v1.resources.Recommendation.KeywordMatchTypeRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.keyword_recommendation

Field descriptionThe keyword recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v1.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.v1.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.v1.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.v1.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.v1.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.v1.resources.Recommendation.SearchPartnersOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.sitelink_extension_recommendation

Field descriptionThe Sitelink extension recommendation.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v1.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.v1.resources.Recommendation.TargetCpaOptInRecommendation
FilterableFalse
SelectableTrue
SortableFalse
RepeatedFalse

recommendation.text_ad_recommendation

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

recommendation.type

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