本指南將 Google Ads UI 報表的概念和命名慣例,對應至使用 Google Ads 查詢語言 (GAQL) 和 Google Ads API 產生的報表。
常見的 UI 詞彙
下表歸納了使用者介面中使用的部分常見詞彙,以及這些字詞與 Google Ads 查詢語言 (GAQL) 的對應關係。
UI | GAQL |
---|---|
欄 | GAQL 查詢 SELECT 子句中的任何資源、區隔欄位或指標。 |
日期範圍 | 日期範圍會對應至 segments.date 的 WHERE 子句。 |
濾鏡 | WHERE 子句中的一或多個條件。 |
區隔欄位 | 在 GAQL 查詢中加入區隔欄位,藉此套用區隔。 |
分頁 | Paging 會將查詢的結果集分成多個頁面。 |
欄
UI 中的資料欄等同於 GAQL 中的資源欄位、區隔欄位和指標。
篩選
日期範圍
Google Ads 使用者介面提供顯示帳戶統計資料的表格,以及用來控制統計資料日期範圍的下拉式選單。
您可以透過在 GAQL 查詢的 WHERE 子句中篩選segments.date
,進行相同的 GAQL 控制。
篩選器
UI 中的篩選器等同於 GAQL WHERE 子句中的一或多個條件。
區隔
查看精細的統計資料時,您可以按區隔來切割資料。比如說,您可能想知道 Google 搜尋聯播網和 Google 多媒體廣告聯播網分別帶來的廣告曝光次數。在此情況下,您可以按聯播網區隔報表。如要瞭解如何在 SELECT 子句中加入區隔欄位,請參閱區隔相關說明。
分頁
您可以使用各資料表底部提供的控制項,在使用者介面中瀏覽報表,藉此切換頁面,並從已定義的大小組合中選取要顯示的結果數量。
使用 GoogleAdsService.Search
透過 next_page_token
擷取報表時,可以使用分頁瀏覽結果。如要在不分頁的情況下擷取整個結果集,請使用 GoogleAdsService.SearchStream
。
排序結果
在使用者介面中,您可以選取資料欄來排序結果。
在 GAQL 中,您可以使用 ORDER BY 子句和 LIMIT 子句排序查詢結果。
下載格式
在 UI 中,報表能以各種格式下載,例如 CSV、TSV 或 XML。
API 不會在輸出中直接支援不同格式,因此您必須執行一些後續處理作業。請參閱在用戶端中實作 CSV 格式的程式碼範例。
安排報表執行時間並以電子郵件傳送
使用者介面提供報表排程和電子郵件傳送功能,但 API 不支援。
預先定義報表
您可以在 Google Ads 使用者介面中建立預先定義報表清單。
以下是基本預先定義報表及其相符的 GAQL 資源名稱清單。
基本預先定義報表 | GAQL 資源名稱 (在 FROM 子句中指定) |
---|---|
帳戶 | 客戶 |
廣告活動、 廣告活動詳細資料 |
廣告活動 |
廣告群組、 廣告群組詳細資料 |
ad_group |
廣告、 最終到達網址 |
ad_group_ad |
搜尋關鍵字 | keyword_view |
搜尋字詞 | search_term_view |
付費和隨機 | paid_organic_search_term_view |
到達網頁 | landing_page_view |
已展開的到達網頁 | expanded_landing_page_view |
如上表所示,您可以使用下列 GAQL 產生帳戶報表:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
常見差異
比較 UI 報表與 API 報表時,最常見的差異之一是 UI 會隱含篩除已移除的實體,API 則否。
如要複製預設的 UI 檢視畫面,您必須新增篩選器 (通常使用 status
欄位來排除已移除的資料列),例如:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"