/common/metrics.proto

--- v16/common/metrics.proto    2024-05-29 16:00:42.000000000 +0000
+++ v17/common/metrics.proto    2024-05-29 16:00:49.000000000 +0000
@@ -75,7 +75,7 @@
   // values in date column means the conversion date. Details for the
   // by_conversion_date columns are available at
   // https://support.google.com/google-ads/answer/9549009.
-  double all_conversions_value_by_conversion_date = 240;
+  optional double all_conversions_value_by_conversion_date = 240;

   // All of new customers' lifetime conversion value. If you have set up
   // customer acquisition goal at either account level or campaign level, this
@@ -95,7 +95,7 @@
   // with date, the values in date column means the conversion date. Details for
   // the by_conversion_date columns are available at
   // https://support.google.com/google-ads/answer/9549009.
-  double all_conversions_by_conversion_date = 241;
+  optional double all_conversions_by_conversion_date = 241;

   // The value of all conversions divided by the total cost of ad interactions
   // (such as clicks for text ads or views for video ads).
@@ -308,7 +308,7 @@
   // column means the conversion date. Details for the by_conversion_date
   // columns are available at
   // https://support.google.com/google-ads/answer/9549009.
-  double conversions_value_by_conversion_date = 242;
+  optional double conversions_value_by_conversion_date = 242;

   // New customers' lifetime conversion value. If you have set up
   // customer acquisition goal at either account level or campaign level, this
@@ -345,7 +345,7 @@
   // column means the conversion date. Details for the by_conversion_date
   // columns are available at
   // https://support.google.com/google-ads/answer/9549009.
-  double conversions_by_conversion_date = 243;
+  optional double conversions_by_conversion_date = 243;

   // The sum of your cost-per-click (CPC) and cost-per-thousand impressions
   // (CPM) costs during this period.
@@ -1038,6 +1038,154 @@
   // for date ranges of 92 days or less. This metric is available for following
   // campaign types - Display, Video, Discovery and App.
   optional double average_impression_frequency_per_user = 320;
+
+  // Number of linked resources in which the asset is used.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  optional int64 linked_entities_count = 341;
+
+  // A list of up to 20 sample linked resources in which the asset is used.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // 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.
+  // This metric is only supported in Search channel.
+  optional int64 asset_pinned_total_count = 348;
+
+  // Number of entities in which the asset is pinned to headline 1.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  // This metric is only supported in Search channel.
+  optional int64 asset_pinned_as_headline_position_one_count = 349;
+
+  // Number of entities in which the asset is pinned to headline 2.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  // This metric is only supported in Search channel.
+  optional int64 asset_pinned_as_headline_position_two_count = 350;
+
+  // Number of entities in which the asset is pinned to headline 3.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  // This metric is only supported in Search channel.
+  optional int64 asset_pinned_as_headline_position_three_count = 351;
+
+  // Number of entities in which the asset is pinned to description 1.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  // This metric is only supported in Search channel.
+  optional int64 asset_pinned_as_description_position_one_count = 352;
+
+  // Number of entities in which the asset is pinned to description 2.
+  // This metric can only be selected with ChannelAggregateAssetView and
+  // CampaignAggregateAssetView.
+  // 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;
 }

 // Search volume range.