Google Ads 使用者介面提供報表功能。如要建立報表，請登入 Google Ads 帳戶，按一下左側導覽選單中的「廣告活動」，然後點選「洞察和報表」。如要從頭開始建立報表，請按一下「Report editor」(報表編輯器)。
本指南將 Google Ads 使用者介面中常見的報表概念和命名慣例，對應至可使用 Google Ads 查詢語言 (GAQL) 和 Google Ads API 產生的報表。您也可以按照使用者介面中的提示，建立最符合需求的報表。
工具與資源
如需更多詳細範例，以及將 UI 畫面對應至 API 的自動化輔助功能，請參閱下列資源：
- 查詢錦囊妙計：GAQL 查詢集合，可複製許多常見 Google Ads UI 畫面上的資料。
- Google Ads API Reporting Extension：這項 Chrome 擴充功能可協助您直接在 Google Ads 使用者介面中，找出 API 資源和欄位名稱。
常見 UI 字詞
下表歸納了使用者介面中一些常見的字詞，以及這些字詞對應的 Google Ads 查詢語言 (GAQL)。
| UI | GAQL |
|---|---|
| 欄 | GAQL 查詢 SELECT 子句中的任何資源、區隔欄位或指標。 |
| 日期範圍 | 日期範圍會對應至 WHERE 子句，並依 segments.date 進行篩選。 |
| 篩選器 | WHERE 子句中的一或多個條件。 |
| 區隔欄位 | 在 GAQL 查詢中加入區隔欄位，即可套用區隔。 |
| 分頁 | 分頁會將查詢結果集分成多個頁面。 |
欄
使用者介面中的資料欄等同於在 GAQL 中使用 SELECT 子句，用於資源欄位、區隔欄位或指標。
詳情請參閱「關於統計資料表中的欄」。
日期範圍
Google Ads 使用者介面會顯示帳戶統計資料表，以及控制這些統計資料日期範圍的下拉式選單。
在 GAQL 中，您也可以在 GAQL 查詢的 WHERE 子句中篩選 segments.date，達到相同的控制效果。
篩選器
使用者介面中的篩選器，相當於 GAQL WHERE 子句中的一或多個條件。
詳情請參閱「篩選成效資料的檢視畫面」。
區隔
如要查看更詳細的統計資料，請依區隔劃分資料。舉例來說，假設您想分別查看 Google 搜尋聯播網和 Google 多媒體廣告聯播網的曝光次數，在這種情況下，請依聯播網區隔報表。請參閱「區隔」，瞭解如何在 SELECT 子句中加入區隔欄位。
分頁
使用每個資料表底部的控制項，在使用者介面中瀏覽報表，切換頁面並從定義的一組大小中選取要顯示的結果數量。
如要在擷取報表時逐頁瀏覽結果，請使用 GoogleAdsService.Search，並搭配 next_page_token。如要擷取整個結果集，且不進行任何分頁，請使用 GoogleAdsService.SearchStream。
排序結果
在使用者介面中，選取資料欄即可排序結果。
在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句，排序及限制查詢結果。
下載格式
在使用者介面中，報表可以下載為多種格式，例如 CSV、TSV 或 XML。
API 不會直接將輸出內容格式化為 CSV 等檔案，因此用戶端應用程式必須格式化回應。請參閱廣告活動報表至 CSV 程式碼範例，瞭解如何在用戶端中實作 CSV 格式。
安排報表執行時間並以電子郵件傳送
您可以透過使用者介面排定報表時間及傳送報表電子郵件，但 API 不支援這些功能。
將地圖 UI 檢視畫面對應至 API 資源
以下列出常見的使用者介面檢視畫面，以及對應的 GAQL 資源名稱。
| UI 檢視畫面 | GAQL 資源名稱 (在 FROM 子句中指定) |
|---|---|
| 帳戶 | 顧客 |
| 廣告活動， 廣告活動詳情 |
廣告活動 |
| 廣告群組、 廣告群組詳細資料 |
ad_group |
|
廣告， 最終到達網址 |
ad_group_ad |
| 搜尋關鍵字 | keyword_view |
| 搜尋字詞 | search_term_view |
| 付費和自然 (競爭曝光率範本)* |
paid_organic_search_term_view |
| 到達網頁 | landing_page_view |
| 已展開的到達網頁 | expanded_landing_page_view |
| 內容 > 刊登位置 | managed_placement_view |
| 內容 > 廣告顯示位置 | group_placement_view |
| 內容 > 廣告顯示位置 > 查看詳細資料 | detail_placement_view |
| 「目標對象」>「客層」>「年齡」 | age_range_view |
| 「目標對象」>「客層」>「性別」 | gender_view |
| 位置 | location_view |
| 內容 > 主題 | topic_view |
| 「地點」>「地理位置報表」 | geographic_view |
* 如要產生「付費和自然搜尋」報表，請在客戶層級將 Google Search Console 帳戶連結至 Google Ads 帳戶。
以上表為例，您可以使用下列 GAQL 查詢，在過去 7 天內產生匯總帳戶報表 (如要依天細分指標，請新增 segments.dateSELECT 子句)：
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 欄位新增篩選器，排除已移除的資料列 (或明確納入 ENABLED 和 PAUSED 實體)。例如：
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'