您可以利用 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 中建立查詢: