--- v15/resources/recommendation.proto 2023-10-18 20:10:59.000000000 +0000
+++ v16/resources/recommendation.proto 2024-02-20 20:02:50.000000000 +0000
@@ -1,858 +1,971 @@
// Copyright 2023 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
syntax = "proto3";
-package google.ads.googleads.v15.resources;
+package google.ads.googleads.v16.resources;
-import "google/ads/googleads/v15/common/criteria.proto";
-import "google/ads/googleads/v15/enums/app_bidding_goal.proto";
-import "google/ads/googleads/v15/enums/keyword_match_type.proto";
-import "google/ads/googleads/v15/enums/recommendation_type.proto";
-import "google/ads/googleads/v15/enums/shopping_add_products_to_campaign_recommendation_enum.proto";
-import "google/ads/googleads/v15/enums/target_cpa_opt_in_recommendation_goal.proto";
-import "google/ads/googleads/v15/resources/ad.proto";
-import "google/ads/googleads/v15/resources/asset.proto";
+import "google/ads/googleads/v16/common/criteria.proto";
+import "google/ads/googleads/v16/enums/ad_strength.proto";
+import "google/ads/googleads/v16/enums/app_bidding_goal.proto";
+import "google/ads/googleads/v16/enums/keyword_match_type.proto";
+import "google/ads/googleads/v16/enums/recommendation_type.proto";
+import "google/ads/googleads/v16/enums/shopping_add_products_to_campaign_recommendation_enum.proto";
+import "google/ads/googleads/v16/enums/target_cpa_opt_in_recommendation_goal.proto";
+import "google/ads/googleads/v16/resources/ad.proto";
+import "google/ads/googleads/v16/resources/asset.proto";
import "google/api/field_behavior.proto";
import "google/api/resource.proto";
-option csharp_namespace = "Google.Ads.GoogleAds.V15.Resources";
-option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v15/resources;resources";
+option csharp_namespace = "Google.Ads.GoogleAds.V16.Resources";
+option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v16/resources;resources";
option java_multiple_files = true;
option java_outer_classname = "RecommendationProto";
-option java_package = "com.google.ads.googleads.v15.resources";
+option java_package = "com.google.ads.googleads.v16.resources";
option objc_class_prefix = "GAA";
-option php_namespace = "Google\\Ads\\GoogleAds\\V15\\Resources";
-option ruby_package = "Google::Ads::GoogleAds::V15::Resources";
+option php_namespace = "Google\\Ads\\GoogleAds\\V16\\Resources";
+option ruby_package = "Google::Ads::GoogleAds::V16::Resources";
// Proto file describing the Recommendation resource.
// A recommendation.
message Recommendation {
option (google.api.resource) = {
type: "googleads.googleapis.com/Recommendation"
pattern: "customers/{customer_id}/recommendations/{recommendation_id}"
};
// The Merchant Center account details.
message MerchantInfo {
// Output only. The Merchant Center account ID.
int64 id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The name of the Merchant Center account.
string name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Whether the Merchant Center account is a Multi-Client
// account (MCA).
bool multi_client = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The impact of making the change as described in the recommendation.
// Some types of recommendations may not have impact information.
message RecommendationImpact {
// Output only. Base metrics at the time the recommendation was generated.
RecommendationMetrics base_metrics = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Estimated metrics if the recommendation is applied.
RecommendationMetrics potential_metrics = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Weekly account performance metrics. For some recommendation types, these
// are averaged over the past 90-day period and hence can be fractional.
message RecommendationMetrics {
// Output only. Number of ad impressions.
optional double impressions = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Number of ad clicks.
optional double clicks = 7 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Cost (in micros) for advertising, in the local currency for
// the account.
optional int64 cost_micros = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Number of conversions.
optional double conversions = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+ // Output only. Sum of the conversion value of the conversions.
+ optional double conversions_value = 11
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
// Output only. Number of video views for a video ad campaign.
optional double video_views = 10
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The budget recommendation for budget constrained campaigns.
message CampaignBudgetRecommendation {
// The impact estimates for a given budget amount.
message CampaignBudgetRecommendationOption {
// Output only. The budget amount for this option.
optional int64 budget_amount_micros = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The impact estimate if budget is changed to amount
// specified in this option.
RecommendationImpact impact = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Output only. The current budget amount in micros.
optional int64 current_budget_amount_micros = 7
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommended budget amount in micros.
optional int64 recommended_budget_amount_micros = 8
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The budget amounts and associated impact estimates for some
// values of possible budget amounts.
repeated CampaignBudgetRecommendationOption budget_options = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The keyword recommendation.
message KeywordRecommendation {
// Information about a search term as related to a keyword recommendation.
message SearchTerm {
// Output only. The text of the search term.
string text = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Estimated number of historical weekly searches for this
// search term.
int64 estimated_weekly_search_count = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Output only. The recommended keyword.
- google.ads.googleads.v15.common.KeywordInfo keyword = 1
+ google.ads.googleads.v16.common.KeywordInfo keyword = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. A list of search terms this keyword matches. The same search
// term may be repeated for multiple keywords.
repeated SearchTerm search_terms = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommended CPC (cost-per-click) bid.
optional int64 recommended_cpc_bid_micros = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The text ad recommendation.
message TextAdRecommendation {
// Output only. Recommended ad.
Ad ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Creation date of the recommended ad.
// YYYY-MM-DD format, for example, 2018-04-17.
optional string creation_date = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Date, if present, is the earliest when the recommendation
// will be auto applied. YYYY-MM-DD format, for example, 2018-04-17.
optional string auto_apply_date = 5
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Target CPA opt-in recommendation.
message TargetCpaOptInRecommendation {
// The Target CPA opt-in option with impact estimate.
message TargetCpaOptInRecommendationOption {
// Output only. The goal achieved by this option.
- google.ads.googleads.v15.enums.TargetCpaOptInRecommendationGoalEnum
+ google.ads.googleads.v16.enums.TargetCpaOptInRecommendationGoalEnum
.TargetCpaOptInRecommendationGoal goal = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Average CPA target.
optional int64 target_cpa_micros = 5
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The minimum campaign budget, in local currency for the
// account, required to achieve the target CPA. Amount is specified in
// micros, where one million is equivalent to one currency unit.
optional int64 required_campaign_budget_amount_micros = 6
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The impact estimate if this option is selected.
RecommendationImpact impact = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Output only. The available goals and corresponding options for Target CPA
// strategy.
repeated TargetCpaOptInRecommendationOption options = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommended average CPA target. See required budget
// amount and impact of using this recommendation in options list.
optional int64 recommended_target_cpa_micros = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Maximize Conversions Opt-In recommendation.
message MaximizeConversionsOptInRecommendation {
// Output only. The recommended new budget amount.
optional int64 recommended_budget_amount_micros = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Enhanced Cost-Per-Click Opt-In recommendation.
message EnhancedCpcOptInRecommendation {}
// The Search Partners Opt-In recommendation.
message SearchPartnersOptInRecommendation {}
// The Maximize Clicks opt-in recommendation.
message MaximizeClicksOptInRecommendation {
// Output only. The recommended new budget amount.
// Only set if the current budget is too high.
optional int64 recommended_budget_amount_micros = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Optimize Ad Rotation recommendation.
message OptimizeAdRotationRecommendation {}
// The callout asset recommendation.
message CalloutAssetRecommendation {
// Output only. New callout extension assets recommended at the campaign
// level.
repeated Asset recommended_campaign_callout_assets = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. New callout extension assets recommended at the customer
// level.
repeated Asset recommended_customer_callout_assets = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The sitelink asset recommendation.
message SitelinkAssetRecommendation {
// Output only. New sitelink assets recommended at the campaign level.
repeated Asset recommended_campaign_sitelink_assets = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. New sitelink assets recommended at the customer level.
repeated Asset recommended_customer_sitelink_assets = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The call asset recommendation.
message CallAssetRecommendation {}
// The keyword match type recommendation.
message KeywordMatchTypeRecommendation {
// Output only. The existing keyword where the match type should be more
// broad.
- google.ads.googleads.v15.common.KeywordInfo keyword = 1
+ google.ads.googleads.v16.common.KeywordInfo keyword = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommended new match type.
- google.ads.googleads.v15.enums.KeywordMatchTypeEnum.KeywordMatchType
+ google.ads.googleads.v16.enums.KeywordMatchTypeEnum.KeywordMatchType
recommended_match_type = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The move unused budget recommendation.
message MoveUnusedBudgetRecommendation {
// Output only. The excess budget's resource_name.
optional string excess_campaign_budget = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommendation for the constrained budget to increase.
CampaignBudgetRecommendation budget_recommendation = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Target ROAS opt-in recommendation.
message TargetRoasOptInRecommendation {
// Output only. The recommended target ROAS (revenue per unit of spend).
// The value is between 0.01 and 1000.0, inclusive.
optional double recommended_target_roas = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The minimum campaign budget, in local currency for the
// account, required to achieve the target ROAS. Amount is specified in
// micros, where one million is equivalent to one currency unit.
optional int64 required_campaign_budget_amount_micros = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The add responsive search ad asset recommendation.
message ResponsiveSearchAdAssetRecommendation {
// Output only. The current ad to be updated.
Ad current_ad = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The recommended assets. This is populated only with the new
// headlines and/or descriptions, and is otherwise empty.
Ad recommended_assets = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The responsive search ad improve ad strength recommendation.
message ResponsiveSearchAdImproveAdStrengthRecommendation {
// Output only. The current ad to be updated.
Ad current_ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The updated ad.
Ad recommended_ad = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The add responsive search ad recommendation.
message ResponsiveSearchAdRecommendation {
// Output only. Recommended ad.
Ad ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The use broad match keyword recommendation.
message UseBroadMatchKeywordRecommendation {
// Output only. Sample of keywords to be expanded to Broad Match.
- repeated google.ads.googleads.v15.common.KeywordInfo keyword = 1
+ repeated google.ads.googleads.v16.common.KeywordInfo keyword = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Total number of keywords to be expanded to Broad Match in
// the campaign.
int64 suggested_keywords_count = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Total number of keywords in the campaign.
int64 campaign_keywords_count = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Whether the associated campaign uses a shared budget.
bool campaign_uses_shared_budget = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The budget recommended to avoid becoming budget constrained
// after applying the recommendation.
int64 required_campaign_budget_amount_micros = 5
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The upgrade a Smart Shopping campaign to a Performance Max campaign
// recommendation.
message UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation {
// Output only. ID of Merchant Center account.
int64 merchant_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Country whose products from merchant's inventory should be
// included.
string sales_country_code = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The raise target CPA bid too low recommendation.
message RaiseTargetCpaBidTooLowRecommendation {
// Output only. A number greater than 1.0 indicating the factor by which we
// recommend the target CPA should be increased.
optional double recommended_target_multiplier = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The current average target CPA of the campaign, in micros of
// customer local currency.
optional int64 average_target_cpa_micros = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Display Expansion opt-in recommendation.
message DisplayExpansionOptInRecommendation {}
// The Upgrade Local campaign to Performance Max campaign recommendation.
message UpgradeLocalCampaignToPerformanceMaxRecommendation {}
// The forecasting set target ROAS recommendation.
message ForecastingSetTargetRoasRecommendation {
// Output only. The recommended target ROAS (revenue per unit of spend).
// The value is between 0.01 and 1000.0, inclusive.
double recommended_target_roas = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The campaign budget.
CampaignBudget campaign_budget = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to add an attribute to offers that are demoted
// because it is missing.
message ShoppingOfferAttributeRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The campaign feed label.
string feed_label = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The number of online, servable offers.
int64 offers_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The number of online, servable offers that are demoted for
// missing attributes. Visit the Merchant Center for more details.
int64 demoted_offers_count = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to fix disapproved products in a Shopping
// Campaign Inventory.
message ShoppingFixDisapprovedProductsRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The feed label for the campaign.
string feed_label = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The number of products of the campaign.
int64 products_count = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The numbers of products of the campaign that are
// disapproved.
int64 disapproved_products_count = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to create a catch-all campaign that targets all
// offers.
message ShoppingTargetAllOffersRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The number of untargeted offers.
int64 untargeted_offers_count = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The offer feed label.
string feed_label = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to add products to a Shopping Campaign
// Inventory.
message ShoppingAddProductsToCampaignRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The feed label for the campaign.
string feed_label = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The reason why no products are attached to the campaign.
- google.ads.googleads.v15.enums
+ google.ads.googleads.v16.enums
.ShoppingAddProductsToCampaignRecommendationEnum.Reason reason = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to fix Merchant Center account suspension
// issues.
message ShoppingMerchantCenterAccountSuspensionRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The feed label of the campaign for which the suspension
// happened.
string feed_label = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The shopping recommendation to migrate Regular Shopping Campaign targeted
// offers to Performance Max campaigns.
message
ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation {
// Output only. The details of the Merchant Center account.
MerchantInfo merchant = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The feed label of the offers targeted by the campaigns
// sharing this suggestion.
string feed_label = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// Information of a target adjustment recommendation.
message TargetAdjustmentInfo {
// Output only. The shared set resource name of the portfolio bidding
// strategy where the target is defined. Only populated if the
// recommendation is portfolio level.
optional string shared_set = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The factor by which we recommend the target to be adjusted
// by.
double recommended_target_multiplier = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The current average target of the campaign or portfolio
// targeted by this recommendation.
int64 current_average_target_micros = 3
[(google.api.field_behavior) = OUTPUT_ONLY];
}
// Recommendation to raise Target CPA.
message RaiseTargetCpaRecommendation {
// Output only. The relevant information describing the recommended target
// adjustment.
TargetAdjustmentInfo target_adjustment = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Represents the goal towards which the bidding strategy
// should optimize. Only populated for App Campaigns.
- optional google.ads.googleads.v15.enums.AppBiddingGoalEnum.AppBiddingGoal
+ optional google.ads.googleads.v16.enums.AppBiddingGoalEnum.AppBiddingGoal
app_bidding_goal = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// Recommendation to lower Target ROAS.
message LowerTargetRoasRecommendation {
// Output only. The relevant information describing the recommended target
// adjustment.
TargetAdjustmentInfo target_adjustment = 1
[(google.api.field_behavior) = 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.
message DynamicImageExtensionOptInRecommendation {}
// A campaign budget shared amongst various budget recommendation types.
message CampaignBudget {
// Output only. Current budget amount.
int64 current_amount_micros = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Recommended budget amount.
int64 recommended_new_amount_micros = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The date when the new budget would start being used.
// This field will be set for the following recommendation types:
// FORECASTING_SET_TARGET_ROAS , FORECASTING_SET_TARGET_CPA
// YYYY-MM-DD format, for example, 2018-04-17.
string new_start_date = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Performance Max Opt In recommendation.
message PerformanceMaxOptInRecommendation {}
// Recommendation to improve the asset group strength of a Performance Max
// campaign to an "Excellent" rating.
message ImprovePerformanceMaxAdStrengthRecommendation {
// Output only. The asset group resource name.
string asset_group = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The Dynamic Search Ads to Performance Max migration recommendation.
message MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation {
// Output only. A link to the Google Ads UI where the customer can manually
// apply the recommendation.
string apply_link = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
}
// The set target CPA recommendations.
message ForecastingSetTargetCpaRecommendation {
// Output only. The recommended target CPA.
int64 recommended_target_cpa_micros = 1
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The campaign budget.
CampaignBudget campaign_budget = 2
[(google.api.field_behavior) = OUTPUT_ONLY];
}
+ // Recommendation to opt into Maximize Conversion Value bidding strategy.
+ message MaximizeConversionValueOptInRecommendation {}
+
+ // Recommendation to deploy Google Tag on more pages.
+ message ImproveGoogleTagCoverageRecommendation {}
+
+ // Recommendation to turn on Final URL expansion for your Performance Max
+ // campaigns.
+ message PerformanceMaxFinalUrlOptInRecommendation {}
+
+ // The recommendation to update a customer list that hasn't been updated in
+ // the last 90 days. The customer receiving the recommendation is not
+ // necessarily the owner account. The owner account should update the customer
+ // list.
+ message RefreshCustomerMatchListRecommendation {
+ // Output only. The user list ID.
+ int64 user_list_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The name of the list.
+ string user_list_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. Days since last refresh.
+ int64 days_since_last_refresh = 3
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The top spending account.
+ repeated AccountInfo top_spending_account = 4
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. User lists can be shared with other accounts by the owner.
+ // targeting_accounts_count is the number of those accounts that can use it
+ // for targeting.
+ int64 targeting_accounts_count = 5
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The owner account. This is the account that should update
+ // the customer list.
+ AccountInfo owner_account = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+ }
+
+ // Wrapper for information about a Google Ads account.
+ message AccountInfo {
+ // Output only. The customer ID of the account.
+ int64 customer_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The descriptive name of the account.
+ string descriptive_name = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+ }
+
+ // The Custom Audience Opt In recommendation.
+ message CustomAudienceOptInRecommendation {
+ // Output only. The list of keywords to use for custom audience creation.
+ repeated google.ads.googleads.v16.common.KeywordInfo keywords = 1
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+ }
+
+ // The lead form asset recommendation.
+ message LeadFormAssetRecommendation {}
+
+ // The improve Demand Gen ad strength recommendation.
+ message ImproveDemandGenAdStrengthRecommendation {
+ // Output only. The resource name of the ad that can be improved.
+ string ad = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The current ad strength.
+ google.ads.googleads.v16.enums.AdStrengthEnum.AdStrength ad_strength = 2
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. A list of recommendations to improve the ad strength.
+ repeated string demand_gen_asset_action_items = 3
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+ }
+
// Immutable. The resource name of the recommendation.
//
// `customers/{customer_id}/recommendations/{recommendation_id}`
string resource_name = 1 [
(google.api.field_behavior) = IMMUTABLE,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/Recommendation"
}
];
// Output only. The type of recommendation.
- google.ads.googleads.v15.enums.RecommendationTypeEnum.RecommendationType
+ google.ads.googleads.v16.enums.RecommendationTypeEnum.RecommendationType
type = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The impact on account performance as a result of applying the
// recommendation.
RecommendationImpact impact = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
// 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
optional string campaign_budget = 24 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/CampaignBudget"
}
];
// 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
+ // SET_TARGET_CPA, SET_TARGET_ROAS, MAXIMIZE_CONVERSION_VALUE_OPT_IN,
+ // IMPROVE_GOOGLE_TAG_COVERAGE, PERFORMANCE_MAX_FINAL_URL_OPT_IN
optional string campaign = 25 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/Campaign"
}
];
// 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
optional string ad_group = 26 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/AdGroup"
}
];
// Output only. Whether the recommendation is dismissed or not.
optional bool dismissed = 27 [(google.api.field_behavior) = OUTPUT_ONLY];
// 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
repeated string campaigns = 38 [
(google.api.field_behavior) = OUTPUT_ONLY,
(google.api.resource_reference) = {
type: "googleads.googleapis.com/Campaign"
}
];
// The details of recommendation.
oneof recommendation {
// Output only. The campaign budget recommendation.
CampaignBudgetRecommendation campaign_budget_recommendation = 4
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The forecasting campaign budget recommendation.
CampaignBudgetRecommendation forecasting_campaign_budget_recommendation = 22
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The keyword recommendation.
KeywordRecommendation keyword_recommendation = 8
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Add expanded text ad recommendation.
TextAdRecommendation text_ad_recommendation = 9
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The TargetCPA opt-in recommendation.
TargetCpaOptInRecommendation target_cpa_opt_in_recommendation = 10
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The MaximizeConversions Opt-In recommendation.
MaximizeConversionsOptInRecommendation
maximize_conversions_opt_in_recommendation = 11
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Enhanced Cost-Per-Click Opt-In recommendation.
EnhancedCpcOptInRecommendation enhanced_cpc_opt_in_recommendation = 12
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Search Partners Opt-In recommendation.
SearchPartnersOptInRecommendation search_partners_opt_in_recommendation = 14
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The MaximizeClicks Opt-In recommendation.
MaximizeClicksOptInRecommendation maximize_clicks_opt_in_recommendation = 15
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Optimize Ad Rotation recommendation.
OptimizeAdRotationRecommendation optimize_ad_rotation_recommendation = 16
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The keyword match type recommendation.
KeywordMatchTypeRecommendation keyword_match_type_recommendation = 20
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The move unused budget recommendation.
MoveUnusedBudgetRecommendation move_unused_budget_recommendation = 21
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Target ROAS opt-in recommendation.
TargetRoasOptInRecommendation target_roas_opt_in_recommendation = 23
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The add responsive search ad recommendation.
ResponsiveSearchAdRecommendation responsive_search_ad_recommendation = 28
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The marginal ROI campaign budget recommendation.
CampaignBudgetRecommendation marginal_roi_campaign_budget_recommendation =
29 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The use broad match keyword recommendation.
UseBroadMatchKeywordRecommendation use_broad_match_keyword_recommendation =
30 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The responsive search ad asset recommendation.
ResponsiveSearchAdAssetRecommendation
responsive_search_ad_asset_recommendation = 31
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The upgrade a Smart Shopping campaign to a Performance Max
// campaign recommendation.
UpgradeSmartShoppingCampaignToPerformanceMaxRecommendation
upgrade_smart_shopping_campaign_to_performance_max_recommendation = 32
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The responsive search ad improve ad strength recommendation.
ResponsiveSearchAdImproveAdStrengthRecommendation
responsive_search_ad_improve_ad_strength_recommendation = 33
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Display Expansion opt-in recommendation.
DisplayExpansionOptInRecommendation
display_expansion_opt_in_recommendation = 34
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The upgrade a Local campaign to a Performance Max campaign
// recommendation.
UpgradeLocalCampaignToPerformanceMaxRecommendation
upgrade_local_campaign_to_performance_max_recommendation = 35
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The raise target CPA bid too low recommendation.
RaiseTargetCpaBidTooLowRecommendation
raise_target_cpa_bid_too_low_recommendation = 36
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The forecasting set target ROAS recommendation.
ForecastingSetTargetRoasRecommendation
forecasting_set_target_roas_recommendation = 37
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The callout asset recommendation.
CalloutAssetRecommendation callout_asset_recommendation = 39
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The sitelink asset recommendation.
SitelinkAssetRecommendation sitelink_asset_recommendation = 40
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The call asset recommendation.
CallAssetRecommendation call_asset_recommendation = 41
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add age group recommendation.
ShoppingOfferAttributeRecommendation shopping_add_age_group_recommendation =
42 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add color recommendation.
ShoppingOfferAttributeRecommendation shopping_add_color_recommendation = 43
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add gender recommendation.
ShoppingOfferAttributeRecommendation shopping_add_gender_recommendation = 44
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add GTIN recommendation.
ShoppingOfferAttributeRecommendation shopping_add_gtin_recommendation = 45
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add more identifiers recommendation.
ShoppingOfferAttributeRecommendation
shopping_add_more_identifiers_recommendation = 46
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add size recommendation.
ShoppingOfferAttributeRecommendation shopping_add_size_recommendation = 47
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping add products to campaign recommendation.
ShoppingAddProductsToCampaignRecommendation
shopping_add_products_to_campaign_recommendation = 48
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping fix disapproved products recommendation.
ShoppingFixDisapprovedProductsRecommendation
shopping_fix_disapproved_products_recommendation = 49
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping target all offers recommendation.
ShoppingTargetAllOffersRecommendation
shopping_target_all_offers_recommendation = 50
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping fix suspended Merchant Center account
// recommendation.
ShoppingMerchantCenterAccountSuspensionRecommendation
shopping_fix_suspended_merchant_center_account_recommendation = 51
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping fix Merchant Center account suspension warning
// recommendation.
ShoppingMerchantCenterAccountSuspensionRecommendation
shopping_fix_merchant_center_account_suspension_warning_recommendation =
52 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The shopping migrate Regular Shopping Campaign offers to
// Performance Max recommendation.
ShoppingMigrateRegularShoppingCampaignOffersToPerformanceMaxRecommendation
shopping_migrate_regular_shopping_campaign_offers_to_performance_max_recommendation =
53 [(google.api.field_behavior) = OUTPUT_ONLY];
// 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.
DynamicImageExtensionOptInRecommendation
dynamic_image_extension_opt_in_recommendation = 54
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Recommendation to raise Target CPA.
RaiseTargetCpaRecommendation raise_target_cpa_recommendation = 55
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. Recommendation to lower Target ROAS.
LowerTargetRoasRecommendation lower_target_roas_recommendation = 56
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Performance Max Opt In recommendation.
PerformanceMaxOptInRecommendation performance_max_opt_in_recommendation = 57
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The improve Performance Max ad strength recommendation.
ImprovePerformanceMaxAdStrengthRecommendation
improve_performance_max_ad_strength_recommendation = 58
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The Dynamic Search Ads to Performance Max migration
// recommendation.
MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
migrate_dynamic_search_ads_campaign_to_performance_max_recommendation =
59 [(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The forecasting set target CPA recommendation.
ForecastingSetTargetCpaRecommendation
forecasting_set_target_cpa_recommendation = 60
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The set target CPA recommendation.
ForecastingSetTargetCpaRecommendation set_target_cpa_recommendation = 61
[(google.api.field_behavior) = OUTPUT_ONLY];
// Output only. The set target ROAS recommendation.
ForecastingSetTargetRoasRecommendation set_target_roas_recommendation = 62
[(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The Maximize Conversion Value opt-in recommendation.
+ MaximizeConversionValueOptInRecommendation
+ maximize_conversion_value_opt_in_recommendation = 63
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. Recommendation to deploy Google Tag on more pages.
+ ImproveGoogleTagCoverageRecommendation
+ improve_google_tag_coverage_recommendation = 64
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. Recommendation to turn on Final URL expansion for your
+ // Performance Max campaigns.
+ PerformanceMaxFinalUrlOptInRecommendation
+ performance_max_final_url_opt_in_recommendation = 65
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The refresh customer list recommendation.
+ RefreshCustomerMatchListRecommendation
+ refresh_customer_match_list_recommendation = 66
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The custom audience opt in recommendation.
+ CustomAudienceOptInRecommendation custom_audience_opt_in_recommendation = 67
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The lead form asset recommendation.
+ LeadFormAssetRecommendation lead_form_asset_recommendation = 68
+ [(google.api.field_behavior) = OUTPUT_ONLY];
+
+ // Output only. The improve Demand Gen ad strength recommendation.
+ ImproveDemandGenAdStrengthRecommendation
+ improve_demand_gen_ad_strength_recommendation = 69
+ [(google.api.field_behavior) = OUTPUT_ONLY];
}
}
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 2024-02-20 UTC.