Classic向Universal Google Analytics迁移求助：仅追踪生产域名数据

Hey there, I’ve helped a bunch of folks migrate from Classic GA to Universal Analytics (UA) while restricting tracking to production domains—let’s fix this for you! The key here is combining code-level domain validation (for immediate blocking) with GA backend filters (as a safety net) to ensure no test/pre-release data sneaks in.

1. 替换 Classic GA 代码为 UA 的 gtag.js（带域名校验） #

首先，把旧的 Classic GA 代码（_gaq.push() 那套）换成 UA 的现代 gtag.js 配置，但我们要加一层判断，只在生产域名下激活追踪。

下面是可直接使用的完整代码（把 UA-XXXXXXXXX-X 换成你的实际 UA ID，更新 allowedDomains 匹配你的生产主机名）：

<!-- Universal Analytics (gtag.js) 基础代码 -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXXXXXX-X"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  // 定义允许的生产域名（包含所有变体，比如带/不带www）
  const allowedDomains = ['your-production-domain.com', 'www.your-production-domain.com'];
  const currentHostname = window.location.hostname.toLowerCase();

  // 仅在生产域名下初始化 GA 追踪
  if (allowedDomains.includes(currentHostname)) {
    // 配置 GA 账号
    gtag('config', 'UA-XXXXXXXXX-X', {
      // 可选：禁用自动 pageview，如果你想手动控制发送时机
      // send_page_view: false
    });

    // 示例：迁移 Classic GA 的事件追踪
    // Classic GA 写法：_gaq.push(['_trackEvent', 'Button', 'Click', 'CTA-Home']);
    // UA 对应写法（放在事件触发的位置）：
    // gtag('event', 'Click', {
    //   event_category: 'Button',
    //   event_label: 'CTA-Home'
    // });
  }
</script>

这段代码保证只有当用户在你的已批准生产域名上时，GA 才会加载并发送数据——测试/预发布环境根本不会触发 GA 初始化。

2. 在 GA 后台添加过滤器（双重保障） #

即使有代码层面的校验，在 GA 后台加一层过滤器来拦截意外的测试数据也很稳妥。操作步骤：

• 登录你的 Universal Analytics 账号，进入对应媒体资源。
• 前往 管理 > 视图 > 过滤器 > 添加过滤器。
• 过滤器类型选择 自定义 > 排除。
• 过滤器字段选择 主机名。
• 过滤器模式用正则表达式排除所有非生产域名。比如你的生产域名是 your-production-domain.com 和 www.your-production-domain.com，就用：

  ^(?!your-production-domain.com$|www.your-production-domain.com$).*
  

• 给过滤器起个清晰的名字（比如「拦截非生产域名」），然后保存。

这个正则会匹配所有不完全符合生产域名的主机名，像 staging.your-domain.com 或 localhost 这类测试域名都会被过滤掉。

3. 验证方案生效 #

• 测试环境：打开测试/预发布站点，打开浏览器开发者工具 > 网络标签，搜索 google-analytics 或 gtag，应该看不到任何 GA 请求。
• 生产环境：在正式站点上，检查网络标签——应该能看到 GA 请求发送，数据也会逐渐出现在 UA 报表里。
• GA 后台：几小时后查看 UA 视图的实时报表，确认只有生产流量在展示。

需要避免的常见坑 #

• 大小写问题：window.location.hostname 返回的是小写，所以要确保 allowedDomains 数组里用小写主机名（或者给校验加 .toLowerCase()）。
• 遗漏域名变体：别忘了添加所有生产域名的变体（比如 your-domain.com 和 www.your-domain.com）。
• 事件迁移映射：把 Classic GA 事件迁移到 UA 时，要核对参数对应关系：Classic 的 _trackEvent(Category, Action, Label, Value) 对应 UA 的 gtag('event', 'Action', { event_category: 'Category', event_label: 'Label', value: Value })。

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