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

此页面由 Cloud Translation API 翻译。

访问

一次光顾。

归因资源
ad_group
ad_group_criterion
campaign
customer

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

字段/细分/指标

此页面显示了可放入与 visit 的字段相同的 SELECT 子句中的所有指标和细分。但是，在 FROM 子句中指定 visit 时，某些指标和细分将无法使用。使用以下过滤条件仅显示在 FROM 子句中指定 visit 时可以使用的字段。

是否在查询的 FROM 子句中指定 visit？

资源字段
ad_id
asset_field_type
asset_id
click_id
criterion_id
id [ID]
merchant_id
product_channel
product_country_code
product_id
product_language_code
product_store_id
resource_nameresource_name
visit_date_time

细分
ad_network_type
日期
设备
月
季度
周
年

visit.ad_id
字段说明	广告 ID。值为 0 表示广告未归因。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.asset_field_type
字段说明	访问事件的素材资源字段类型。
类别	`ATTRIBUTE`
数据类型	`ENUM AD_IMAGE BOOK_ON_GOOGLE BUSINESS_LOGO BUSINESS_NAME CALL CALLOUT CALL_TO_ACTION_SELECTION DESCRIPTION DISCOVERY_CAROUSEL_CARD HEADLINE HOTEL_CALLOUT HOTEL_PROPERTY LANDSCAPE_LOGO LEAD_FORM LOGO LONG_HEADLINE MANDATORY_AD_TEXT MARKETING_IMAGE MEDIA_BUNDLE MOBILE_APP PORTRAIT_MARKETING_IMAGE PRICE PROMOTION SITELINK SQUARE_MARKETING_IMAGE STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED VIDEO YOUTUBE_VIDEO`
输入网址	`google.ads.searchads360.v0.enums.AssetFieldTypeEnum.AssetFieldType`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.asset_id
字段说明	访问事件期间互动过的素材资源的 ID。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.click_id
字段说明	作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.criterion_id
字段说明	Search Ads 360 关键字 ID。值为 0 表示关键字未归因。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.id
字段说明	访问的 ID。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.merchant_id
字段说明	包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时，Search Ads 360 会生成此 ID。
类别	`ATTRIBUTE`
数据类型	`INT64`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.product_channel
字段说明	获得点击的商品的销售渠道：线上或本地。
类别	`ATTRIBUTE`
数据类型	`ENUM LOCAL ONLINE UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.ProductChannelEnum.ProductChannel`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.product_country_code
字段说明	为包含获得点击的商品的商品目录 Feed 注册的国家/地区（ISO-3166 格式）。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.product_id
字段说明	所点击产品的 ID。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.product_language_code
字段说明	为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.product_store_id
字段说明	获得点击的本地商品目录广告中的商店。这应与本地商品 Feed 中使用的商店 ID 一致。
类别	`ATTRIBUTE`
数据类型	`STRING`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

visit.resource_name
字段说明	访问的资源名称。访问资源名称的格式为：`customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}`
类别	`ATTRIBUTE`
数据类型	`RESOURCE_NAME`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	False
重复	False

visit.visit_date_time
字段说明	访问事件的时间戳。时间戳采用客户的时区，并采用“yyyy-MM-dd HH:mm:ss”格式。
类别	`ATTRIBUTE`
数据类型	`DATE`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.ad_network_type
字段说明	广告网络类型。
类别	`SEGMENT`
数据类型	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
输入网址	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.date
字段说明	指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.device
字段说明	应用指标的设备。
类别	`SEGMENT`
数据类型	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
输入网址	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.month
字段说明	由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.quarter
字段说明	由一个季度第一天的日期表示的季度。使用日历年表示季度，例如，2018 年第二季度从 2018-04-01 开始。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.week
字段说明	定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
类别	`SEGMENT`
数据类型	`DATE`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

segments.year
字段说明	年份，格式为 yyyy。
类别	`SEGMENT`
数据类型	`INT32`
输入网址	`N/A`
是否能用作过滤条件？	True
可选择	True
Sortable	True
重复	False

访问

字段/细分/指标

visit.ad_id

visit.asset_field_type

visit.asset_id

visit.click_id

visit.criterion_id

visit.id

visit.merchant_id

visit.product_channel

visit.product_country_code

visit.product_id

visit.product_language_code

visit.product_store_id

visit.resource_name

visit.visit_date_time

segments.ad_network_type

segments.date

segments.device

segments.month

segments.quarter

segments.week

segments.year