報表資料預期

本指南說明使用 Google Analytics Data API 產生的報表資料相關重要資訊。使用者經常發現，API 傳回的資料 (尤其是 runReport 方法) 與 Google Analytics UI 顯示的資料不一致。

取樣和匯總

Google Analytics Data API runReport 方法可傳回樣本資料，特別是大型資料集或複雜查詢。雖然 Google Analytics UI 也會套用取樣，但具體門檻和演算法可能不同，導致報表值略有差異。

如要瞭解報表結果是否根據可用資料的子集產生，請檢查 ResponseMetaData 物件的 samplingMetadatas 欄位。如果報表結果經過取樣，這個欄位會說明報表使用的事件百分比。

Google Analytics Data API 的某些報表方法可讓您指定所需的取樣層級。您可以使用 properties.reportTasks.create 方法的 samplingLevel 欄位，控管報表的取樣層級。

這項功能可讓 Google Analytics 360 資源享有更高的取樣上限 (10 億筆事件)。此外，您也可以將取樣限制設為 UNSAMPLED，針對大量事件使用未取樣的結果。

詳情請參閱「關於資料取樣」一文。

Google Analytics Data API 使用 HyperLogLog++ (HLL++) 演算法，估算「活躍使用者」和「工作階段」等指標的不重複計數。API 和 Google Analytics UI 採用這種方法，是為了提升效能並有效管理大型資料集，因此結果是近似值，而非精確計數。

Google Analytics 可能會對報表套用資料閾值，避免根據資料中呈現的客層、興趣或其他信號，推斷個別使用者的身分。

如果報表資料列包含的使用者人數過少，該資料列可能會從結果中排除。如果報表包含高基數維度或自訂維度，就更常發生這種情況。

如要瞭解這份報表是否受限於門檻，請檢查 ResponseMetaData 物件的 subjectToThresholding 欄位。

詳情請參閱「資料門檻」。

如果維度基數偏高，Google Analytics 可能會將較不常見的值歸類到標示為「(other)」的資料列。如果報表包含每天有超過 500 個不重複值的維度，就比較容易發生這種情況。

使用 Data API 篩選器時，請注意篩選器不會查看 (other) 列，而是在資料匯總且 (other) 列產生「之後」套用。

如要瞭解報表是否包含匯入 (other) 列的資料，請檢查 ResponseMetaData 物件的 dataLossFromOtherRow 欄位。

報表識別資訊決定報表如何刪除重複的使用者。不同的身分設定 (例如「混合」或「依據裝置」) 可能會導致相同日期範圍內的使用者人數不同。

Google Analytics UI 和 Data API 都會使用相同的資源報表識別資訊設定。如果變更這項設定，使用者介面和 API 中的報表都會受到影響。如果在使用者介面中執行報表和透過 API 取得報表資料之間變更了設定，則相同日期範圍內兩份報表的使用者人數可能會有所不同。

為盡量減少差異，請確保 API 要求中的下列參數與 Google Analytics UI 報表中的設定完全一致：

在報表中加入維度，可能會導致計算時使用的事件減少。報表只會納入包含所要求維度資料的事件。因此，在查詢中新增維度可能會改變報表中指標的匯總值。

Google Analytics 需要時間處理及匯總事件資料。處理近期資料時，如果資料擷取時間有延遲，報表之間可能會有些微差異。舉例來說，如果您在使用者介面中查看報表，然後在幾分鐘後查詢 API 取得同一份報表，資料可能會因持續處理和匯總而有所變更。

詳情請參閱「資料更新間隔」。

如果您的用途需要完整、未取樣的事件層級資料，請考慮使用下列替代方案：