本指南針對 Google Ads 使用者介面中的報表，列出概念和命名慣例 對於可以使用 Google Ads 查詢語言 (GAQL) 產生的報表 Google Ads API
常見 UI 詞彙
下表摘要列出使用者介面中的一些常見詞彙及其 對應至 Google Ads 查詢語言 (GAQL)。
| UI | GAQL |
|---|---|
| 欄 | GAQL 查詢 SELECT 子句中的任何資源、區隔欄位或指標。 |
| 日期範圍 | 日期範圍對應到 WHERE
子句篩選 segments.date。 |
| 篩選器 | WHERE 子句中的一或多個條件。 |
| 區隔欄位 | 加入區隔欄位以套用區隔 在 GAQL 查詢中放置。 |
| 分頁 | Paging 會打破一組結果 即可將查詢內容彙整為多個網頁 |
欄
UI 中的資料欄等同於 Resource 欄位、區隔 欄位，以及 GAQL 中的指標。
篩選
日期範圍
Google Ads 使用者介面上有顯示帳戶統計資料的表格，以及 控制這些統計資料的日期範圍
只要開啟篩選功能，您就可以在 GAQL 中使用相同的控制項
GAQL 的 WHERE 子句中的 segments.date
。
篩選器
UI 中的篩選器等同於 WHERE 中的一或多個條件 GAQL 子句。
區隔
查看精細的統計資料時，您可以按區隔來切割資料。例如： 您可能想瞭解 Google 搜尋聯播網和 Google 多媒體廣告聯播網分開運作。在本例中 可以按聯播網區隔報表詳情請見 如何加入區隔欄位的區隔 在 SELECT 子句中。
分頁
在使用者介面上瀏覽報表時，您可以使用 底部，方便您切換頁面及選取 以便從一組定義的大小顯示結果
使用含有
GoogleAdsService.Search 到
next_page_token。擷取整個結果集
無需分頁，請使用
GoogleAdsService.SearchStream。
訂單結果
在 UI 中，您可以選取資料欄，將結果排序。
在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句 排序查詢結果。
下載格式
在使用者介面中，報表可以下載為各種格式，如 CSV、TSV 或 XML
API 無法在輸出中直接支援不同格式，因此 後續處理作業查看 這個程式碼範例顯示如何在 用戶端。
安排報表執行時間並以電子郵件傳送
使用者介面提供報表執行時間安排和電子郵件傳送功能，但不支援 並嚴謹測試及提升 API 的公平性後 我們才能放心地推出 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 報表時，最常見的差異在於 使用者介面會以隱含方式篩除已移除的實體，API 則不會。
為複製預設的 UI 檢視畫面，您必須新增篩選器 (通常是
使用 status 欄位排除已移除的資料列，例如：
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"