條件指標

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

如果需要擷取任何特定條件資料,Google Ads API 用戶端必須指定對應的 ad_group_criterioncampaign_criterion 欄位。這可讓 Google Ads API 客戶在同一個要求中,向 GoogleAdsService.SearchStream 方法要求 ad_group_criterioncampaign_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參考資料頁面中找到相關資源。