如何在Google Analytics自定义事件中添加流量来源（UTM参数）

核心问题根源 #

GA的source/medium等推广维度属于会话级属性，默认仅在用户首次进入站点时解析URL中的UTM参数并绑定到当前会话。如果仅在触发自定义事件时临时设置参数，GA不会自动覆盖已有的会话来源（比如默认的(direct)），必须正确处理会话级属性的传递逻辑。

正确实现方案 #

1. 完善UTM参数的持久化逻辑 #

你用Cookie保存UTM参数的思路是对的，但需补充以下规则：

• 仅当用户首次访问（无对应Cookie）时，从URL提取UTM参数存入Cookie；后续访问优先读取Cookie值，避免被无UTM的新URL覆盖。
• Cookie有效期建议设置为30天，匹配GA的会话周期。

2. 正确设置会话级推广属性 #

不要在事件或config调用中临时传参，而是通过gtag('set')设置会话级全局属性，确保后续所有事件自动携带这些参数：

// 从Cookie读取已保存的UTM参数（需自行实现getCookie方法）
const savedUtmCookie = getCookie('saved_utm');
const utmParams = savedUtmCookie ? JSON.parse(savedUtmCookie) : {};

// 仅当存在有效UTM参数时设置全局属性
if (utmParams.campaign_source) {
  window.gtag('set', {
    campaign_source: utmParams.campaign_source,
    campaign_medium: utmParams.campaign_medium,
    campaign_name: utmParams.campaign_name,
    campaign_term: utmParams.campaign_term,
    campaign_content: utmParams.campaign_content
  });
}

这段代码要放在GA初始化完成后、所有自定义事件发送前，最好在页面加载时执行。

3. 发送事件时无需重复传递UTM参数 #

只要上述set方法执行成功，GA会自动将这些会话级属性附加到后续所有事件中，无需在gtag('event', ...)的参数里重复传入utmObj。

4. 避免错误调用config方法 #

你之前调用gtag('config', 'GTM-XXXXX', {...})是错误的——config用于GA初始化，重复调用会重置会话，反而可能覆盖正确的UTM参数。如果你的GA通过GTM部署，无需前端手动调用config，而是在GTM中配置变量读取Cookie里的UTM参数即可。

5. 验证生效状态 #

• 打开GA实时报告，触发自定义事件，查看事件的source/medium是否正确显示。
• 用浏览器开发者工具查看GA的collect接口请求，检查参数中是否包含cs（source）、cm（medium）、cn（campaign名称）等字段。

额外注意点 #

• 跨页面跳转时，确保Cookie的domain设置为顶级域名，避免Cookie丢失。
• 不要在隐私模式下测试，否则Cookie会被清空，导致UTM参数无法持久化。

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