條件指標

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

如需擷取任何條件專屬資料，Google Ads API 用戶端必須指定對應的 ad_group_criterion 或 campaign_criterion 欄位。每個檢視畫面都會連結至符合其指定層級的條件資源 (例如 keyword_view 連結至 ad_group_criterion，location_view 連結至 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 的參考頁面中找到其資源。

對應至使用者介面

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

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

• 廣告活動 > 目標對象、關鍵字和內容 > 搜尋關鍵字：傳回與 keyword_view 相同的資料。
• 廣告活動 > 目標對象、關鍵字和內容 > 目標對象 >客層：傳回與 age_range_view 和 gender_view 相同的資料。
• 廣告活動 > 地區：傳回與 location_view 相同的資料。