如何手动获取GA4链接器参数(_gl)实现表单POST跨域跟踪

GA4自动追加_gl链接器参数的逻辑默认只覆盖普通<a>标签跳转、window.location直接赋值等常规导航场景，HTML表单POST提交、手动构造跳转地址等场景不会自动注入参数，可通过以下两种方式手动获取参数完成拼接，效果和UA时代的ga.getAll()[0].get('linkerParam')完全一致：

• 调用gtag内置接口获取参数
  GA4的gtag.js运行时内置了链接器参数生成方法，只要GA4基础代码初始化完成，就可以通过get命令直接拉取对应域名的合法_gl参数，不需要额外引入工具库：

  // 替换为你自己的GA4衡量ID（G-开头）和已配置跨域的目标域名
  const GA4_MEASUREMENT_ID = 'G-XXXXXXXXXX';
  const TARGET_CROSS_DOMAIN = 'third-party-example.com';
  
  gtag('get', GA4_MEASUREMENT_ID, 'linkerParam', {
    domains: [TARGET_CROSS_DOMAIN]
  }, (linkerParamStr) => {
    // linkerParamStr 即为完整的 _gl=xxxxxx 格式字符串
    const postForm = document.querySelector('#your-cross-domain-form');
    // 兼容原action地址已携带查询参数的场景
    const splitChar = postForm.action.includes('?') ? '&' : '?';
    // 把参数拼接到表单action地址末尾
    postForm.action = postForm.action + splitChar + linkerParamStr;
    // 拼接完成后再执行原有表单提交逻辑即可
  });
  

  注意调用该接口时传入的domains列表必须和GA4后台跨域配置里的域名规则完全匹配，否则生成的参数无法被目标站点的GA4识别为合法跨域标识。

• 全局监听表单提交自动追加参数（无侵入适配）
  如果项目中存在多个跨域跳转表单，不想逐个修改提交逻辑，可以在捕获阶段全局监听表单提交事件，自动给匹配跨域规则的表单action追加参数：

  // 替换为你在GA4后台配置的所有跨域关联域名
  const CROSS_DOMAIN_LIST = ['third-party-example.com', 'another-trusted-domain.com'];
  const GA4_MEASUREMENT_ID = 'G-XXXXXXXXXX';
  
  document.addEventListener('submit', (e) => {
    const form = e.target;
    // 跳过未设置action、或action为javascript伪协议的表单
    if (!form.action || form.action.startsWith('javascript:')) return;
    
    const formActionUrl = new URL(form.action, window.location.origin);
    // 只处理跳转至跨域域名的表单
    const isCrossDomainTarget = CROSS_DOMAIN_LIST.some(domain => 
      formActionUrl.hostname.endsWith(domain)
    );
    if (!isCrossDomainTarget) return;
    // 避免重复追加_gl参数
    if (formActionUrl.searchParams.has('_gl')) return;
  
    gtag('get', GA4_MEASUREMENT_ID, 'linkerParam', {
      domains: CROSS_DOMAIN_LIST
    }, (paramStr) => {
      const [paramKey, paramValue] = paramStr.split('=');
      formActionUrl.searchParams.set(paramKey, paramValue);
      form.action = formActionUrl.toString();
    });
  }, true);
  

特殊场景说明：如果你的业务逻辑是前端通过POST接口提交表单数据，再由后端返回302响应跳转到第三方站点，前端无法直接修改302跳转的目标地址，需要后端在返回跳转Location头时，同步拼接前端传入的_gl参数才能完成跨域用户标识打通。

内容的提问来源于stack exchange，提问作者Luke Z.