使用者介面中的報表

本指南將 Google Ads 使用者介面中的報表概念和命名慣例，對應到您可透過 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 子句中加入片段欄位，請參閱區隔。

分頁

在 UI 中瀏覽報表時，您可以使用各資料表底部的控制項來切換頁面，並從一組定義的大小中選取要顯示的結果數量。

使用 GoogleAdsService.Search 至 next_page_token 擷取報表時，可使用分頁檢視結果。如要在沒有分頁的情況下擷取整個結果集，請使用 GoogleAdsService.SearchStream。

訂單結果

在 UI 中，您可以選取資料欄，將結果排序。

在 GAQL 中，您可以使用 ORDER BY 子句和 LIMIT 子句排序查詢結果。

下載格式

在使用者介面中，報表可以下載多種格式，如 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"