1// Copyright 2023 Google LLC 2// 3// Licensed under the Apache License, Version 2.0 (the "License"); 4// you may not use this file except in compliance with the License. 5// You may obtain a copy of the License at 6// 7// http://www.apache.org/licenses/LICENSE-2.0 8// 9// Unless required by applicable law or agreed to in writing, software 10// distributed under the License is distributed on an "AS IS" BASIS, 11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12// See the License for the specific language governing permissions and 13// limitations under the License. 14 15syntax = "proto3"; 16 17package google.ads.googleads.v14.resources; 18 19import "google/ads/googleads/v14/common/bidding.proto"; 20import "google/ads/googleads/v14/common/custom_parameter.proto"; 21import "google/ads/googleads/v14/common/frequency_cap.proto"; 22import "google/ads/googleads/v14/common/real_time_bidding_setting.proto"; 23import "google/ads/googleads/v14/common/targeting_setting.proto"; 24import "google/ads/googleads/v14/enums/ad_serving_optimization_status.proto"; 25import "google/ads/googleads/v14/enums/advertising_channel_sub_type.proto"; 26import "google/ads/googleads/v14/enums/advertising_channel_type.proto"; 27import "google/ads/googleads/v14/enums/app_campaign_app_store.proto"; 28import "google/ads/googleads/v14/enums/app_campaign_bidding_strategy_goal_type.proto"; 29import "google/ads/googleads/v14/enums/asset_field_type.proto"; 30import "google/ads/googleads/v14/enums/asset_set_type.proto"; 31import "google/ads/googleads/v14/enums/bidding_strategy_system_status.proto"; 32import "google/ads/googleads/v14/enums/bidding_strategy_type.proto"; 33import "google/ads/googleads/v14/enums/brand_safety_suitability.proto"; 34import "google/ads/googleads/v14/enums/campaign_experiment_type.proto"; 35import "google/ads/googleads/v14/enums/campaign_primary_status.proto"; 36import "google/ads/googleads/v14/enums/campaign_primary_status_reason.proto"; 37import "google/ads/googleads/v14/enums/campaign_serving_status.proto"; 38import "google/ads/googleads/v14/enums/campaign_status.proto"; 39import "google/ads/googleads/v14/enums/listing_type.proto"; 40import "google/ads/googleads/v14/enums/location_source_type.proto"; 41import "google/ads/googleads/v14/enums/negative_geo_target_type.proto"; 42import "google/ads/googleads/v14/enums/optimization_goal_type.proto"; 43import "google/ads/googleads/v14/enums/payment_mode.proto"; 44import "google/ads/googleads/v14/enums/performance_max_upgrade_status.proto"; 45import "google/ads/googleads/v14/enums/positive_geo_target_type.proto"; 46import "google/ads/googleads/v14/enums/vanity_pharma_display_url_mode.proto"; 47import "google/ads/googleads/v14/enums/vanity_pharma_text.proto"; 48import "google/api/field_behavior.proto"; 49import "google/api/resource.proto"; 50 51option csharp_namespace = "Google.Ads.GoogleAds.V14.Resources"; 52option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v14/resources;resources"; 53option java_multiple_files = true; 54option java_outer_classname = "CampaignProto"; 55option java_package = "com.google.ads.googleads.v14.resources"; 56option objc_class_prefix = "GAA"; 57option php_namespace = "Google\\Ads\\GoogleAds\\V14\\Resources"; 58option ruby_package = "Google::Ads::GoogleAds::V14::Resources"; 59 60// Proto file describing the Campaign resource. 61 62// A campaign. 63message Campaign { 64 option (google.api.resource) = { 65 type: "googleads.googleapis.com/Campaign" 66 pattern: "customers/{customer_id}/campaigns/{campaign_id}" 67 }; 68 69 // Information about a campaign being upgraded to Performance Max. 70 message PerformanceMaxUpgrade { 71 // Output only. Indicates which Performance Max campaign the campaign is 72 // upgraded to. 73 string performance_max_campaign = 1 [ 74 (google.api.field_behavior) = OUTPUT_ONLY, 75 (google.api.resource_reference) = { 76 type: "googleads.googleapis.com/Campaign" 77 } 78 ]; 79 80 // Output only. Indicates legacy campaign upgraded to Performance Max. 81 string pre_upgrade_campaign = 2 [ 82 (google.api.field_behavior) = OUTPUT_ONLY, 83 (google.api.resource_reference) = { 84 type: "googleads.googleapis.com/Campaign" 85 } 86 ]; 87 88 // Output only. The upgrade status of a campaign requested to be upgraded to 89 // Performance Max. 90 google.ads.googleads.v14.enums.PerformanceMaxUpgradeStatusEnum 91 .PerformanceMaxUpgradeStatus status = 3 92 [(google.api.field_behavior) = OUTPUT_ONLY]; 93 } 94 95 // The network settings for the campaign. 96 message NetworkSettings { 97 // Whether ads will be served with google.com search results. 98 optional bool target_google_search = 5; 99 100 // Whether ads will be served on partner sites in the Google Search Network 101 // (requires `target_google_search` to also be `true`). 102 optional bool target_search_network = 6; 103 104 // Whether ads will be served on specified placements in the Google Display 105 // Network. Placements are specified using the Placement criterion. 106 optional bool target_content_network = 7; 107 108 // Whether ads will be served on the Google Partner Network. 109 // This is available only to some select Google partner accounts. 110 optional bool target_partner_search_network = 8; 111 } 112 113 // Campaign-level settings for hotel ads. 114 message HotelSettingInfo { 115 // Immutable. The linked Hotel Center account. 116 optional int64 hotel_center_id = 2 117 [(google.api.field_behavior) = IMMUTABLE]; 118 } 119 120 // The setting for controlling Dynamic Search Ads (DSA). 121 message DynamicSearchAdsSetting { 122 // Required. The Internet domain name that this setting represents, for 123 // example, "google.com" or "www.google.com". 124 string domain_name = 6 [(google.api.field_behavior) = REQUIRED]; 125 126 // Required. The language code specifying the language of the domain, for 127 // example, "en". 128 string language_code = 7 [(google.api.field_behavior) = REQUIRED]; 129 130 // Whether the campaign uses advertiser supplied URLs exclusively. 131 optional bool use_supplied_urls_only = 8; 132 133 // The list of page feeds associated with the campaign. 134 repeated string feeds = 9 [(google.api.resource_reference) = { 135 type: "googleads.googleapis.com/Feed" 136 }]; 137 } 138 139 // The setting for Shopping campaigns. Defines the universe of products that 140 // can be advertised by the campaign, and how this campaign interacts with 141 // other Shopping campaigns. 142 message ShoppingSetting { 143 // Immutable. ID of the Merchant Center account. 144 // This field is required for create operations. This field is immutable for 145 // Shopping campaigns. 146 optional int64 merchant_id = 5 [(google.api.field_behavior) = IMMUTABLE]; 147 148 // Sales country of products to include in the campaign. 149 // Only one of feed_label or sales_country can be set. 150 // Field is immutable except for clearing. 151 // Once this field is cleared, you must use feed_label if you 152 // want to set the sales country. 153 optional string sales_country = 6; 154 155 // Feed label of products to include in the campaign. 156 // Only one of feed_label or sales_country can be set. 157 // If used instead of sales_country, the feed_label field accepts country 158 // codes in the same format for example: 'XX'. 159 // Otherwise can be any string used for feed label in Google Merchant 160 // Center. 161 string feed_label = 10; 162 163 // Priority of the campaign. Campaigns with numerically higher priorities 164 // take precedence over those with lower priorities. 165 // This field is required for Shopping campaigns, with values between 0 and 166 // 2, inclusive. 167 // This field is optional for Smart Shopping campaigns, but must be equal to 168 // 3 if set. 169 optional int32 campaign_priority = 7; 170 171 // Whether to include local products. 172 optional bool enable_local = 8; 173 174 // Immutable. Whether to target Vehicle Listing inventory. This field is 175 // supported only in Smart Shopping Campaigns. For setting Vehicle Listing 176 // inventory in Performance Max campaigns, use `listing_type` instead. 177 bool use_vehicle_inventory = 9 [(google.api.field_behavior) = IMMUTABLE]; 178 179 // Immutable. The ads account IDs of advertising partners cooperating within 180 // the campaign. 181 repeated int64 advertising_partner_ids = 11 182 [(google.api.field_behavior) = IMMUTABLE]; 183 } 184 185 // Campaign-level settings for tracking information. 186 message TrackingSetting { 187 // Output only. The url used for dynamic tracking. 188 optional string tracking_url = 2 189 [(google.api.field_behavior) = OUTPUT_ONLY]; 190 } 191 192 // Represents a collection of settings related to ads geotargeting. 193 message GeoTargetTypeSetting { 194 // The setting used for positive geotargeting in this particular campaign. 195 google.ads.googleads.v14.enums.PositiveGeoTargetTypeEnum 196 .PositiveGeoTargetType positive_geo_target_type = 1; 197 198 // The setting used for negative geotargeting in this particular campaign. 199 google.ads.googleads.v14.enums.NegativeGeoTargetTypeEnum 200 .NegativeGeoTargetType negative_geo_target_type = 2; 201 } 202 203 // Campaign setting for local campaigns. 204 message LocalCampaignSetting { 205 // The location source type for this local campaign. 206 google.ads.googleads.v14.enums.LocationSourceTypeEnum.LocationSourceType 207 location_source_type = 1; 208 } 209 210 // Campaign-level settings for App Campaigns. 211 message AppCampaignSetting { 212 // Represents the goal which the bidding strategy of this app campaign 213 // should optimize towards. 214 google.ads.googleads.v14.enums.AppCampaignBiddingStrategyGoalTypeEnum 215 .AppCampaignBiddingStrategyGoalType bidding_strategy_goal_type = 1; 216 217 // Immutable. A string that uniquely identifies a mobile application. 218 optional string app_id = 4 [(google.api.field_behavior) = IMMUTABLE]; 219 220 // Immutable. The application store that distributes this specific app. 221 google.ads.googleads.v14.enums.AppCampaignAppStoreEnum.AppCampaignAppStore 222 app_store = 3 [(google.api.field_behavior) = IMMUTABLE]; 223 } 224 225 // Describes how unbranded pharma ads will be displayed. 226 message VanityPharma { 227 // The display mode for vanity pharma URLs. 228 google.ads.googleads.v14.enums.VanityPharmaDisplayUrlModeEnum 229 .VanityPharmaDisplayUrlMode vanity_pharma_display_url_mode = 1; 230 231 // The text that will be displayed in display URL of the text ad when 232 // website description is the selected display mode for vanity pharma URLs. 233 google.ads.googleads.v14.enums.VanityPharmaTextEnum.VanityPharmaText 234 vanity_pharma_text = 2; 235 } 236 237 // Selective optimization setting for this campaign, which includes a set of 238 // conversion actions to optimize this campaign towards. 239 // This feature only applies to app campaigns that use MULTI_CHANNEL as 240 // AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as 241 // AdvertisingChannelSubType. 242 message SelectiveOptimization { 243 // The selected set of conversion actions for optimizing this campaign. 244 repeated string conversion_actions = 2 [(google.api.resource_reference) = { 245 type: "googleads.googleapis.com/ConversionAction" 246 }]; 247 } 248 249 // Optimization goal setting for this campaign, which includes a set of 250 // optimization goal types. 251 message OptimizationGoalSetting { 252 // The list of optimization goal types. 253 repeated google.ads.googleads.v14.enums.OptimizationGoalTypeEnum 254 .OptimizationGoalType optimization_goal_types = 1; 255 } 256 257 // Settings for the audience targeting. 258 message AudienceSetting { 259 // Immutable. If true, this campaign uses an Audience resource for audience 260 // targeting. If false, this campaign may use audience segment criteria 261 // instead. 262 optional bool use_audience_grouped = 1 263 [(google.api.field_behavior) = IMMUTABLE]; 264 } 265 266 // Settings for LocalServicesCampaign subresource. 267 message LocalServicesCampaignSettings { 268 // Categorical level bids associated with MANUAL_CPA bidding strategy. 269 repeated CategoryBid category_bids = 1; 270 } 271 272 // Category bids in LocalServicesReportingCampaignSettings. 273 message CategoryBid { 274 // Category for which the bid will be associated with. For example, 275 // xcat:service_area_business_plumber. 276 optional string category_id = 1; 277 278 // Manual CPA bid for the category. Bid must be greater than the 279 // reserve price associated for that category. Value is in micros 280 // and in the advertiser's currency. 281 optional int64 manual_cpa_bid_micros = 2; 282 } 283 284 // Settings for Travel campaign. 285 message TravelCampaignSettings { 286 // Immutable. The Travel account ID associated with the Travel campaign. 287 optional int64 travel_account_id = 1 288 [(google.api.field_behavior) = IMMUTABLE]; 289 } 290 291 // Settings for Discovery campaign. 292 message DiscoveryCampaignSettings { 293 // Immutable. Specifies whether this campaign uses upgraded targeting 294 // options. When this field is set to `true`, you can use location and 295 // language targeting at the ad group level as opposed to the standard 296 // campaign-level targeting. This field defaults to `false`, and can only be 297 // set when creating a campaign. 298 optional bool upgraded_targeting = 1 299 [(google.api.field_behavior) = IMMUTABLE]; 300 } 301 302 // Immutable. The resource name of the campaign. 303 // Campaign resource names have the form: 304 // 305 // `customers/{customer_id}/campaigns/{campaign_id}` 306 string resource_name = 1 [ 307 (google.api.field_behavior) = IMMUTABLE, 308 (google.api.resource_reference) = { 309 type: "googleads.googleapis.com/Campaign" 310 } 311 ]; 312 313 // Output only. The ID of the campaign. 314 optional int64 id = 59 [(google.api.field_behavior) = OUTPUT_ONLY]; 315 316 // The name of the campaign. 317 // 318 // This field is required and should not be empty when creating new 319 // campaigns. 320 // 321 // It must not contain any null (code point 0x0), NL line feed 322 // (code point 0xA) or carriage return (code point 0xD) characters. 323 optional string name = 58; 324 325 // Output only. The primary status of the campaign. 326 // 327 // Provides insight into why a campaign is not serving or not serving 328 // optimally. Modification to the campaign and its related entities might take 329 // a while to be reflected in this status. 330 google.ads.googleads.v14.enums.CampaignPrimaryStatusEnum.CampaignPrimaryStatus 331 primary_status = 81 [(google.api.field_behavior) = OUTPUT_ONLY]; 332 333 // Output only. The primary status reasons of the campaign. 334 // 335 // Provides insight into why a campaign is not serving or not serving 336 // optimally. These reasons are aggregated to determine an overall 337 // CampaignPrimaryStatus. 338 repeated google.ads.googleads.v14.enums.CampaignPrimaryStatusReasonEnum 339 .CampaignPrimaryStatusReason primary_status_reasons = 82 340 [(google.api.field_behavior) = OUTPUT_ONLY]; 341 342 // The status of the campaign. 343 // 344 // When a new campaign is added, the status defaults to ENABLED. 345 google.ads.googleads.v14.enums.CampaignStatusEnum.CampaignStatus status = 5; 346 347 // Output only. The ad serving status of the campaign. 348 google.ads.googleads.v14.enums.CampaignServingStatusEnum.CampaignServingStatus 349 serving_status = 21 [(google.api.field_behavior) = OUTPUT_ONLY]; 350 351 // Output only. The system status of the campaign's bidding strategy. 352 google.ads.googleads.v14.enums.BiddingStrategySystemStatusEnum 353 .BiddingStrategySystemStatus bidding_strategy_system_status = 78 354 [(google.api.field_behavior) = OUTPUT_ONLY]; 355 356 // The ad serving optimization status of the campaign. 357 google.ads.googleads.v14.enums.AdServingOptimizationStatusEnum 358 .AdServingOptimizationStatus ad_serving_optimization_status = 8; 359 360 // Immutable. The primary serving target for ads within the campaign. 361 // The targeting options can be refined in `network_settings`. 362 // 363 // This field is required and should not be empty when creating new 364 // campaigns. 365 // 366 // Can be set only when creating campaigns. 367 // After the campaign is created, the field can not be changed. 368 google.ads.googleads.v14.enums.AdvertisingChannelTypeEnum 369 .AdvertisingChannelType advertising_channel_type = 9 370 [(google.api.field_behavior) = IMMUTABLE]; 371 372 // Immutable. Optional refinement to `advertising_channel_type`. 373 // Must be a valid sub-type of the parent channel type. 374 // 375 // Can be set only when creating campaigns. 376 // After campaign is created, the field can not be changed. 377 google.ads.googleads.v14.enums.AdvertisingChannelSubTypeEnum 378 .AdvertisingChannelSubType advertising_channel_sub_type = 10 379 [(google.api.field_behavior) = IMMUTABLE]; 380 381 // The URL template for constructing a tracking URL. 382 optional string tracking_url_template = 60; 383 384 // The list of mappings used to substitute custom parameter tags in a 385 // `tracking_url_template`, `final_urls`, or `mobile_final_urls`. 386 repeated google.ads.googleads.v14.common.CustomParameter 387 url_custom_parameters = 12; 388 389 // The Local Services Campaign related settings. 390 LocalServicesCampaignSettings local_services_campaign_settings = 75; 391 392 // Settings for Travel campaign. 393 TravelCampaignSettings travel_campaign_settings = 85; 394 395 // Settings for Discovery campaign. 396 DiscoveryCampaignSettings discovery_campaign_settings = 87; 397 398 // Settings for Real-Time Bidding, a feature only available for campaigns 399 // targeting the Ad Exchange network. 400 google.ads.googleads.v14.common.RealTimeBiddingSetting 401 real_time_bidding_setting = 39; 402 403 // The network settings for the campaign. 404 NetworkSettings network_settings = 14; 405 406 // Immutable. The hotel setting for the campaign. 407 HotelSettingInfo hotel_setting = 32 [(google.api.field_behavior) = IMMUTABLE]; 408 409 // The setting for controlling Dynamic Search Ads (DSA). 410 DynamicSearchAdsSetting dynamic_search_ads_setting = 33; 411 412 // The setting for controlling Shopping campaigns. 413 ShoppingSetting shopping_setting = 36; 414 415 // Setting for targeting related features. 416 google.ads.googleads.v14.common.TargetingSetting targeting_setting = 43; 417 418 // Immutable. Setting for audience related features. 419 optional AudienceSetting audience_setting = 73 420 [(google.api.field_behavior) = IMMUTABLE]; 421 422 // The setting for ads geotargeting. 423 GeoTargetTypeSetting geo_target_type_setting = 47; 424 425 // The setting for local campaign. 426 LocalCampaignSetting local_campaign_setting = 50; 427 428 // The setting related to App Campaign. 429 AppCampaignSetting app_campaign_setting = 51; 430 431 // Output only. The resource names of labels attached to this campaign. 432 repeated string labels = 61 [ 433 (google.api.field_behavior) = OUTPUT_ONLY, 434 (google.api.resource_reference) = { 435 type: "googleads.googleapis.com/CampaignLabel" 436 } 437 ]; 438 439 // Output only. The type of campaign: normal, draft, or experiment. 440 google.ads.googleads.v14.enums.CampaignExperimentTypeEnum 441 .CampaignExperimentType experiment_type = 17 442 [(google.api.field_behavior) = OUTPUT_ONLY]; 443 444 // Output only. The resource name of the base campaign of a draft or 445 // experiment campaign. For base campaigns, this is equal to `resource_name`. 446 // 447 // This field is read-only. 448 optional string base_campaign = 56 [ 449 (google.api.field_behavior) = OUTPUT_ONLY, 450 (google.api.resource_reference) = { 451 type: "googleads.googleapis.com/Campaign" 452 } 453 ]; 454 455 // The budget of the campaign. 456 optional string campaign_budget = 62 [(google.api.resource_reference) = { 457 type: "googleads.googleapis.com/CampaignBudget" 458 }]; 459 460 // Output only. The type of bidding strategy. 461 // 462 // A bidding strategy can be created by setting either the bidding scheme to 463 // create a standard bidding strategy or the `bidding_strategy` field to 464 // create a portfolio bidding strategy. 465 // 466 // This field is read-only. 467 google.ads.googleads.v14.enums.BiddingStrategyTypeEnum.BiddingStrategyType 468 bidding_strategy_type = 22 [(google.api.field_behavior) = OUTPUT_ONLY]; 469 470 // Output only. Resource name of AccessibleBiddingStrategy, a read-only view 471 // of the unrestricted attributes of the attached portfolio bidding strategy 472 // identified by 'bidding_strategy'. Empty, if the campaign does not use a 473 // portfolio strategy. Unrestricted strategy attributes are available to all 474 // customers with whom the strategy is shared and are read from the 475 // AccessibleBiddingStrategy resource. In contrast, restricted attributes are 476 // only available to the owner customer of the strategy and their managers. 477 // Restricted attributes can only be read from the BiddingStrategy resource. 478 string accessible_bidding_strategy = 71 [ 479 (google.api.field_behavior) = OUTPUT_ONLY, 480 (google.api.resource_reference) = { 481 type: "googleads.googleapis.com/AccessibleBiddingStrategy" 482 } 483 ]; 484 485 // The date when campaign started in serving customer's timezone in YYYY-MM-DD 486 // format. 487 optional string start_date = 63; 488 489 // The campaign group this campaign belongs to. 490 optional string campaign_group = 76 [(google.api.resource_reference) = { 491 type: "googleads.googleapis.com/CampaignGroup" 492 }]; 493 494 // The last day of the campaign in serving customer's timezone in YYYY-MM-DD 495 // format. On create, defaults to 2037-12-30, which means the campaign will 496 // run indefinitely. To set an existing campaign to run indefinitely, set this 497 // field to 2037-12-30. 498 optional string end_date = 64; 499 500 // Suffix used to append query parameters to landing pages that are served 501 // with parallel tracking. 502 optional string final_url_suffix = 65; 503 504 // A list that limits how often each user will see this campaign's ads. 505 repeated google.ads.googleads.v14.common.FrequencyCapEntry frequency_caps = 506 40; 507 508 // Output only. 3-Tier Brand Safety setting for the campaign. 509 google.ads.googleads.v14.enums.BrandSafetySuitabilityEnum 510 .BrandSafetySuitability video_brand_safety_suitability = 42 511 [(google.api.field_behavior) = OUTPUT_ONLY]; 512 513 // Describes how unbranded pharma ads will be displayed. 514 VanityPharma vanity_pharma = 44; 515 516 // Selective optimization setting for this campaign, which includes a set of 517 // conversion actions to optimize this campaign towards. 518 // This feature only applies to app campaigns that use MULTI_CHANNEL as 519 // AdvertisingChannelType and APP_CAMPAIGN or APP_CAMPAIGN_FOR_ENGAGEMENT as 520 // AdvertisingChannelSubType. 521 SelectiveOptimization selective_optimization = 45; 522 523 // Optimization goal setting for this campaign, which includes a set of 524 // optimization goal types. 525 OptimizationGoalSetting optimization_goal_setting = 54; 526 527 // Output only. Campaign-level settings for tracking information. 528 TrackingSetting tracking_setting = 46 529 [(google.api.field_behavior) = OUTPUT_ONLY]; 530 531 // Payment mode for the campaign. 532 google.ads.googleads.v14.enums.PaymentModeEnum.PaymentMode payment_mode = 52; 533 534 // Output only. Optimization score of the campaign. 535 // 536 // Optimization score is an estimate of how well a campaign is set to perform. 537 // It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the 538 // campaign is performing at full potential. This field is null for unscored 539 // campaigns. 540 // 541 // See "About optimization score" at 542 // https://support.google.com/google-ads/answer/9061546. 543 // 544 // This field is read-only. 545 optional double optimization_score = 66 546 [(google.api.field_behavior) = OUTPUT_ONLY]; 547 548 // The asset field types that should be excluded from this campaign. Asset 549 // links with these field types will not be inherited by this campaign from 550 // the upper level. 551 repeated google.ads.googleads.v14.enums.AssetFieldTypeEnum.AssetFieldType 552 excluded_parent_asset_field_types = 69; 553 554 // The asset set types that should be excluded from this campaign. Asset set 555 // links with these types will not be inherited by this campaign from 556 // the upper level. 557 // Location group types (GMB_DYNAMIC_LOCATION_GROUP, 558 // CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of 559 // LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all 560 // location group asset sets are not allowed to be linked to this campaign, 561 // and all Location Extension (LE) and Affiliate Location Extensions (ALE) 562 // will not be served under this campaign. 563 // Only LOCATION_SYNC is currently supported. 564 repeated google.ads.googleads.v14.enums.AssetSetTypeEnum.AssetSetType 565 excluded_parent_asset_set_types = 80; 566 567 // Represents opting out of URL expansion to more targeted URLs. If opted out 568 // (true), only the final URLs in the asset group or URLs specified in the 569 // advertiser's Google Merchant Center or business data feeds are targeted. 570 // If opted in (false), the entire domain will be targeted. This field can 571 // only be set for Performance Max campaigns, where the default value is 572 // false. 573 optional bool url_expansion_opt_out = 72; 574 575 // Output only. Information about campaigns being upgraded to Performance Max. 576 PerformanceMaxUpgrade performance_max_upgrade = 77 577 [(google.api.field_behavior) = OUTPUT_ONLY]; 578 579 // Immutable. The set of hotel properties for Performance Max for travel goals 580 // campaigns. 581 optional string hotel_property_asset_set = 83 [ 582 (google.api.field_behavior) = IMMUTABLE, 583 (google.api.resource_reference) = { 584 type: "googleads.googleapis.com/AssetSet" 585 } 586 ]; 587 588 // Immutable. Listing type of ads served for this campaign. 589 // Field is restricted for usage with Performance Max campaigns. 590 optional google.ads.googleads.v14.enums.ListingTypeEnum.ListingType 591 listing_type = 86 [(google.api.field_behavior) = IMMUTABLE]; 592 593 // The bidding strategy for the campaign. 594 // 595 // Must be either portfolio (created through BiddingStrategy service) or 596 // standard, that is embedded into the campaign. 597 oneof campaign_bidding_strategy { 598 // Portfolio bidding strategy used by campaign. 599 string bidding_strategy = 67 [(google.api.resource_reference) = { 600 type: "googleads.googleapis.com/BiddingStrategy" 601 }]; 602 603 // Commission is an automatic bidding strategy in which the advertiser pays 604 // a certain portion of the conversion value. 605 google.ads.googleads.v14.common.Commission commission = 49; 606 607 // Standard Manual CPA bidding strategy. 608 // Manual bidding strategy that allows advertiser to set the bid per 609 // advertiser-specified action. Supported only for Local Services campaigns. 610 google.ads.googleads.v14.common.ManualCpa manual_cpa = 74; 611 612 // Standard Manual CPC bidding strategy. 613 // Manual click-based bidding where user pays per click. 614 google.ads.googleads.v14.common.ManualCpc manual_cpc = 24; 615 616 // Standard Manual CPM bidding strategy. 617 // Manual impression-based bidding where user pays per thousand 618 // impressions. 619 google.ads.googleads.v14.common.ManualCpm manual_cpm = 25; 620 621 // A bidding strategy that pays a configurable amount per video view. 622 google.ads.googleads.v14.common.ManualCpv manual_cpv = 37; 623 624 // Standard Maximize Conversions bidding strategy that automatically 625 // maximizes number of conversions while spending your budget. 626 google.ads.googleads.v14.common.MaximizeConversions maximize_conversions = 627 30; 628 629 // Standard Maximize Conversion Value bidding strategy that automatically 630 // sets bids to maximize revenue while spending your budget. 631 google.ads.googleads.v14.common.MaximizeConversionValue 632 maximize_conversion_value = 31; 633 634 // Standard Target CPA bidding strategy that automatically sets bids to 635 // help get as many conversions as possible at the target 636 // cost-per-acquisition (CPA) you set. 637 google.ads.googleads.v14.common.TargetCpa target_cpa = 26; 638 639 // Target Impression Share bidding strategy. An automated bidding strategy 640 // that sets bids to achieve a chosen percentage of impressions. 641 google.ads.googleads.v14.common.TargetImpressionShare 642 target_impression_share = 48; 643 644 // Standard Target ROAS bidding strategy that automatically maximizes 645 // revenue while averaging a specific target return on ad spend (ROAS). 646 google.ads.googleads.v14.common.TargetRoas target_roas = 29; 647 648 // Standard Target Spend bidding strategy that automatically sets your bids 649 // to help get as many clicks as possible within your budget. 650 google.ads.googleads.v14.common.TargetSpend target_spend = 27; 651 652 // Standard Percent Cpc bidding strategy where bids are a fraction of the 653 // advertised price for some good or service. 654 google.ads.googleads.v14.common.PercentCpc percent_cpc = 34; 655 656 // A bidding strategy that automatically optimizes cost per thousand 657 // impressions. 658 google.ads.googleads.v14.common.TargetCpm target_cpm = 41; 659 } 660} 661