Google Ads UI 中的報表

本指南將 Google Ads UI 報表的概念和命名規則，對應至您可使用 Google Ads 查詢語言 (GAQL) 和 Google Ads API 產生的報表。

常見的 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"