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 資源
以下列出常見的使用者介面檢視畫面，以及對應的 Google Ads 查詢語言資源名稱。
| UI 檢視畫面 | GAQL 資源名稱 (在 FROM 子句中指定) |
|---|---|
| 帳戶 | 客戶 |
| 廣告活動， 廣告活動詳細資料 |
campaign |
| 廣告群組、 廣告群組詳細資料 |
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 天的匯總帳戶報表 (如要依日期細分指標，請在 SELECT 子句中加入 segments.date)：
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'