有兴趣分享您对 Google Ads API 的反馈吗？
注册即可获邀参与用户调研！
/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.
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-08-21。
[null,null,["最后更新时间 (UTC)：2024-08-21。"],[[["Several metrics related to conversions, such as `all_conversions_value_by_conversion_date`, `all_conversions_by_conversion_date`, and `conversions_value_by_conversion_date`, are now optional fields."],["New metrics have been introduced to provide insights into asset performance, including linked entities count, sample linked entities, performance label-based sample entities, asset pinning details, and performance label-based impression/cost percentages."],["These asset performance metrics are primarily available for ChannelAggregateAssetView and CampaignAggregateAssetView, with some specifically for Search or Performance Max channels."]]],[]]
