Search Ads 360 查询语言

Search Ads 360 查询语言可让您构建搜索查询，以便从 报告数据和资源元数据。

搜索服务

您可以使用 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 且数量超过 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 替换为资源（例如 customer 或 campaign）或字段（例如 campaign.id、 metrics.impressions 或 ad_group.id）。
。

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

了解详情

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