发送反馈
user_location_view
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
用户位置信息视图。“用户所在位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按已定位或未定位的地理位置报告用户实际所处的地理位置的指标。如果使用其他细分字段,则每个国家/地区可能会有多个行。
您可以在 SELECT 和 WHERE 子句中同时选择上述资源中的字段以及此资源。这些字段不会对 SELECT
子句中的指标进行细分 。
如果您在 SELECT 和 WHERE 子句中选择此资源以及上述资源中的字段,则系统会对指标进行细分 。
字段/细分/指标
此页面显示了可与 user_location_view
的字段放入同一 SELECT 子句中的所有指标和细分。
不过,如果您在 FROM 子句中指定 user_location_view
,则无法使用某些指标和细分。
使用以下过滤条件以仅显示在 FROM 子句中指定 user_location_view
时可以使用的字段。
查询的 FROM 子句中是否指定了 user_location_view
?
否
是的,这违反了相关政策
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.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_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 正确
重复 错误
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-05-08。
需要向我们提供更多信息?
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-05-08。"],[[["The User Location View provides geographical insights into campaign performance by aggregating metrics at the country level, distinguishing between targeted and non-targeted locations."],["Marketers can leverage segments like ad network type, conversion details, date ranges, device, and geographical targets (city, metro, region) to analyze user location data."],["A wide array of metrics, including clicks, conversions, cost, impressions, and interaction rates, can be queried to understand user behavior and campaign effectiveness across different locations."],["Resources like customer data can be selected for analysis, while ad group and campaign data can be utilized to segment the metrics for deeper insights."],["The provided table outlines various fields, segments, and metrics available within the `user_location_view`, specifying their data types, filterability, selectability, and sortability for customized reporting."]]],["The user location view aggregates metrics at the country level, showing user's physical location. Key data includes `country_criterion_id`, `resource_name`, and `targeting_location`. Metrics like `clicks`, `impressions`, `conversions`, and `cost_micros` are tracked, with segments such as `ad_network_type`, `date`, and `device` providing context. Data can be segmented by `ad_group` and `campaign`. All metrics and segments are filterable and selectable, and most are sortable, which support filtering, selection, and sorting functions.\n"]]