private/google/ads/googleads/v3/common/simulation.proto
// Copyright 2020 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.v3.common;
import "google/protobuf/wrappers.proto";
import "google/api/annotations.proto";
option csharp_namespace = "Google.Ads.GoogleAds.V3.Common";
option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v3/common;common";
option java_multiple_files = true;
option java_outer_classname = "SimulationProto";
option java_package = "com.google.ads.googleads.v3.common";
option objc_class_prefix = "GAA";
option php_namespace = "Google\\Ads\\GoogleAds\\V3\\Common";
option ruby_package = "Google::Ads::GoogleAds::V3::Common";
// Proto file describing simulation points.
// A container for simulation points for simulations of type BID_MODIFIER.
message BidModifierSimulationPointList {
// Projected metrics for a series of bid modifier amounts.
repeated BidModifierSimulationPoint points = 1;
}
// A container for simulation points for simulations of type CPC_BID.
message CpcBidSimulationPointList {
// Projected metrics for a series of CPC bid amounts.
repeated CpcBidSimulationPoint points = 1;
}
// A container for simulation points for simulations of type CPV_BID.
message CpvBidSimulationPointList {
// Projected metrics for a series of CPV bid amounts.
repeated CpvBidSimulationPoint points = 1;
}
// A container for simulation points for simulations of type TARGET_CPA.
message TargetCpaSimulationPointList {
// Projected metrics for a series of target CPA amounts.
repeated TargetCpaSimulationPoint points = 1;
}
// Projected metrics for a specific bid modifier amount.
message BidModifierSimulationPoint {
// The simulated bid modifier upon which projected metrics are based.
google.protobuf.DoubleValue bid_modifier = 1;
// Projected number of biddable conversions.
// Only search advertising channel type supports this field.
google.protobuf.DoubleValue biddable_conversions = 2;
// Projected total value of biddable conversions.
// Only search advertising channel type supports this field.
google.protobuf.DoubleValue biddable_conversions_value = 3;
// Projected number of clicks.
google.protobuf.Int64Value clicks = 4;
// Projected cost in micros.
google.protobuf.Int64Value cost_micros = 5;
// Projected number of impressions.
google.protobuf.Int64Value impressions = 6;
// Projected number of top slot impressions.
// Only search advertising channel type supports this field.
google.protobuf.Int64Value top_slot_impressions = 7;
// Projected number of biddable conversions for the parent resource.
// Only search advertising channel type supports this field.
google.protobuf.DoubleValue parent_biddable_conversions = 8;
// Projected total value of biddable conversions for the parent resource.
// Only search advertising channel type supports this field.
google.protobuf.DoubleValue parent_biddable_conversions_value = 9;
// Projected number of clicks for the parent resource.
google.protobuf.Int64Value parent_clicks = 10;
// Projected cost in micros for the parent resource.
google.protobuf.Int64Value parent_cost_micros = 11;
// Projected number of impressions for the parent resource.
google.protobuf.Int64Value parent_impressions = 12;
// Projected number of top slot impressions for the parent resource.
// Only search advertising channel type supports this field.
google.protobuf.Int64Value parent_top_slot_impressions = 13;
// Projected minimum daily budget that must be available to the parent
// resource to realize this simulation.
google.protobuf.Int64Value parent_required_budget_micros = 14;
}
// Projected metrics for a specific CPC bid amount.
message CpcBidSimulationPoint {
// The simulated CPC bid upon which projected metrics are based.
google.protobuf.Int64Value cpc_bid_micros = 1;
// Projected number of biddable conversions.
google.protobuf.DoubleValue biddable_conversions = 2;
// Projected total value of biddable conversions.
google.protobuf.DoubleValue biddable_conversions_value = 3;
// Projected number of clicks.
google.protobuf.Int64Value clicks = 4;
// Projected cost in micros.
google.protobuf.Int64Value cost_micros = 5;
// Projected number of impressions.
google.protobuf.Int64Value impressions = 6;
// Projected number of top slot impressions.
// Only search advertising channel type supports this field.
google.protobuf.Int64Value top_slot_impressions = 7;
}
// Projected metrics for a specific CPV bid amount.
message CpvBidSimulationPoint {
// The simulated CPV bid upon which projected metrics are based.
google.protobuf.Int64Value cpv_bid_micros = 1;
// Projected cost in micros.
google.protobuf.Int64Value cost_micros = 2;
// Projected number of impressions.
google.protobuf.Int64Value impressions = 3;
// Projected number of views.
google.protobuf.Int64Value views = 4;
}
// Projected metrics for a specific target CPA amount.
message TargetCpaSimulationPoint {
// The simulated target CPA upon which projected metrics are based.
google.protobuf.Int64Value target_cpa_micros = 1;
// Projected number of biddable conversions.
google.protobuf.DoubleValue biddable_conversions = 2;
// Projected total value of biddable conversions.
google.protobuf.DoubleValue biddable_conversions_value = 3;
// Projected number of clicks.
google.protobuf.Int64Value clicks = 4;
// Projected cost in micros.
google.protobuf.Int64Value cost_micros = 5;
// Projected number of impressions.
google.protobuf.Int64Value impressions = 6;
// Projected number of top slot impressions.
// Only search advertising channel type supports this field.
google.protobuf.Int64Value top_slot_impressions = 7;
}