后端发送的Google Analytics(GA)事件返回200但无法在后台显示

核心问题判定 #

前端事件上报正常说明媒体资源、视图配置无异常，问题均出在服务端上报的请求参数不符合UA的校验规则，即使接口返回200也会被GA后端静默丢弃。 #

排查&解决步骤 #

• 客户端ID（cid）校验
  UA要求所有上报请求必须携带合法的cid（32位随机字符串），前端上报时会自动生成并存储在_ga cookie中。如果服务端初始化GA客户端、构造事件时未传入对应用户的cid，GA会直接丢弃事件。
  解决方法：从前端请求的_ga cookie中解析cid（_ga格式为GA1.2.{cid第一部分}.{cid第二部分}，取.分割后的后两段拼接即可），上报事件时传入该cid。
• 用户标识参数校验
  缺少用户代理、真实IP的请求会被GA判定为机器人流量过滤。服务端上报时需要携带当前访问用户的User-Agent请求头，可选传入用户真实IP避免被误过滤。
• 事件参数合法性校验
  以下参数不符合要求时事件会被丢弃：
  • eventCategory、eventAction为必填项，不可为空
  • eventValue必须为非负整数，不可传入字符串、浮点数
  • 所有事件字符串参数长度不可超过150字节
• 媒体资源配置校验
  确认服务端GA客户端初始化时填写的跟踪ID（UA-XXXX-Y）和前端完全一致，未误填为GA4资源的测量ID。
• 视图过滤规则校验
  若实时板块能看到后端上报事件、但行为板块无数据，检查GA视图是否配置了IP过滤、参数过滤规则，误将服务端上报的流量过滤。非实时数据最多延迟48小时入库，可等待24小时后再查看。

修正后代码示例 #

private void sendEventMetrics(EventHit eventHit, GoogleAnalytics metricTracker, HttpServletRequest request) {
    if (metricTracker == null) {
        return;
    }
    // 解析用户cid
    String cid = null;
    Cookie[] cookies = request.getCookies();
    if (cookies != null) {
        for (Cookie cookie : cookies) {
            if ("_ga".equals(cookie.getName())) {
                String[] gaParts = cookie.getValue().split("\\.", 3);
                if (gaParts.length >= 3) {
                    cid = gaParts[2];
                }
                break;
            }
        }
    }
    if (cid == null) {
        return;
    }
    // 填充必要参数
    metricTracker.withClientId(cid);
    metricTracker.withUserAgent(request.getHeader("User-Agent"));
    // 保证事件参数合法
    Integer eventValue = eventHit.eventValue() == null ? 0 : eventHit.eventValue();
    String eventLabel = eventHit.eventLabel() == null ? "" : eventHit.eventLabel();
    
    GoogleAnalyticsResponse response = metricTracker.event()
            .eventCategory(eventHit.eventCategory())
            .eventAction(eventHit.eventAction())
            .eventLabel(eventLabel)
            .eventValue(eventValue)
            .send();
}

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