--- 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; +}
/common/metrics.proto
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 2026-10-27 UTC.