零指標

本指南說明 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 個月前的精細資料，也不會傳回資料列。如果要求取得 37 個月前的精細日期區隔 (segments.date、segments.week 和 segments.hour)，系統會在第 24 版和後續版本中傳回 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED (或在第 23 版中傳回 DateRangeError.UNKNOWN)。高層級匯總資料 (segments.month、segments.quarter 和 segments.year) 會保留 11 年，保留期限從下一個完整日曆週期的開始算起。舉例來說，如果 11 年回溯期截止日為 2015-03-22 (或 2015-03-01)，則可從截止日後的第一個完整曆月 (2015-04-01) 開始查看每月資料。詳情請參閱「日期範圍」。

上一頁
區隔
下一頁
標籤