新版 Search Ads 360 Reporting API 现已发布。您可以加入 searchads-api-announcements Google 网上论坛，及时了解即将发布的增强功能和版本。

此页面由 Cloud Translation API 翻译。

shopping_performance_view

购物广告效果视图。提供按多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的商品维度值（例如品牌、类别、自定义属性、商品状况和商品类型）将反映相应事件记录的日期和时间各个维度的状态。

归因资源
customer

您可以在 SELECT 和 WHERE 子句中选择上述资源以及此资源中的字段。这些字段不会细分 SELECT 子句中的指标。

细分资源
ad_group
campaign

如果在 SELECT 和 WHERE 子句中同时选择上述资源中的字段以及此资源，则会细分指标。

字段/细分/指标

此页面显示了可与 shopping_performance_view 的字段放入同一 SELECT 子句中的所有指标和细分。不过，如果您在 FROM 子句中指定 shopping_performance_view，则无法使用某些指标和细分。使用以下过滤条件可仅显示在 FROM 子句中指定 shopping_performance_view 时可使用的字段。

您的查询的 FROM 子句中是否指定了 shopping_performance_view？

资源相关字段
resource_nameresource_name

细分
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
date
周几
device
month
product_bidding_category_level1
product_bidding_category_level2
product_bidding_category_level3
product_bidding_category_level4
product_bidding_category_level5
product_brand [品牌]
product_channel
product_channel_exclusivity
product_condition [商品使用情况]
product_country
product_custom_attribute0
product_custom_attribute1
product_custom_attribute2
product_custom_attribute3
product_custom_attribute4
product_item_id
product_language [商品语言]
product_store_id
product_title
product_type_l1
product_type_l2 [商品类型 l2]
product_type_l3
product_type_l4 [商品类型 l4]
product_type_l5 [商品类型 l5]
quarter
周
年份

指标
all_conversions
all_conversions_by_conversion_date
all_conversions_from_interactions_rate
all_conversions_value
all_conversions_value_by_conversion_date
average_cpc
点击次数
client_account_conversions
client_account_conversions_value
转化次数
conversions_from_interactions_rate
conversions_value
cost_micros
cost_per_all_conversions
cost_per_conversion
cross_device_conversions
cross_device_conversions_by_conversion_date
cross_device_conversions_value
cross_device_conversions_value_by_conversion_date
ctr
展示次数
search_absolute_top_impression_share
search_click_share
search_impression_share
value_per_all_conversions
value_per_conversion

shopping_performance_view.resource_name
字段说明	购物广告效果视图的资源名称。购物广告效果视图资源名称采用以下格式：`customers/{customer_id}/shoppingPerformanceView`
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	错误
可选择	正确
Sortable	错误
重复	错误

segments.ad_network_type
字段说明	广告网络类型。
类别	`SEGMENT`
数据类型	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
输入网址	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.conversion_action
字段说明	转化操作的资源名称。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.conversion_action_category
字段说明	转化操作类别。
类别	`SEGMENT`
数据类型	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.conversion_action_name
字段说明	转化操作名称。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.date
字段说明	指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.day_of_week
字段说明	星期几，例如星期一。
类别	`SEGMENT`
数据类型	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
输入网址	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.device
字段说明	指标应用于的设备。
类别	`SEGMENT`
数据类型	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.month
字段说明	由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_bidding_category_level1
字段说明	商品的出价类别（第 1 级）。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

segments.product_bidding_category_level2
字段说明	商品的出价类别（第 2 级）。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

segments.product_bidding_category_level3
字段说明	商品的出价类别（第 3 级）。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

segments.product_bidding_category_level4
字段说明	商品的出价类别（第 4 级）。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

segments.product_bidding_category_level5
字段说明	商品的出价类别（第 5 级）。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

segments.product_brand
字段说明	商品的品牌。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_channel
字段说明	商品的渠道。
类别	`SEGMENT`
数据类型	`ENUM LOCAL ONLINE UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_channel_exclusivity
字段说明	商品的渠道独占性。
类别	`SEGMENT`
数据类型	`ENUM MULTI_CHANNEL SINGLE_CHANNEL UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.ProductChannelExclusivityEnum.ProductChannelExclusivity`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_condition
字段说明	商品的使用情况。
类别	`SEGMENT`
数据类型	`ENUM NEW OLD REFURBISHED UNKNOWN UNSPECIFIED USED`
输入网址	`google.ads.searchads360.v0.enums.ProductConditionEnum.ProductCondition`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_country
字段说明	商品目标销售国家/地区的地理位置定位目标常量的资源名称。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_custom_attribute0
字段说明	商品的自定义属性 0。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_custom_attribute1
字段说明	商品的自定义属性 1。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_custom_attribute2
字段说明	商品的自定义属性 2。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_custom_attribute3
字段说明	商品的自定义属性 3。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_custom_attribute4
字段说明	商品的自定义属性 4。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_item_id
字段说明	商品的项目 ID。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_language
字段说明	商品语言的语言常量的资源名称。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_store_id
字段说明	商品的商店 ID。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_title
字段说明	商品的标题。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_type_l1
字段说明	商品的类型（第 1 级）。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_type_l2
字段说明	商品的类型（第 2 级）。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_type_l3
字段说明	商品的类型（第 3 级）。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_type_l4
字段说明	商品的类型（第 4 级）。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.product_type_l5
字段说明	商品的类型（第 5 级）。
类别	`SEGMENT`
数据类型	`STRING`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.quarter
字段说明	由一个季度第一天的日期表示的季度。针对季度使用日历年，例如，2018 年第二季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.week
字段说明	定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.year
字段说明	年份，格式为 yyyy。
类别	`SEGMENT`
数据类型	`INT32`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.all_conversions
字段说明	转化总次数。包括所有转化，无论 include_in_conversions_metric 的值如何。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.all_conversions_by_conversion_date
字段说明	转化总次数。包括所有转化，无论 include_in_conversions_metric 的值如何。如果选择此列并添加了日期，则日期列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.all_conversions_from_interactions_rate
字段说明	互动带来的所有转化（与浏览型转化不同）次数除以广告互动次数。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.all_conversions_value
字段说明	所有转化的值。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.all_conversions_value_by_conversion_date
字段说明	所有转化的价值。如果选择此列并添加了日期，则日期列中的值表示转化日期。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.average_cpc
字段说明	所有点击次数的总费用除以所获得的总点击次数。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.clicks
字段说明	点击次数。
类别	`METRIC`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.client_account_conversions
字段说明	客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.client_account_conversions_value
字段说明	客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.conversions
字段说明	转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.conversions_from_interactions_rate
字段说明	与符合转化条件的互动的平均可出价转化次数（来自互动）。显示广告互动带来可出价转化的平均频率。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.conversions_value
字段说明	“转化”字段中包含的转化带来的转化价值总和。要使用此指标，您必须为各项转化操作输入转化价值。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cost_micros
字段说明	在此期间您的每次点击费用 (CPC) 和每千次展示费用 (CPM) 费用的总和。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
类别	`METRIC`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cost_per_all_conversions
字段说明	广告互动费用除以所有转化次数。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cost_per_conversion
字段说明	每次可出价转化的平均转化次数所对应的转化次数可用的费用。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cross_device_conversions
字段说明	转化是指客户在一台设备上点击广告，然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cross_device_conversions_by_conversion_date
字段说明	按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列，请访问 https://support.google.com/sa360/answer/9250611。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cross_device_conversions_value
字段说明	跨设备转化的值的总和。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.cross_device_conversions_value_by_conversion_date
字段说明	按转化日期汇总的跨设备转化价值。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.ctr
字段说明	广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.impressions
字段说明	广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。
类别	`METRIC`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.search_absolute_top_impression_share
字段说明	在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅 https://support.google.com/sa360/answer/9566729。任何低于 0.1 的值都会报告为 0.0999。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.search_click_share
字段说明	您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.search_impression_share
字段说明	您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.value_per_all_conversions
字段说明	所有转化的价值除以所有转化的次数。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.value_per_conversion
字段说明	可出价转化的价值除以可出价转化的次数。显示每次可出价转化的平均价值。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

shopping_performance_view 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

字段/细分/指标

shopping_performance_view.resource_name

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.month

segments.product_bidding_category_level1

segments.product_bidding_category_level2

segments.product_bidding_category_level3

segments.product_bidding_category_level4

segments.product_bidding_category_level5

segments.product_brand

segments.product_channel

segments.product_channel_exclusivity

segments.product_condition

segments.product_country

segments.product_custom_attribute0

segments.product_custom_attribute1

segments.product_custom_attribute2

segments.product_custom_attribute3

segments.product_custom_attribute4

segments.product_item_id

segments.product_language

segments.product_store_id

segments.product_title

segments.product_type_l1

segments.product_type_l2

segments.product_type_l3

segments.product_type_l4

segments.product_type_l5

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_by_conversion_date

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_value

metrics.all_conversions_value_by_conversion_date

metrics.average_cpc

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.conversions

metrics.conversions_from_interactions_rate

metrics.conversions_value

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cost_per_conversion

metrics.cross_device_conversions

metrics.cross_device_conversions_by_conversion_date

metrics.cross_device_conversions_value

metrics.cross_device_conversions_value_by_conversion_date

metrics.ctr

metrics.impressions

metrics.search_absolute_top_impression_share

metrics.search_click_share

metrics.search_impression_share

metrics.value_per_all_conversions

metrics.value_per_conversion

shopping_performance_view