报告数据预期

本指南介绍了有关使用 Google Analytics Data API 生成的报告中所显示数据的重要信息。用户经常会发现，API（特别是 runReport 方法）返回的数据与 Google Analytics 界面中显示的数据之间存在差异。

抽样和汇总

Google Analytics Data API runReport 方法可能会返回抽样数据，尤其是对于大型数据集或复杂查询。虽然 Google Analytics 界面也会应用抽样，但具体阈值和算法可能会有所不同，从而导致报告的值存在细微差异。

如需了解报告结果是否基于可用数据的子集，请检查 samplingMetadatas 字段的 ResponseMetaData 对象。如果报告结果是抽样数据，此字段会说明此报告中使用的事件百分比。

Google Analytics Data API 的某些报告方法允许您指定所需的抽样级别。您可以使用 samplingLevel properties.reportTasks.create 方法的字段来控制报告的抽样级别。

借助此功能，Google Analytics 360 媒体资源可以获得更高的抽样上限，即 10 亿个事件。此外，抽样上限可以设置为 UNSAMPLED，以便在事件数量较多时使用非抽样结果。

如需了解详情，请参阅数据抽样简介。

Google Analytics Data API 使用 HyperLogLog++ (HLL++) 算法来估算“活跃用户数”和“会话数”等指标的唯一计数。API 和 Google Analytics 界面都使用这种方法来提高性能并高效管理大型数据集，这意味着结果是近似值，而不是确切的计数。

如需了解更多背景信息，请参阅以下资源： Google Analytics 中的唯一计数近似值和用户数差异。

Google Analytics 可能会对报告应用数据阈值，以防止根据数据中呈现的受众特征、兴趣或其他信号识别出具体用户。

如果报告行包含的用户数量较少，则该行可能会从结果中排除。在包含高基数维度或自定义维度的报告中，这种情况更为常见。

如需了解此报告是否受阈值限制，请检查 subjectToThresholding 字段的 ResponseMetaData 对象。

如需了解详情，请参阅数据阈值。

如果维度的基数较高，Google Analytics 可能会将不太常见的值分组到标记为 (other) 的行中。在包含每天具有 500 个以上唯一值的维度的报告中，这种情况更为常见。

使用 Data API 过滤条件时，请注意，过滤条件不会查看 (other) 行内的内容，并且是在数据汇总和生成 (other) 行之后应用的。

如需了解报告是否包含汇总到 (other) 行中的数据，请检查 dataLossFromOtherRow 字段的 ResponseMetaData 对象。

如需了解详情，请参阅 Google Analytics 4 中的 “（其他）”行。

在报告中使用的 ID 决定了如何在报告中对用户进行去重。不同的 ID 设置（例如“混合”或“基于设备”）可能会导致同一日期范围内的用户数不同。

Google Analytics 界面和 Data API 都为您的媒体资源使用相同的在报告中使用的 ID 设置。如果此设置发生更改，则会影响界面和 API 中的报告。如果在界面中运行报告和通过 API 获取报告数据之间更改了设置，则同一日期范围内的两个报告的用户数可能会有所不同。

为尽量减少差异，请确保 API 请求中的以下参数与 Google Analytics 界面报告中的设置完全一致：

向报告添加维度可能会导致计算中使用的事件数量减少。报告中仅包含包含所请求维度数据的事件。因此，向查询添加维度可能会更改报告中指标的汇总值。

Google Analytics 需要一定的时间来处理和汇总事件数据。处理非常新的数据时，如果数据检索之间存在时间延迟，您可能会发现报告之间存在细微差异。例如，如果您在界面中查看报告，然后在几分钟后通过 API 查询同一报告，则由于系统会持续处理和汇总数据，数据可能会发生变化。

如需了解详情，请参阅数据新鲜度。

如果您的用例需要完整的非抽样事件级数据，请考虑使用以下替代方案：

BigQuery Export：适用于 Google Analytics 的 BigQuery Export

是用于对原始事件数据进行高级分析的推荐方法。
Analytics 360：拥有 Analytics 360 许可的媒体资源具有更高的抽样上限，并且可以使用更详细的报告功能。