零指標

本指南說明 Google Ads API 報表為何會顯示指標為零的資料列，以及如何在查詢中排除或處理這些資料列。

搜尋結果中的零指標

執行查詢時，您可能會遇到實體的指標為零。 可能的原因如下：

  • 實體不符合顯示資格。
  • 在報表的日期範圍內暫停。

您通常會想透過查詢結果，取得廣告活動成效的相關資訊。在這種情況下，零指標可能不符合需求。如要製作更有用的報表，可以明確排除零指標。

使用述詞排除零指標

述詞是評估為 TRUE、FALSE 或 UNKNOWN 的運算式。述詞用於 Google Ads 查詢語言中 WHERE 子句的搜尋條件。

下列查詢示範如何使用述詞明確移除零指標：

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

透過區隔排除零指標

區隔報表時，系統一律會排除零指標，前提是所有選取的指標都是零 (請參閱「傳回指標為零的資料列」)。

如要區隔報表，請在搜尋查詢的 SELECT 子句中加入任何 segments 欄位 (在 WHERE 中篩選核心日期區隔，但未在 SELECT 中選取，則不會區隔報表)。舉例來說，如果按 segments.date 區隔報表，指標會細分為每個日期一列。這類報表不會傳回沒有指標的日期。

下列查詢的報表不會包含指標為零的資料列：

SELECT
  campaign.name,
  metrics.impressions,
  segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

傳回指標為零的資料列

如果資料列的所選指標全為零，就不會在區隔時傳回。舉例來說，請參考下列查詢，選取 metrics.impressions、metrics.clicks 和 metrics.conversions：

SELECT
  ad_group_criterion.criterion_id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'

產生的報表不會包含所有選取指標皆為零的資料列，但會傳回至少一個選取指標大於零的資料列。

查詢超過資料保留期限的歷來資料時，系統不會提供 37 個月前的精細資料，也不會傳回資料列。如果要求精細日期區隔 (segments.date、segments.week 和 segments.hour)，且涵蓋範圍超過 37 個月，則在 v24 以上版本會傳回 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (在 v23 則傳回 DateRangeError.UNKNOWN)。高層級匯總資料 (segments.month、segments.quarter 和 segments.year) 會保留 11 年，從下一個完整日曆週期開始計算。舉例來說，如果 11 年回溯截止日期是 2015-03-22 (或 2015-03-01)，則可從截止日期後的第一個完整日曆月 (2015-04-01) 開始查看每月資料。詳情請參閱「日期範圍」。

上一頁
區隔
下一頁
標籤