如何通过GA4测量协议发送会话起止时间以统计互动指标

我正在开发Chrome扩展，想通过GA4（Google Analytics 4）的测量协议传递数据。请问如何通过该协议向GA4发送会话开始和结束时间，从而在「互动>概览」板块展示平均互动时长、每位用户的互动会话数、每次会话平均互动时长这些指标？

我已尝试的两种方式 #

1. 在事件参数中传递session_start:"1"参数，代码如下：

{
  "client_id": "x",
  "events": [{
    "name": "offline_purchase",
    "params": {
      "engagement_time_msec": "100",
      "session_id": "123",
      "session_start": "1"
    }
  }]
}

2. 通过URL传递session_start参数，代码如下：

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?
measurement_id=${measurement_id}&
api_secret=${api_secret}&session_start=${1}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

要让GA4正确计算互动类指标，需遵循测量协议的会话管理规则，核心是正确传递会话标识、会话开始标记和互动时长参数，具体步骤如下：

1. 正确标记会话开始 #

• 不要在URL参数或普通事件的params里传字符串类型的session_start，正确做法是发送名为session_start的独立事件，或在会话首次事件的params中加入布尔值session_start: true。
• 示例代码：

{
  "client_id": "你的客户端ID",
  "events": [{
    "name": "session_start",
    "params": {
      "session_id": "唯一会话ID", // 自定义标识，同一会话内所有事件需使用相同值
      "engagement_time_msec": "0" // 会话开始时互动时长初始为0
    }
  }]
}

2. 记录会话内的互动时长 #

• 会话进行中，每次用户产生有效互动（如点击、页面停留）时，发送带有engagement_time_msec参数的事件，参数值为本次互动新增的毫秒数（累计值也可，推荐用增量）。
• 示例：用户在会话中停留5000毫秒，发送事件时传递：

{
  "client_id": "你的客户端ID",
  "events": [{
    "name": "offline_purchase",
    "params": {
      "session_id": "同一会话ID",
      "engagement_time_msec": "5000"
    }
  }]
}

3. 会话结束的处理（可选但推荐） #

GA4默认会在30分钟无互动时自动结束会话，若需主动标记，可发送携带session_engaged: false和最终累计engagement_time_msec的事件，或发送session_end事件。更可靠的方式是确保同一会话内所有事件使用相同session_id，GA4会基于最后一个事件的时间计算会话时长。

关键注意事项 #

• session_id必须是同一会话的唯一标识，建议用时间戳或随机字符串生成。
• engagement_time_msec需为数值类型（字符串或数字均可，禁止非数值内容），代表互动时长的累计或增量。
• 所有事件必须携带一致的client_id，保证用户标识统一。
• 同一会话内的参数规则要保持一致，不要混用不同标记方式。

按上述设置后，GA4即可正确计算并在「互动>概览」板块展示所需的互动类指标。

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