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」或「FIELD」替換為資源 (例如 customer 或 campaign) 或欄位 (例如 campaign.id、 metrics.impressions 或 ad_group.id)。
，瞭解如何調查及移除這項存取權。

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

瞭解詳情

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