// 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.enums;

option csharp_namespace = "Google.Ads.GoogleAds.V17.Enums";
option go_package = "google.golang.org/genproto/googleapis/ads/googleads/v17/enums;enums";
option java_multiple_files = true;
option java_outer_classname = "AttributionModelProto";
option java_package = "com.google.ads.googleads.v17.enums";
option objc_class_prefix = "GAA";
option php_namespace = "Google\\Ads\\GoogleAds\\V17\\Enums";
option ruby_package = "Google::Ads::GoogleAds::V17::Enums";

// Container for enum representing the attribution model that describes how to
// distribute credit for a particular conversion across potentially many prior
// interactions.
message AttributionModelEnum {
  // The attribution model that describes how to distribute credit for a
  // particular conversion across potentially many prior interactions.
  enum AttributionModel {
    // Not specified.
    UNSPECIFIED = 0;

    // Used for return value only. Represents value unknown in this version.
    UNKNOWN = 1;

    // Uses external attribution.
    EXTERNAL = 100;

    // Attributes all credit for a conversion to its last click.
    GOOGLE_ADS_LAST_CLICK = 101;

    // Attributes all credit for a conversion to its first click using Google
    // Search attribution.
    GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK = 102;

    // Attributes credit for a conversion equally across all of its clicks using
    // Google Search attribution.
    GOOGLE_SEARCH_ATTRIBUTION_LINEAR = 103;

    // Attributes exponentially more credit for a conversion to its more recent
    // clicks using Google Search attribution (half-life is 1 week).
    GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY = 104;

    // Attributes 40% of the credit for a conversion to its first and last
    // clicks. Remaining 20% is evenly distributed across all other clicks. This
    // uses Google Search attribution.
    GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED = 105;

    // Flexible model that uses machine learning to determine the appropriate
    // distribution of credit among clicks using Google Search attribution.
    GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN = 106;
  }
}