API与Analytics界面指标数值不一致问题求助

我用以下PHP代码通过GA4 API获取指定目录下页面的独立访客数和页面浏览量：

$response = $client->runReport([
    'property' => 'properties/XXXXXXXXXXXX',
    'pageSize' => '20000',
    'dateRanges' => [
        new DateRange([
            'start_date' => '2023-08-13',
            'end_date' => '2023-08-13',
        ]),
    ],
    'dimensions' => [new Dimension(
        [
            'name' => 'pagePath',
        ]
    ),
    ],
    'dimensionFilter' => new FilterExpression([
      'filter' => new Filter([
        'field_name' => 'pagePath',
        'string_filter' => new Filter\StringFilter([
          'match_type' => Filter\StringFilter\MatchType::BEGINS_WITH,
          'value' => '/url-here/',
         ])
      ])
    ]),
    'metrics' => [
    new Metric(
        [
            'name' => 'activeUsers'
        ]
    ),
    new Metric(
        [
            'name' => 'screenPageViews'
        ]
    )
    ]
]);

查询2023-08-13的数据时，API返回109个activeUsers、233次screenPageViews，但GA4界面中同一天同筛选条件下，独立访客数为222，页面浏览量为640，数值相差一倍以上。已确认筛选的URL完全一致，请问可能的原因是什么？

可能的原因分析 #

1. 指标定义不匹配 #

• API调用的activeUsers统计的是当日至少发起一次会话的用户，而GA4界面显示的“独立访客数”大概率对应users指标——该指标会合并指定日期范围内跨会话的同一用户，统计逻辑和activeUsers完全不同。
• API用的screenPageViews仅针对移动端屏幕类的浏览行为计数，而GA4界面的“页面浏览量”可能是pageViews（网页端页面浏览）与screenPageViews的总和，或者你在界面中直接选择了pageViews指标，和API的指标定义存在差异。

2. 隐性筛选条件差异 #

• GA4界面可能默认启用了额外过滤规则，比如排除内部流量、排除爬虫机器人，但你的API请求中没有添加对应过滤逻辑。可以检查界面的「过滤器」面板，把这些规则同步到API的dimensionFilter或metricFilter中。
• 路径匹配细节：API使用BEGINS_WITH匹配路径，若界面中用的是「包含」规则，或者存在路径大小写、末尾斜杠的差异（比如/url-here和/url-here/），也会导致数据范围不同。

3. 数据采样与延迟 #

• GA4界面和API的数据刷新周期可能不同，界面可能已经完成全量数据处理，而API返回的是未完全计算的临时数据。
• 当数据量较大时，API会自动启用数据采样，而GA4界面在数据量未达阈值时会返回全量数据。可以查看API响应中的samplingMetadata字段，确认是否存在采样情况。

4. 媒体资源或数据范围错误 #

• 确认API请求中的properties/XXXXXXXXXXXX和GA4界面打开的是同一个媒体资源，避免因选错属性导致数据来源不一致。

5. 跨设备用户合并逻辑差异 #

• GA4界面默认可能开启了跨设备用户合并（比如通过用户ID或Google信号），而API请求若未指定对应的用户标识逻辑，统计的是基于设备的用户数，和界面的跨设备合并用户数会产生明显差异。

内容的提问来源于stack exchange，提问作者AdrianRO