--- v17/resources/conversion_value_rule.proto 2024-06-05 23:17:09.000000000 +0000 +++ v18/resources/conversion_value_rule.proto 2024-10-16 17:56:30.000000000 +0000 @@ -1,140 +1,199 @@ // Copyright 2024 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.v17.resources; +package google.ads.googleads.v18.resources; -import "google/ads/googleads/v17/enums/conversion_value_rule_status.proto"; -import "google/ads/googleads/v17/enums/value_rule_device_type.proto"; -import "google/ads/googleads/v17/enums/value_rule_geo_location_match_type.proto"; -import "google/ads/googleads/v17/enums/value_rule_operation.proto"; +import "google/ads/googleads/v18/enums/conversion_value_rule_status.proto"; +import "google/ads/googleads/v18/enums/value_rule_device_type.proto"; +import "google/ads/googleads/v18/enums/value_rule_geo_location_match_type.proto"; +import "google/ads/googleads/v18/enums/value_rule_operation.proto"; import "google/api/field_behavior.proto"; import "google/api/resource.proto"; -option csharp_namespace = "Google.Ads.GoogleAds.V17.Resources"; -option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v17/resources;resources"; +option csharp_namespace = "Google.Ads.GoogleAds.V18.Resources"; +option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v18/resources;resources"; option java_multiple_files = true; option java_outer_classname = "ConversionValueRuleProto"; -option java_package = "com.google.ads.googleads.v17.resources"; +option java_package = "com.google.ads.googleads.v18.resources"; option objc_class_prefix = "GAA"; -option php_namespace = "Google\\Ads\\GoogleAds\\V17\\Resources"; -option ruby_package = "Google::Ads::GoogleAds::V17::Resources"; +option php_namespace = "Google\\Ads\\GoogleAds\\V18\\Resources"; +option ruby_package = "Google::Ads::GoogleAds::V18::Resources"; // Proto file describing the Conversion Value Rule resource. // A conversion value rule message ConversionValueRule { option (google.api.resource) = { type: "googleads.googleapis.com/ConversionValueRule" pattern: "customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}" }; // Action applied when rule is applied. message ValueRuleAction { // Specifies applied operation. - google.ads.googleads.v17.enums.ValueRuleOperationEnum.ValueRuleOperation + google.ads.googleads.v18.enums.ValueRuleOperationEnum.ValueRuleOperation operation = 1; // Specifies applied value. double value = 2; } // Condition on Geo dimension. message ValueRuleGeoLocationCondition { // Geo locations that advertisers want to exclude. repeated string excluded_geo_target_constants = 1 [(google.api.resource_reference) = { type: "googleads.googleapis.com/GeoTargetConstant" }]; // Excluded Geo location match type. - google.ads.googleads.v17.enums.ValueRuleGeoLocationMatchTypeEnum + google.ads.googleads.v18.enums.ValueRuleGeoLocationMatchTypeEnum .ValueRuleGeoLocationMatchType excluded_geo_match_type = 2; // Geo locations that advertisers want to include. repeated string geo_target_constants = 3 [(google.api.resource_reference) = { type: "googleads.googleapis.com/GeoTargetConstant" }]; // Included Geo location match type. - google.ads.googleads.v17.enums.ValueRuleGeoLocationMatchTypeEnum + google.ads.googleads.v18.enums.ValueRuleGeoLocationMatchTypeEnum .ValueRuleGeoLocationMatchType geo_match_type = 4; } // Condition on Device dimension. message ValueRuleDeviceCondition { // Value for device type condition. - repeated google.ads.googleads.v17.enums.ValueRuleDeviceTypeEnum + repeated google.ads.googleads.v18.enums.ValueRuleDeviceTypeEnum .ValueRuleDeviceType device_types = 1; } // Condition on Audience dimension. message ValueRuleAudienceCondition { // User Lists. repeated string user_lists = 1 [(google.api.resource_reference) = { type: "googleads.googleapis.com/UserList" }]; // User Interests. repeated string user_interests = 2 [(google.api.resource_reference) = { type: "googleads.googleapis.com/UserInterest" }]; } + // Condition on Itinerary dimension. + message ValueRuleItineraryCondition { + // Range for the number of days between the date of the booking and the + // start of the itinerary. + ValueRuleItineraryAdvanceBookingWindow advance_booking_window = 1; + + // Range for the itinerary length in number of nights. + ValueRuleItineraryTravelLength travel_length = 2; + + // The days of the week on which this itinerary's travel can start. + ValueRuleItineraryTravelStartDay travel_start_day = 3; + } + + // Range for the number of days between the date of the booking and the + // start of the itinerary. + message ValueRuleItineraryAdvanceBookingWindow { + // Minimum number of days between the date of the booking the start date. + int32 min_days = 1; + + // Maximum number of days between the date of the booking the start date. + int32 max_days = 2; + } + + // Range for the itinerary length in number of nights. + message ValueRuleItineraryTravelLength { + // Minimum number of nights between the start date and the end date. + int32 min_nights = 1; + + // Maximum number of days between the start date and the end date. + int32 max_nights = 2; + } + + // The days of the week on which an itinerary's travel can start. + message ValueRuleItineraryTravelStartDay { + // The travel can start on Monday. + bool monday = 1; + + // The travel can start on Tuesday. + bool tuesday = 2; + + // The travel can start on Wednesday. + bool wednesday = 3; + + // The travel can start on Thursday. + bool thursday = 4; + + // The travel can start on Friday. + bool friday = 5; + + // The travel can start on Saturday. + bool saturday = 6; + + // The travel can start on Sunday. + bool sunday = 7; + } + // Immutable. The resource name of the conversion value rule. // Conversion value rule resource names have the form: // // `customers/{customer_id}/conversionValueRules/{conversion_value_rule_id}` string resource_name = 1 [ (google.api.field_behavior) = IMMUTABLE, (google.api.resource_reference) = { type: "googleads.googleapis.com/ConversionValueRule" } ]; // Output only. The ID of the conversion value rule. int64 id = 2 [(google.api.field_behavior) = OUTPUT_ONLY]; // Action applied when the rule is triggered. ValueRuleAction action = 3; // Condition for Geo location that must be satisfied for the value rule to // apply. ValueRuleGeoLocationCondition geo_location_condition = 4; // Condition for device type that must be satisfied for the value rule to // apply. ValueRuleDeviceCondition device_condition = 5; // Condition for audience that must be satisfied for the value rule to apply. ValueRuleAudienceCondition audience_condition = 6; + // Condition for itinerary that must be satisfied for the value rule to apply. + ValueRuleItineraryCondition itinerary_condition = 9; + // Output only. The resource name of the conversion value rule's owner // customer. When the value rule is inherited from a manager customer, // owner_customer will be the resource name of the manager whereas the // customer in the resource_name will be of the requesting serving customer. // ** Read-only ** string owner_customer = 7 [ (google.api.field_behavior) = OUTPUT_ONLY, (google.api.resource_reference) = { type: "googleads.googleapis.com/Customer" } ]; // The status of the conversion value rule. - google.ads.googleads.v17.enums.ConversionValueRuleStatusEnum + google.ads.googleads.v18.enums.ConversionValueRuleStatusEnum .ConversionValueRuleStatus status = 8; }
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-10-17 UTC.
[null,null,["Last updated 2024-10-17 UTC."],[[["This diff introduces the Itinerary dimension as a new condition for conversion value rules, allowing advertisers to adjust conversion values based on itinerary details like booking window, travel length, and start day."],["It updates the `conversion_value_rule.proto` file from v17 to v18, modifying package names and enum references to reflect the new version."],["The update includes the addition of fields like `itinerary_condition` within the `ConversionValueRule` message and new message types such as `ValueRuleItineraryCondition`, `ValueRuleItineraryAdvanceBookingWindow`, `ValueRuleItineraryTravelLength`, and `ValueRuleItineraryTravelStartDay`."],["This change enhances the flexibility of conversion value rules, enabling more granular control over conversion value adjustments based on specific trip characteristics."]]],[]]