--- v23/services/keyword_plan_idea_service.proto 2026-04-17 05:00:51.000000000 +0000 +++ v24/services/keyword_plan_idea_service.proto 2026-04-17 05:00:56.000000000 +0000 @@ -440,69 +440,23 @@ repeated string language_constants = 1; // Locations to be targeted. Locations must be unique. - repeated CriterionBidModifier geo_modifiers = 2; - - // Required. The network used for targeting. - google.ads.googleads.v23.enums.KeywordPlanNetworkEnum.KeywordPlanNetwork - keyword_plan_network = 3 [(google.api.field_behavior) = REQUIRED]; - - // The list of negative keywords to be used in the campaign when doing the - // forecast. - repeated google.ads.googleads.v23.common.KeywordInfo negative_keywords = 4; + // The resource name is of the format "geoTargetConstants/{criterion_id}". + repeated string geo_target_constants = 8; // Required. The bidding strategy for the campaign. CampaignBiddingStrategy bidding_strategy = 5 [(google.api.field_behavior) = REQUIRED]; - // The expected conversion rate (number of conversions divided by number of - // total clicks) as defined by the user. This value is expressed as a decimal - // value, so an expected conversion rate of 2% should be entered as 0.02. If - // left empty, an estimated conversion rate will be used. - optional double conversion_rate = 6; - // The ad groups in the new campaign to forecast. repeated ForecastAdGroup ad_groups = 7; } // An ad group that is part of a campaign to be forecasted. message ForecastAdGroup { - // The max cpc to use for the ad group when generating forecasted traffic. - // This value will override the max cpc value set in the bidding strategy. - // Only specify this field for bidding strategies that max cpc values. - optional int64 max_cpc_bid_micros = 1; - - // Required. The list of biddable keywords to be used in the ad group when - // doing the forecast. Requires at least one keyword. - repeated BiddableKeyword biddable_keywords = 2 - [(google.api.field_behavior) = REQUIRED]; - - // The details of the keyword. You should specify both the keyword text and - // match type. - repeated google.ads.googleads.v23.common.KeywordInfo negative_keywords = 3; -} - -// A biddable keyword part of an ad group. -message BiddableKeyword { - // Required. Keyword. Must have text and match type. - google.ads.googleads.v23.common.KeywordInfo keyword = 1 + // Required. The list of keywords to be used in the ad group when doing the + // forecast. Requires at least one keyword. + repeated google.ads.googleads.v24.common.KeywordInfo keywords = 4 [(google.api.field_behavior) = REQUIRED]; - - // A max cpc bid in micros that overrides the ad group level max cpc bid in - // forecast simulation. This value will override the max cpc value set in the - // bidding strategy and ad group. Only specify this field for bidding - // strategies that support max cpc values. - optional int64 max_cpc_bid_micros = 2; -} - -// Location Criterion bid modifier. -message CriterionBidModifier { - // The resource name of the geo location to target. The resource name is of - // the format "geoTargetConstants/{criterion_id}". - string geo_target_constant = 1; - - // The associated multiplier for the criterion_id. If set, this value cannot - // be 0. - optional double bid_modifier = 2; } // Manual CPC Bidding Strategy. @@ -544,12 +498,6 @@ // The forecast metrics for the planless keyword campaign. message KeywordForecastMetrics { - // The total number of impressions. - optional double impressions = 1; - - // The average click through rate. Available only if impressions > 0. - optional double click_through_rate = 2; - // The average cpc. Available only if clicks > 0. optional int64 average_cpc_micros = 3; @@ -559,12 +511,11 @@ // The total cost. optional int64 cost_micros = 5; - // Forecasted number of conversions: clicks * conversion_rate. + // Forecasted number of conversions. This field is only available if + // the bidding strategy is + // [MaximizeConversionsBiddingStrategy][google.ads.googleads.v24.services.MaximizeConversionsBiddingStrategy]. optional double conversions = 6; - // Forecasted conversion rate. - optional double conversion_rate = 7; - // Average cost per acquisition calculated as cost_micros / conversions. optional int64 average_cpa_micros = 8; }
/services/keyword_plan_idea_service.proto
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 2026-04-17 UTC.