本指南将介绍有关使用 Google Analytics Data API 生成的报告中所显示数据的重要信息。用户经常会遇到 API（尤其是 runReport 方法）返回的数据与 Google Analytics 界面中显示的数据不一致的情况。
抽样和汇总
Google Analytics Data API runReport 方法可以返回抽样数据，尤其是在处理大型数据集或复杂查询时。虽然 Google Analytics 界面也会应用抽样，但具体阈值和算法可能有所不同，从而导致报告的值略有差异。
如需了解报告的结果是否基于部分可用数据，请检查 ResponseMetaData 对象的 samplingMetadatas 字段。如果报告结果是抽样数据，此字段会说明相应报告中使用的事件百分比。
Google Analytics Data API 的某些报告方法允许您指定所需的抽样级别。您可以使用 properties.reportTasks.create 方法的 samplingLevel 字段来控制报告的抽样级别。
借助此功能，Google Analytics 360 版媒体资源可以访问更高的抽样上限，即 10 亿个事件。此外，还可以将抽样限制设置为 UNSAMPLED，以便针对大量活动使用非抽样结果。
如需了解详情，请参阅数据抽样简介。
唯一身份计数近似值
Google Analytics Data API 使用 HyperLogLog++ (HLL++) 算法来估算“活跃用户数”和“会话数”等指标的唯一身份用户数。API 和 Google Analytics 界面中都使用这种方法来提高性能并高效管理大型数据集，这意味着结果是近似值，而不是确切的计数。
如需了解更多背景信息，请参阅以下资源：Google Analytics 中的唯一计数近似值和用户数方面的差异。
最低数据量
Google Analytics 可能会对报告应用数据阈值，以防止根据受众特征、兴趣或数据中存在的其他信号识别出具体用户。
如果报告行包含的用户数量较少，该行可能会从结果中排除。如果报告包含高基数维度或自定义维度，则这种情况更为常见。
如需了解相应报告是否受阈值限制，请检查 ResponseMetaData 对象的 subjectToThresholding 字段。
如需了解详情，请参阅最低数据量。
(other) 行
如果某个维度的基数较高，Google Analytics 可能会将不太常见的值归入标记为 (other) 的行中。如果报告中包含每天具有 500 个以上唯一值的维度，则这种情况更为常见。
将过滤条件与 Data API 搭配使用时，请注意过滤条件不会检查 (other) 行的内容，而是在数据汇总和 (other) 行生成后应用。
如需了解报告是否包含汇总到 (other) 行中的数据，请检查 ResponseMetaData 对象的 dataLossFromOtherRow 字段。
如需了解详情，请参阅 Google Analytics 中的“（其他）”行。
在报告中使用的 ID
报告中使用的 ID 决定了如何在报告中去除重复用户。不同的身份设置（例如“混合”或“基于设备”）可能会导致同一日期范围内的用户数量不同。
Google Analytics 界面和 Data API 都使用您媒体资源的同一在报告中使用的 ID 设置。如果更改此设置，界面和 API 中的报告都会受到影响。如果在界面中生成报告与通过 API 获取报告数据之间更改了相应设置，则对于同一日期范围，这两个报告中的用户数量可能会有所不同。
查询具体程度
为尽可能减少差异，请确保 API 请求中的以下参数与 Google Analytics 界面报告中的设置完全一致：
- 日期范围：验证开始日期和结束日期是否相同。
- 维度和指标：确保 API 请求中的维度和指标与 Google Analytics 界面报告中的维度和指标相同。
- 过滤条件：确保 API 请求中应用的任何维度或指标过滤条件与界面中使用的过滤条件一致。
向报告中添加维度可能会导致计算中使用的事件数减少。报告中仅包含包含所请求维度数据的事件。因此，向查询中添加维度可能会改变报告中指标的汇总值。
数据新鲜度
Google Analytics 需要时间来处理和汇总事件数据。如果数据检索之间存在时间延迟，那么在处理最新数据时，您可能会发现报告之间存在细微差异。例如，如果您在界面中查看某个报告，然后在几分钟后通过 API 查询同一报告，由于系统会持续处理和汇总数据，因此数据可能会发生变化。
如需了解详情，请参阅数据新鲜度。
非抽样数据替代方案
如果您的使用情形需要完整的未抽样事件级数据，请考虑使用以下替代方案：
BigQuery Export：Google Analytics 的 BigQuery Export
是推荐用于对原始事件数据进行高级分析的方法。
Analytics 360：拥有 Analytics 360 许可的媒体资源具有更高的抽样上限，并且可以使用更详细的报告功能。