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

此页面由 Cloud Translation API 翻译。

user_location_view

用户位置信息视图。“用户所在位置”视图包含在国家/地区一级汇总的所有指标，每个国家/地区一行。它会按已定位或未定位的地理位置报告用户实际所处的地理位置的指标。如果使用其他细分字段，则每个国家/地区可能会有多个行。

归因资源
customer

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

细分资源
ad_group
campaign

如果您在 SELECT 和 WHERE 子句中选择此资源以及上述资源中的字段，则系统会对指标进行细分。

字段/细分/指标

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

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

资源字段
country_criterion_id
resource_name
targeting_location

细分
ad_network_type
conversion_action
conversion_action_category
conversion_action_name
date
day_of_week
device
geo_target_city
geo_target_metro
geo_target_region
month
quarter
周
年

指标
all_conversions
all_conversions_from_interactions_rate
all_conversions_value
average_cost
average_cpc
average_cpm
点击次数
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
转化次数
conversions_from_interactions_rate
conversions_value
cost_micros
cost_per_all_conversions
每次转化费用
cross_device_conversions
cross_device_conversions_value
ctr
展示次数
interaction_event_types
interaction_rate
interactions
value_per_all_conversions
value_per_conversion

user_location_view.country_criterion_id
字段说明	国家/地区的条件 ID。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

user_location_view.resource_name
字段说明	用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式：`customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}`
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	错误
重复	错误

user_location_view.targeting_location
字段说明	指明是否定位到地理位置。
类别	`ATTRIBUTE`
数据类型	`BOOLEAN`
输入网址	`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.geo_target_city
字段说明	表示城市的地理位置定位目标常量的资源名称。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

segments.geo_target_metro
字段说明	代表都市圈的地理位置定位目标常量的资源名称。
类别	`SEGMENT`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

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

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

segments.quarter
字段说明	由一个季度第一天的日期表示的季度。对季度使用日历年，例如 2018 年第 2 季度从 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_from_interactions_rate
字段说明	互动带来的所有转化（与浏览型转化不同）次数除以广告互动次数。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

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

metrics.average_cost
字段说明	您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。
类别	`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.average_cpm
字段说明	平均每千次展示费用 (CPM)。此指标是一个货币值，默认以客户的币种返回。如需查看 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.client_account_view_through_conversions
字段说明	浏览型转化总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
类别	`METRIC`
数据类型	`INT64`
输入网址	`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) 之和。此指标是一个货币值，默认以客户的币种返回。请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看 metrics_currency 参数
类别	`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_value
字段说明	跨设备转化的值的总和。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

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

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

metrics.interaction_event_types
字段说明	付费和免费互动的类型。
类别	`METRIC`
数据类型	`ENUM`
输入网址	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
可过滤	正确
可选择	正确
Sortable	错误
重复	正确

metrics.interaction_rate
字段说明	在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。
类别	`METRIC`
数据类型	`DOUBLE`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

metrics.interactions
字段说明	互动次数。互动是指与某种广告格式关联的主用户操作：对于文字广告和购物广告而言是点击，对于视频广告而言是观看，诸如此类。
类别	`METRIC`
数据类型	`INT64`
输入网址	`N/A`
可过滤	正确
可选择	正确
Sortable	正确
重复	错误

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

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

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

字段/细分/指标

user_location_view.country_criterion_id

user_location_view.resource_name

user_location_view.targeting_location

segments.ad_network_type

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.geo_target_city

segments.geo_target_metro

segments.geo_target_region

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_value

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

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_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.value_per_all_conversions

metrics.value_per_conversion

user_location_view