條件指標

在 Google Ads API 中，每份條件報表都以獨立資源表示。 除非另有必要，否則 *_view 資源只會包含 resource_name 欄位。

如果需要擷取任何特定條件資料，Google Ads API 用戶端必須指定對應的 ad_group_criterion 或 campaign_criterion 欄位。這樣一來，Google Ads API 用戶端就能在對 GoogleAdsService.SearchStream 方法發出的同一項要求中，要求 ad_group_criterion 或 campaign_criterion 欄位和 *_view 資源。

查詢要求範例

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

如要擷取特定條件類型的成效資料 (指標)，請在 FROM 子句中指定對應的檢視畫面資源。舉例來說，在 FROM 子句中使用 keyword_view，並在 SELECT 子句中使用一些 metrics 欄位，即可擷取關鍵字指標。

您可以從條件檢視畫面中，選取父項資源的欄位，一路向上選取至 customer。舉例來說，選取 FROM keyword_view 時，您可以從下列所有資源要求欄位：

• ad_group_criterion
• ad_group
• campaign
• customer

如要瞭解特定資源可透過這種方式要求哪些資源，請查看該資源參考頁面的「Attribute Resources」(屬性資源) 列。舉例來說，如要瞭解 keyword_view 的資源，請參閱參考資料頁面。

對應至 UI

每份條件報表都對應 Google Ads 使用者介面中的特定檢視畫面。對應這些項目有助於您比對 API 資料與介面顯示的內容。如需更完整的對應清單，請參閱「使用者介面中的報表」。

以下列舉一些常見的條件式報表，以及這些報表在使用者介面中的位置：

• 廣告活動 > 目標對象、關鍵字和內容 > 搜尋關鍵字：傳回與 keyword_view 相等的資料。
• 廣告活動 > 目標對象、關鍵字和內容 > 目標對象 > 人口統計資料： 傳回的資料等同於 age_range_view 和 gender_view。
• 廣告活動 > 地點：傳回的資料等同於 location_view。