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