使用GA4 Measurement Protocol无法在实时报告中统计用户数

我正在使用GA4的Measurement Protocol，按照官方文档要求在事件中添加了session_id和engagement_time_msec参数，期望能在实时报告中看到用户数。我的请求JSON体如下：

{
  "user_id":"User_7xwfms",
  "app_instance_id":"a5e31b44a75401e428147618971da59d74d46265",
  "events":[
    {
      "name":"session_started",
      "params":{
        "session_id":"638295158991729126_7xwfms",
        "engagement_time_msec":1,
        "time_passed":1.007073742650463,
        "level":4,
        "target":7570164
      }
    }
  ]
}

事件已成功出现在GA4实时报告中，但“过去30分钟用户数”卡片的数值始终为0，请问哪里操作有误？

可能的原因及修复方案： #

• 事件名称不满足会话计数规则：GA4默认仅将session_start（注意不是你用的session_started）这类官方自动事件，或后台标记为“会话起始”的自定义事件，纳入用户会话计数逻辑。你自定义的session_started事件不会触发GA4的用户数统计，即便传了会话相关参数也无效。
  修复：要么把事件名称改为session_start；要么在GA4后台的事件设置里，将session_started标记为会话起始事件。

• 用户标识参数存在问题：虽然你传了user_id和app_instance_id，但GA4需要确保这些标识能唯一识别用户。如果是App端，要确认app_instance_id是每个设备唯一的；如果是Web场景，还需要补充client_id参数到请求根节点。

• engagement_time_msec数值不符合阈值：官方文档说传1即可，但实际GA4对有效参与的判定可能有隐性阈值，过小的数值可能不被识别为有效用户行为，进而不计入用户数。
  修复：尝试将engagement_time_msec调整为100或更大的整数后再测试。

• session_id格式或关联异常：session_id需要保证在用户会话周期内唯一，且和用户标识正确绑定。如果格式过长、包含特殊字符，可能导致GA4无法正确识别会话，进而不统计用户数。
  修复：简化session_id格式，比如使用纯数字或短字符串，确保同一用户的会话ID唯一。

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