借助 Search Ads 360 查询语言,您可以构建搜索查询,以便使用 Search Ads 360 Reporting API 检索报告数据和资源元数据。
搜索服务
您可以使用以下 Search Ads 360 查询语言来查询 API:
SearchAds360Service
使用此服务可查询资源及其相关属性、细分和指标。有两个方法:
Search
和SearchStream
。SearchAds360Service
查询会返回SearchAds360Row
实例的列表:- 每一行代表一项资源。
- 如果已请求,行中会包含属性和指标字段。
- 如果您请求细分,则会为每个细分-资源元组包含额外的行。
如需了解详情,请参阅创建搜索报告。
SearchAds360FieldService
使用此服务可查询有关可用字段和资源的元数据。该服务提供了一个可查询字段目录,其中包含有关其兼容性和类型的详细信息。
SearchAds360FieldService
会返回SearchAds360Field
实例的列表:- 每个字段都包含有关所请求字段的详细信息。
如需了解详情,请参阅检索资源元数据。
基本查询示例
以下部分提供了基本的查询示例,您可以根据这些示例调整这些示例来构建自己的查询。
查询资源的特性
下面是针对 campaign
资源的属性的基本查询,该资源会返回广告系列 ID、名称和状态:
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
- 每个返回的
SearchAds360Row
代表一个campaign
对象。 - 这些行会填充所选字段(包括给定广告系列的
resource_name
)。 - 查询按广告系列 ID 排序。
如需了解可以在查询中使用的其他可用字段,请参阅 campaign
。
查询指标
这是一个基本查询,适用于与 campaign
资源的属性相关的指标:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- 该查询会返回状态为
PAUSED
且展示次数超过 1,000 次的广告系列。 - 每个返回的
SearchAds360Row
都有一个填充了所选指标的metrics
字段。 - 查询按广告系列 ID 排序。
如需了解可在查询中使用的其他可用指标,请参阅 metrics
。
查询细分
以下是针对与 campaign
资源的特性相关的细分的基本查询:
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- 该查询会返回状态为
PAUSED
且展示次数超过 1,000 次的广告系列。 - 它会按日期细分数据。
- 细分后,每个
SearchAds360Row
都代表广告系列和日期细分的一个元组。 - 查询按广告系列 ID 排序。
如需查看您可以在查询中使用的细分列表,请参阅 segments
;如需详细了解如何细分报告,请参阅细分。
查询相关资源的特性
这是针对 campaign
资源的基本查询,用于联接 bidding_strategy
资源的属性(如果有)。这种类型的相关资源称为归因资源。
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- 该查询从选定的每个广告系列中选择广告系列属性及相关属性。
- 每个返回的
SearchAds360Row
都表示一个使用所选广告系列属性以及所选出价策略属性bidding_strategy.name
填充的campaign
对象。
如需了解哪些归因资源可用于广告系列查询,请参阅 campaign
。
查询字段元数据
您可以使用 SearchAds360FieldService
检索字段元数据。
以下是针对字段元数据的基本查询:
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- 将 RESOURCE OR FIELD 替换为资源(例如
customer
或campaign
)或字段(例如campaign.id
、metrics.impressions
或ad_group.id
)。
如需详细了解如何检索字段元数据,请参阅检索资源元数据。
了解详情
详细了解如何在 Search Ads 360 Reporting API 中构建查询: