歡迎在 1 月 29 日美國東部時間上午 10 點，透過 Discord 的 Google 廣告與評估社群伺服器和 YouTube 加入直播！我們將討論 Google Ads API 第 23 版新增的功能。
/common/metrics.proto

--- v22/common/metrics.proto    2026-01-23 15:36:15.000000000 +0000
+++ v23/common/metrics.proto    2026-01-23 15:36:25.000000000 +0000
@@ -377,12 +377,22 @@
   // Cross-device conversions are already included in all_conversions.
   optional double cross_device_conversions = 173;

+  // The number of cross-device conversions by conversion date.
+  // Details for the by_conversion_date columns are available at
+  // https://support.google.com/google-ads/answer/9549009.
+  optional double cross_device_conversions_by_conversion_date = 372;
+
   // The sum of the value of cross-device conversions.
   optional double cross_device_conversions_value = 253;

   // The sum of the value of cross-device conversions, in micros.
   optional int64 cross_device_conversions_value_micros = 312;

+  // The sum of cross-device conversions value by conversion date.
+  // Details for the by_conversion_date columns are available at
+  // https://support.google.com/google-ads/answer/9549009.
+  optional double cross_device_conversions_value_by_conversion_date = 373;
+
   // The number of clicks your ad receives (Clicks) divided by the number
   // of times your ad is shown (Impressions).
   optional double ctr = 174;
@@ -1077,38 +1087,6 @@
   // CampaignAggregateAssetView.
   repeated string linked_sample_entities = 342;

-  // A list of up to 20 sample linked resources with impressions in the last 30
-  // days where the asset had the AssetPerformanceLabel.BEST performance label.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  repeated string sample_best_performance_entities = 343;
-
-  // A list of up to 20 sample linked resources with impressions in the last 30
-  // days where the asset had the AssetPerformanceLabel.GOOD performance label.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  repeated string sample_good_performance_entities = 344;
-
-  // A list of up to 20 sample linked resources with impressions in the last 30
-  // days where the asset had the AssetPerformanceLabel.LOW performance label.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  repeated string sample_low_performance_entities = 345;
-
-  // A list of up to 20 sample linked resources with impressions in the last 30
-  // days where the asset had the AssetPerformanceLabel.LEARNING performance
-  // label.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  repeated string sample_learning_performance_entities = 346;
-
-  // A list of up to 20 sample linked resources with impressions in the last 30
-  // days where the assets had AssetPerformanceLabel performance label other
-  // than BEST, GOOD, LOW, and LEARNING.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  repeated string sample_unrated_performance_entities = 347;
-
   // Number of total usages in which the asset is pinned.
   // This metric can only be selected with ChannelAggregateAssetView and
   // CampaignAggregateAssetView.
@@ -1145,76 +1123,6 @@
   // This metric is only supported in Search channel.
   optional int64 asset_pinned_as_description_position_two_count = 353;

-  // Percentage of impressions the asset received in ads with
-  // AssetPerformanceLabel.BEST.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Search channel.
-  optional double asset_best_performance_impression_percentage = 354;
-
-  // Percentage of impressions the asset received in ads with
-  // AssetPerformanceLabel.GOOD.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Search channel.
-  optional double asset_good_performance_impression_percentage = 355;
-
-  // Percentage of impressions the asset received in ads with
-  // AssetPerformanceLabel.LOW.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Search channel.
-  optional double asset_low_performance_impression_percentage = 356;
-
-  // Percentage of impressions the asset received in ads with
-  // AssetPerformanceLabel.LEARNING.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Search channel.
-  optional double asset_learning_performance_impression_percentage = 357;
-
-  // Percentage of impressions the asset received in ads with
-  // AssetPerformanceLabel other than BEST, GOOD, LOW, and LEARNING.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Search channel.
-  optional double asset_unrated_performance_impression_percentage = 358;
-
-  // Percentage of cost the asset received in ads with
-  // AssetPerformanceLabel.BEST.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Performance Max channel.
-  optional double asset_best_performance_cost_percentage = 359;
-
-  // Percentage of cost the asset received in ads with
-  // AssetPerformanceLabel.GOOD.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Performance Max channel.
-  optional double asset_good_performance_cost_percentage = 360;
-
-  // Percentage of cost the asset received in ads with
-  // AssetPerformanceLabel.LOW.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Performance Max channel.
-  optional double asset_low_performance_cost_percentage = 361;
-
-  // Percentage of cost the asset received in ads with
-  // AssetPerformanceLabel.LEARNING.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Performance Max channel.
-  optional double asset_learning_performance_cost_percentage = 362;
-
-  // Percentage of cost the asset received in ads with AssetPerformanceLabel
-  // other than BEST, GOOD, LOW, and LEARNING.
-  // This metric can only be selected with ChannelAggregateAssetView and
-  // CampaignAggregateAssetView.
-  // This metric is only supported in Performance Max channel.
-  optional double asset_unrated_performance_cost_percentage = 363;
-
   // The amount of business visits attributed by the last click model.
   optional double store_visits_last_click_model_attributed_conversions = 365;

@@ -1352,6 +1260,78 @@
   // Average video watch time duration in milliseconds for video impressions
   // that started playing.
   optional int64 average_video_watch_time_duration_millis = 404;
+
+  // This feature is available to allowlisted accounts only.
+  optional int64 svr = 411;
+
+  // The number of impressions for which Active View could measure if the ad was
+  // audible.
+  optional int64 active_view_audibility_measurable_impressions = 412;
+
+  // The number of impressions for which Active View could measure if the ad was
+  // audible, divided by the total number of impressions with Active View audio
+  // enabled.
+  optional double active_view_audibility_measurable_impressions_rate = 413;
+
+  // The number of impressions for which Active View could measure audibility,
+  // but that were filtered out by traffic quality filters, divided by the
+  // total number of impressions measurable for audibility.
+  optional double active_view_audibility_invalid_measurable_impressions_rate =
+      414;
+
+  // The number of impressions for which Active View could measure audibility,
+  // but that were filtered out by traffic quality filters, divided by the total
+  // number of impressions measurable for audibility. Only includes GIVT
+  // (general invalid traffic) impressions.
+  optional double
+      active_view_audibility_invalid_givt_measurable_impressions_rate = 415;
+
+  // The number of impressions that were audible (volume > 0%) at any point
+  // during the ad playback.
+  optional int64 active_view_audible_impressions = 416;
+
+  // The number of impressions that were audible (volume > 0%) at any point
+  // during the ad playback, divided by the total number of impressions
+  // measurable for audibility.
+  optional double active_view_audible_impressions_rate = 417;
+
+  // The number of impressions that were audible for at least 2 seconds
+  // (cumulative).
+  optional int64 active_view_audible_two_seconds_impressions = 418;
+
+  // The number of impressions that were audible for at least 2 seconds
+  // (cumulative), divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_two_seconds_impressions_rate = 419;
+
+  // The number of impressions that were audible for at least 30 seconds
+  // (cumulative).
+  optional int64 active_view_audible_thirty_seconds_impressions = 420;
+
+  // The number of impressions that were audible for at least 30 seconds
+  // (cumulative), divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_thirty_seconds_impressions_rate = 421;
+
+  // The number of impressions that were audible at the first quartile of the
+  // ad playback, divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_quartile_p25_rate = 422;
+
+  // The number of impressions that were audible at the second quartile of the
+  // ad playback, divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_quartile_p50_rate = 423;
+
+  // The number of impressions that were audible at the third quartile of the
+  // ad playback, divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_quartile_p75_rate = 424;
+
+  // The number of impressions that were audible at the fourth quartile of the
+  // ad playback, divided by the total number of impressions measurable for
+  // audibility.
+  optional double active_view_audible_quartile_p100_rate = 425;
 }

 // Search volume range.
/common/metrics.proto 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

/common/metrics.proto
