條件指標

在 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

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

對應至 UI

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

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

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