Search Ads 360 查询语言

借助 Search Ads 360 查询语言,您可以构建搜索查询,以使用 Search Ads 360 Reporting API 检索报告数据和资源元数据。

搜索服务

您可以使用 Search Ads 360 查询语言通过以下方式查询 API:

SearchAds360Service

您可以使用此服务查询资源及其相关属性、细分和指标。有两种方法,即 SearchSearchStream

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 且展示次数超过 1000 的广告系列。
  • 每个返回的 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 且展示次数超过 1000 的广告系列。
  • 按日期细分数据。
  • 经过细分后,每个 SearchAds360Row 都代表一个广告系列和日期细分的元组。
  • 查询会按广告系列 ID 进行排序。

如需查看可在查询中使用的细分列表,请参阅 segments;如需详细了解如何对报告进行细分,请参阅细分

这是对 campaign 资源的基本查询,用于联接 bidding_strategy 资源的属性(如果有)。这种关联资源称为归因资源。

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • 该查询会从选定的每个广告系列中选择广告系列属性和相关属性。
  • 每个返回的 SearchAds360Row 代表一个 campaign 对象,其中填充了所选的广告系列属性以及所选的出价策略属性 bidding_strategy.name

请参阅 campaign,了解哪些归因资源可用于广告系列查询。

查询字段元数据

您可以使用 SearchAds360FieldService 检索字段元数据。

以下是针对字段元数据的基本查询:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • 将 RESOURCE OR FIELD 替换为资源(例如 customercampaign)或字段(例如 campaign.idmetrics.impressionsad_group.id)。

如需详细了解如何检索字段元数据,请参阅检索资源元数据

了解详情

详细了解如何在 Search Ads 360 Reporting API 中构建查询: