17370845950

最可靠方式是直接嵌入GA4代码，需在插入gtag脚本并配置测量ID；国内建议同步部署百度统计或腾讯分析；自建统计须处理CORS、缓存、上报时机及重试；验证时需避开file://协议、内部IP过滤和插件干扰。

直接嵌入 Google Analytics 4（GA4）代码最可靠

HTML5 页面发布后无法自动统计访问量，必须手动添加第三方统计脚本。目前主流且免费可用的是 Google Analytics 4，它不依赖 Cookie，兼容现代隐私策略，比旧版 UA 更稳定。

操作要点：

• 在 Google Analytics 后台创建 GA4 媒体资源，获取 G-XXXXXXXXXX 格式的测量 ID
• 将以下代码插入 HTML 文件的 标签内（注意替换 G-XXXXXXXXXX）
• 确保每个页面只加载一次，避免重复埋点导致数据虚高

GA4 默认采集页面浏览、停留时长、跳出率等基础指标，无需额外配置即可使用。若页面是单页应用（SPA），需手动调用 gtag('event', 'page_view', ...) 触发路由变化统计。

国内环境优先考虑百度统计或腾讯分析

GA4 在中国大陆部分地区存在加载不稳定、延迟高甚至无法加载的问题，导致数据丢失。若目标用户主要在国内，建议同步部署百度统计（tongji.baidu.com）或腾讯分析（mta.qq.com）作为备用或主用方案。

常见问题：

• 百度统计 JS 加载失败时，控制台会报错 Failed to load resource: net::ERR_BLOCKED_BY_CLIENT，多因广告拦截插件屏蔽了 hm.js
• 腾讯分析需在 mta.qq.com 创建站点并获取 APPID，其 SDK 更轻量，对首屏影响小
• 不要同时开启多个统计工具的默认页面事件，否则会重复计数

百度统计基础代码示例（放在 底部）：

自建统计需绕过跨域与缓存干扰

如果出于数据主权或合规要求必须自建统计服务（如用 Node.js + SQLite 记录 PV/UV），关键难点不是写接口，而是前端如何可靠上报且不被浏览器拦截。

必须处理的细节：

• 前端用 fetch 发送 POST 请求时，服务端响应头必须包含 Access-Control-Allow-Origin，否则触发 CORS 错误
• 上报 URL 建议带时间戳参数（如 /log?_t=1712345678900）防止强缓存导致漏报
• 避免在 window.onload 之后才上报，应尽早执行（例如在 DOMContentLoaded 阶段），否则用户快速关闭页面会导致丢失
• 上报失败需加入简单重试逻辑（最多 1 次），但不要无限重试阻塞主线程

简易前端上报示意（不依赖第三方库）：

function reportPageView() {
  const url = '/api/log?path=' + encodeURIComponent(window.location.pathname) + '&_t=' + Date.now();
  fetch(url, { method: 'POST', keepalive: true })
    .catch(() => {
      // 失败时尝试 localStorage 缓存，下次页面加载再补发
      const pending = JSON.parse(localStorage.getItem('pending_logs') || '[]');
      pending.push({ url, ts: Date.now() });
      localStorage.setItem('pending_logs', JSON.stringify(pending.slice(-10)));
    });
}
document.addEventListener('DOMContentLoaded', reportPageView);

验证是否生效不能只看实时数据面板

刚部署统计代码后，常误以为“没数据=没生效”，其实多数情况是延迟或过滤规则导致。GA4 和百度统计的实时报告有 1–3 分钟延迟，且默认排除内部 IP（如公司办公网）、已安装广告拦截插件的用户、以及启用了“请勿跟踪”（DNT）请求头的浏览器。

快速验证步骤：

• 用手机热点切换网络，打开页面，观察实时报告中是否出现新会话
• 在 Chrome 开发者工具的 Network 标签页过滤 collect（GA4）或 hm.gif（百度统计），确认请求发出且返回 200
• 检查 GA4 的 DebugView 或百度统计的 代码检查工具，它们能显示字段是否正确传递
• 禁用所有浏览器扩展后重试，排除插件干扰

最容易被忽略的是：本地开发时用 file:// 协议打开 HTML，所有统计脚本都会因协议限制失效——必须通过 http:// 或 https:// 提供服务才能正常上报。