Search Ads 360 查詢語言

您可以利用 Search Ads 360 查詢語言建立搜尋查詢，透過 Search Ads 360 Reporting API 擷取報表資料和資源中繼資料。

搜尋服務

您可以利用以下工具，透過 Search Ads 360 查詢語言查詢 API：

SearchAds360Service

您可以使用此服務查詢資源及相關的屬性、區隔和指標。有兩種方法：Search 和 SearchStream。

SearchAds360Service 查詢會傳回 SearchAds360Row 執行個體的清單：

  • 每一列代表一個資源。
  • 如有需要，資料列會包含屬性和指標欄位。
  • 如果您要求區隔，則每個區隔資源元組會另外加入不同的資料列。

詳情請參閱「建立搜尋報表」。

SearchAds360FieldService

您可以使用這項服務查詢可用欄位和資源的相關中繼資料。這項服務提供可供查詢欄位的目錄，其中包含相容性和類型的詳細資訊。

SearchAds360FieldService 會傳回 SearchAds360Field 執行個體的清單：

  • 每個欄位都包含要求欄位的詳細資料。

詳情請參閱擷取資源中繼資料。

基本查詢範例

下列各節提供基本的查詢範例，並可用於建構自己的查詢。

查詢資源屬性

這個基本查詢適用於傳回廣告活動 ID、名稱和狀態的 campaign 資源屬性：

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，瞭解可在查詢中使用的區隔清單；如要進一步瞭解區隔報表，請參閱「區隔」一文。

這是彙整 bidding_strategy 資源屬性 (如有) 的 campaign 資源基本查詢。這類相關資源稱為歸因資源。

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 中建立查詢：