docs: announce the deprecation of first-click, linear, time-decay and position-based attribution models

feat: update the `default_uri` field of the `WebStreamData` type to be mutable
feat: add the `ads_web_conversion_data_export_scope` field to the `ReportingAttributionModel` type
feat: add `AdsWebConversionDataExportScope` enum to the Admin API v1alpha

PiperOrigin-RevId: 542000614

google/analytics/admin/v1alpha/BUILD.bazel

@@ -79,7 +79,7 @@ java_gapic_library(
     gapic_yaml = "analyticsadmin_gapic.yaml",
     grpc_service_config = "admin_grpc_service_config.json",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     test_deps = [
         ":admin_java_grpc",
     ],
@@ -140,7 +140,7 @@ go_gapic_library(
     metadata = True,
     release_level = "alpha",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
     deps = [
         ":admin_go_proto",
@@ -175,7 +175,7 @@ py_gapic_library(
     srcs = [":admin_proto"],
     grpc_service_config = "admin_grpc_service_config.json",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
     deps = [
     ],
@@ -220,9 +220,11 @@ php_gapic_library(
     grpc_service_config = "admin_grpc_service_config.json",
     migration_mode = "PRE_MIGRATION_SURFACE_ONLY",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
-    deps = [":admin_php_proto"],
+    deps = [
+        ":admin_php_proto",
+    ],
 )
 
 # Open Source Packages
@@ -251,7 +253,7 @@ nodejs_gapic_library(
     grpc_service_config = "admin_grpc_service_config.json",
     package = "google.analytics.admin.v1alpha",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
     deps = [],
 )
@@ -299,7 +301,7 @@ ruby_cloud_gapic_library(
     rest_numeric_enums = True,
     ruby_cloud_description = "The Analytics Admin API allows for programmatic access to the Google Analytics App+Web configuration data. You can use the Google Analytics Admin API to manage accounts and App+Web properties.",
     ruby_cloud_title = "Google Analytics Admin V1alpha",
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
     deps = [
         ":admin_ruby_grpc",
@@ -330,6 +332,7 @@ load(
 
 csharp_proto_library(
     name = "admin_csharp_proto",
+    extra_opts = [],
     deps = [":admin_proto"],
 )
 
@@ -345,7 +348,7 @@ csharp_gapic_library(
     common_resources_config = "@gax_dotnet//:Google.Api.Gax/ResourceNames/CommonResourcesConfig.json",
     grpc_service_config = "admin_grpc_service_config.json",
     rest_numeric_enums = True,
-    service_yaml = "analyticsadmin_v1alpha.yaml",
+    service_yaml = "analyticsadmin.yaml",
     transport = "grpc+rest",
     deps = [
         ":admin_csharp_grpc",

google/analytics/admin/v1alpha/resources.proto

@@ -439,17 +439,18 @@ message DataStream {
 
   // Data specific to web streams.
   message WebStreamData {
-    // Output only. Analytics "Measurement ID", without the "G-" prefix.
+    // Output only. Analytics Measurement ID.
-    // Example: "G-1A2BCD345E" would just be "1A2BCD345E"
+    //
+    // Example: "G-1A2BCD345E"
     string measurement_id = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
 
     // Output only. ID of the corresponding web app in Firebase, if any.
     // This ID can change if the web app is deleted and recreated.
     string firebase_app_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-    // Immutable. Domain name of the web app being measured, or empty.
+    // Domain name of the web app being measured, or empty.
     // Example: "http://www.google.com", "https://www.google.com"
-    string default_uri = 3 [(google.api.field_behavior) = IMMUTABLE];
+    string default_uri = 3;
   }
 
   // Data specific to Android app streams.
@@ -1380,19 +1381,47 @@ message AttributionSettings {
     // for YouTube) before converting.
     CROSS_CHANNEL_LAST_CLICK = 2;
 
+    // Starting in June 2023, new properties can no longer use this model.
+    // See
+    // [Analytics
+    // Help](https://support.google.com/analytics/answer/9164320?hl=en#040623)
+    // for more details.
+    // Starting in September 2023, we will sunset this model for all properties.
+    //
     // Gives all credit for the conversion to the first channel that a customer
     // clicked (or engaged view through for YouTube) before converting.
     CROSS_CHANNEL_FIRST_CLICK = 3;
 
+    // Starting in June 2023, new properties can no longer use this model.
+    // See
+    // [Analytics
+    // Help](https://support.google.com/analytics/answer/9164320?hl=en#040623)
+    // for more details.
+    // Starting in September 2023, we will sunset this model for all properties.
+    //
     // Distributes the credit for the conversion equally across all the channels
     // a customer clicked (or engaged view through for YouTube) before
     // converting.
     CROSS_CHANNEL_LINEAR = 4;
 
+    // Starting in June 2023, new properties can no longer use this model.
+    // See
+    // [Analytics
+    // Help](https://support.google.com/analytics/answer/9164320?hl=en#040623)
+    // for more details.
+    // Starting in September 2023, we will sunset this model for all properties.
+    //
     // Attributes 40% credit to the first and last interaction, and the
     // remaining 20% credit is distributed evenly to the middle interactions.
     CROSS_CHANNEL_POSITION_BASED = 5;
 
+    // Starting in June 2023, new properties can no longer use this model.
+    // See
+    // [Analytics
+    // Help](https://support.google.com/analytics/answer/9164320?hl=en#040623)
+    // for more details.
+    // Starting in September 2023, we will sunset this model for all properties.
+    //
     // Gives more credit to the touchpoints that happened closer in time to
     // the conversion.
     CROSS_CHANNEL_TIME_DECAY = 6;
@@ -1402,6 +1431,22 @@ message AttributionSettings {
     ADS_PREFERRED_LAST_CLICK = 7;
   }
 
+  // The Conversion Export Scope for data exported to linked Ads Accounts.
+  enum AdsWebConversionDataExportScope {
+    // Default value. This value is unused.
+    ADS_WEB_CONVERSION_DATA_EXPORT_SCOPE_UNSPECIFIED = 0;
+
+    // No data export scope selected yet.
+    // Export scope can never be changed back to this value.
+    NOT_SELECTED_YET = 1;
+
+    // The Ads Web Conversion Data export scope is Cross Channel.
+    CROSS_CHANNEL = 2;
+
+    // The Ads Web Conversion Data export scope is Ads Preferred.
+    ADS_PREFERRED = 3;
+  }
+
   // Output only. Resource name of this attribution settings resource.
   // Format: properties/{property_id}/attributionSettings
   // Example: "properties/1000/attributionSettings"
@@ -1426,6 +1471,11 @@ message AttributionSettings {
   // revenue data. User and session data will be unaffected.
   ReportingAttributionModel reporting_attribution_model = 4
       [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The Conversion Export Scope for data exported to linked Ads
+  // Accounts.
+  AdsWebConversionDataExportScope ads_web_conversion_data_export_scope = 5
+      [(google.api.field_behavior) = REQUIRED];
 }
 
 // A binding of a user to a set of roles.
@@ -1514,7 +1564,7 @@ message BigQueryLink {
   repeated string excluded_events = 8;
 }
 
-// Singleton resource under a WebDataStream, configuring measurement of
+// Singleton resource under a web DataStream, configuring measurement of
 // additional site interactions and content.
 message EnhancedMeasurementSettings {
   option (google.api.resource) = {