/common/metrics.proto

--- v25/common/metrics.proto    2026-10-26 16:32:19.000000000 +0000
+++ v26/common/metrics.proto    2026-10-26 16:32:27.000000000 +0000
@@ -1336,6 +1337,26 @@
   // aggregated, and can only be requested for date ranges of 31 days or less.
   optional int64 unique_users_five_plus = 396;

+  // This metric counts the unique individuals who were shown your video ad six
+  // or more times within the selected date range. This metric cannot be
+  // aggregated, and can only be requested for date ranges of 31 days or less.
+  optional int64 unique_users_six_plus = 556;
+
+  // This metric counts the unique individuals who were shown your video ad
+  // seven or more times within the selected date range. This metric cannot be
+  // aggregated, and can only be requested for date ranges of 31 days or less.
+  optional int64 unique_users_seven_plus = 557;
+
+  // This metric counts the unique individuals who were shown your video ad
+  // eight or more times within the selected date range. This metric cannot be
+  // aggregated, and can only be requested for date ranges of 31 days or less.
+  optional int64 unique_users_eight_plus = 558;
+
+  // This metric counts the unique individuals who were shown your video ad nine
+  // or more times within the selected date range. This metric cannot be
+  // aggregated, and can only be requested for date ranges of 31 days or less.
+  optional int64 unique_users_nine_plus = 559;
+
   // This metric counts the unique individuals who were shown your video ad ten
   // or more times within the selected date range. This metric cannot be
   // aggregated, and can only be requested for date ranges of 31 days or less.
@@ -2147,6 +2168,132 @@
   // Percentage delta comparing the advertiser's offered price against the
   // lowest competing price for the same property.
   optional double vertical_ads_price_difference_percentage = 534;
+
+  // The difference in search query volume between the exposed and control
+  // groups, expressed as a fraction of search queries in the control group.
+  // This indicates the percentage increase in search activity driven by ad
+  // exposure.
+  optional double relative_search_lift = 535;
+
+  // The lower bound of the 90% confidence interval for relative search lift.
+  // Represents a statistically conservative estimate of the minimum percentage
+  // increase in search activity attributable to ad exposure.
+  optional double relative_search_lift_p90_lower_bound = 536;
+
+  // The upper bound of the 90% confidence interval for relative search lift.
+  // Represents a statistically optimistic estimate of the maximum percentage
+  // increase in search activity attributable to ad exposure.
+  optional double relative_search_lift_p90_upper_bound = 537;
+
+  // The p-value for incremental searches. Represents the statistical
+  // probability that the observed increase in search queries occurred by chance
+  // rather than being caused by the ad exposure.
+  optional double incremental_searches_p_value = 538;
+
+  // The total cost (in micros) of ad impressions served for this Search Lift
+  // measurement slice during the study flight. One million is equivalent to
+  // one unit of currency.
+  optional int64 search_lift_cost_micros = 539;
+
+  // The total number of ad impressions served for this Search Lift
+  // measurement slice during the study flight.
+  optional int64 search_lift_impressions = 540;
+
+  // The estimated number of incremental search queries driven by ad exposure,
+  // normalized across exposed and control groups. This metric is only reported
+  // when lift is statistically positive.
+  optional double normalized_incremental_searches = 541;
+
+  // The lower bound of the 90% confidence interval for normalized incremental
+  // searches. Represents a statistically conservative estimate of the minimum
+  // additional search queries driven by ad exposure.
+  optional double normalized_incremental_searches_p90_lower_bound = 542;
+
+  // The upper bound of the 90% confidence interval for normalized incremental
+  // searches. Represents a statistically optimistic estimate of the maximum
+  // additional search queries driven by ad exposure.
+  optional double normalized_incremental_searches_p90_upper_bound = 543;
+
+  // The estimated number of incremental search queries generated per unit of
+  // ad spend (in advertiser currency). Measures the cost efficiency of the
+  // campaign in driving search behavior. Only reported when lift is
+  // statistically positive.
+  optional double normalized_incremental_searches_per_cost = 544;
+
+  // The lower bound of the 90% confidence interval for normalized incremental
+  // searches per cost.
+  optional double normalized_incremental_searches_per_cost_p90_lower_bound =
+      545;
+
+  // The upper bound of the 90% confidence interval for normalized incremental
+  // searches per cost.
+  optional double normalized_incremental_searches_per_cost_p90_upper_bound =
+      546;
+
+  // The estimated number of incremental search queries generated per ad
+  // impression. Measures the effectiveness of each ad exposure in driving
+  // search behavior. Only reported when lift is statistically positive.
+  optional double normalized_incremental_searches_per_impression = 547;
+
+  // The lower bound of the 90% confidence interval for normalized incremental
+  // searches per impression.
+  optional double
+      normalized_incremental_searches_per_impression_p90_lower_bound = 548;
+
+  // The upper bound of the 90% confidence interval for normalized incremental
+  // searches per impression.
+  optional double
+      normalized_incremental_searches_per_impression_p90_upper_bound = 549;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad at
+  // least once within the selected date range.
+  optional ReachMetricInfo unique_users_info = 550;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad two
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_two_plus_info = 551;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad three
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_three_plus_info = 552;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad four
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_four_plus_info = 553;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad five
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_five_plus_info = 554;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad six
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_six_plus_info = 560;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad seven
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_seven_plus_info = 561;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad eight
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_eight_plus_info = 562;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad nine
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_nine_plus_info = 563;
+
+  // Additional information (e.g. quality of reach data) about the metric
+  // representing the number of unique individuals who were shown your ad ten
+  // or more times within the selected date range.
+  optional ReachMetricInfo unique_users_ten_plus_info = 555;
 }

 // Search volume range.
@@ -2158,3 +2305,11 @@
   // Upper bound of search volume.
   optional int64 max = 2;
 }
+
+// Container for storing the additional information about ad reach.
+message ReachMetricInfo {
+  // The state of the reach metric, providing additional information on reach
+  // metrics.
+  repeated google.ads.googleads.v26.enums.ReachMetricStateEnum.ReachMetricState
+      reach_metric_states = 1;
+}