Search Ads 360 查詢語言

您可以使用 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 且曝光次數超過 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
  • 將「資源或欄位」替換為資源 (例如 customer 或 campaign) 或欄位 (例如 campaign.id、metrics.impressions 或 ad_group.id)。

如要進一步瞭解如何擷取欄位中繼資料，請參閱「擷取資源中繼資料」。

瞭解詳情

進一步瞭解如何在 Search Ads 360 Reporting API 中建立查詢：