本指南會將 Google Ads UI 報表的概念和命名規則對應至您可使用 Google Ads 查詢語言 (GAQL) 和 Google Ads API 產生的報表。
常見的 UI 用語
下表列出 UI 中使用的部分常用字詞，以及這些字詞對應的 Google Ads 查詢語言 (GAQL)。
| UI | GAQL |
|---|---|
| 欄 | GAQL 查詢的 SELECT 子句中任何資源、區隔欄位或指標。 |
| 日期範圍 | 日期範圍會對應至 segments.date 上的 WHERE 子句篩選條件。 |
| 篩選器 | WHERE 子句中一或多個條件。 |
| 區隔欄位 | 在 GAQL 查詢中加入區隔欄位，套用區隔。 |
| 分頁 | 分頁會將查詢的結果集分割成多個頁面。 |
欄
使用者介面中的欄等同於 GAQL 中的資源欄位、區隔欄位和指標。
篩選
日期範圍
Google Ads UI 會顯示帳戶統計資料的表格，以及用來控制這些統計資料日期範圍的下拉式選單。
您可以在 GAQL 中篩選 GAQL 查詢的 WHERE 子句中的 segments.date，以便進行相同的控管。
篩選器
使用者介面中的篩選器，相當於 GAQL WHERE 子句中的一或多個條件。
區隔
查看精細的統計資料時，您可以按區隔來切割資料。舉例來說，您可能想查看 Google 搜尋聯播網和 Google 多媒體廣告聯播網的曝光次數。在這種情況下，您可以按聯播網區隔報表。如要瞭解如何在 SELECT 子句中加入區隔欄位，請參閱「區隔」一文。
分頁
您可以使用每個資料表底部的控制項，在 UI 中瀏覽報表，藉此切換頁面，並從定義的大小集合中選取要顯示的結果數量。
透過 next_page_token 使用 GoogleAdsService.Search 擷取報表時，即可逐頁瀏覽結果。如要擷取整個結果集，且不分頁，請使用 GoogleAdsService.SearchStream。
排序結果
在使用者介面中，您可以選取資料欄來排序結果。
在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句來排序查詢結果。
下載格式
在使用者介面中，您可以下載各種格式的報表，例如 CSV、TSV 或 XML。
API 不直接支援輸出內容中的不同格式，因此您需要執行一些後續處理作業。請參閱程式碼範例，瞭解如何在用戶端中實作 CSV 格式。
安排報表執行時間並以電子郵件傳送
您可以在使用者介面中安排報表傳送時間，並將報表傳送至電子郵件，但 API 不支援這項功能。
預先定義報表
您可以在 Google Ads 使用者介面中建立預先定義報表清單。
以下列出基本預先定義報表及其對應的 GAQL 資源名稱。
| 基本預先定義報表 | GAQL 資源名稱 (請在 FROM 子句中指定) |
|---|---|
| 帳戶 | customer |
| 廣告活動 廣告活動詳細資料 |
campaign |
| 廣告群組、 廣告群組詳細資料 |
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"