Google Ads UI 中的報表

Google Ads 使用者介面提供報表功能。如要建立報表，請登入 Google Ads 帳戶。按一下左側的「廣告活動」，然後點選「洞察與報表」。如要從頭開始建立報表，請按一下「報表編輯器」。

本指南會將 Google Ads 使用者介面中的常見報表概念和命名慣例，對應至您可使用 Google Ads 查詢語言 (GAQL) 和 Google Ads API 產生的報表。您也可以按照 UI 中的提示建立最符合需求的報表。

工具與資源

如需更多詳細範例和自動化輔助，將 UI 畫面對應至 API，請參閱下列資源：

• 查詢食譜：一系列 GAQL 查詢，可複製許多常見 Google Ads 使用者介面畫面上的資料。
• Google Ads API 報表擴充功能： 這項 Chrome 擴充功能可協助您直接在 Google Ads 使用者介面中，找出 API 資源和欄位名稱。

常見 UI 詞彙

下表摘要列出使用者介面中使用的常見字詞，以及這些字詞對應的 Google Ads 查詢語言 (GAQL)。

UI	GAQL
欄	GAQL 查詢SELECT 子句中的任何資源、區隔欄位或指標。
日期範圍	日期範圍會對應至 WHERE 子句，並依 segments.date 進行篩選。
篩選器	WHERE 子句中的一或多個條件。
區隔欄位	在 GAQL 查詢中加入區隔欄位，即可套用區隔。
分頁	分頁會將查詢結果集分成多個頁面。

欄

使用者介面中的資料欄，相當於在 GAQL 中使用 SELECT 子句選取資源欄位、區隔欄位或指標。

請參閱「關於統計資料表中的欄」一文

日期範圍

Google Ads 使用者介面會顯示帳戶統計資料表，以及控制這些統計資料日期範圍的下拉式選單。

您可以在 GAQL 查詢的 WHERE 子句中，依 segments.date 進行篩選，在 GAQL 中取得相同的控制權。

篩選器

使用者介面中的篩選器等同於 GAQL WHERE 子句中的一或多個條件。

請參閱「篩選成效資料檢視」。

區隔

如要查看更詳細的統計資料，請依區隔分割資料。舉例來說，假設您想分別查看 Google 搜尋聯播網和 Google 多媒體廣告聯播網的曝光次數，請依聯播網區隔報表。如要瞭解如何在 SELECT 子句中加入區隔欄位，請參閱「區隔」。

分頁

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

使用 GoogleAdsService.Search 擷取報表時，可以逐頁瀏覽結果。next_page_token如要擷取整個結果集，且不使用任何分頁，請使用 GoogleAdsService.SearchStream。

排序結果

在使用者介面中，選取資料欄即可排序結果。

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

下載格式

在使用者介面中，報表可以下載為多種格式，例如 CSV、TSV 或 XML。

API 不直接支援輸出不同格式，因此您必須執行一些後續處理作業。請參閱這個程式碼範例，瞭解如何在用戶端實作 CSV 格式。

安排報表執行時間並以電子郵件傳送

您可以在使用者介面中排定報表傳送時間並透過電子郵件傳送，但 API 不支援這些功能。

地圖 UI 檢視畫面到 API 資源

以下列出常見的 UI 檢視畫面，以及相應的 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 產生帳戶報表：

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'