GA4接入自定义WordPress主题页面仅统计首页问题排查

注：只要自定义页面模板正常调用get_header()、页面加载时浏览器地址栏显示为当前页URL、源码内<title>标签为当前页标题，就不存在和自定义页面创建逻辑的冲突，不需要调整自定义页面、自定义文章类型的注册逻辑。

按以下优先级排查即可：

核心遗漏排查点 #

• 先校验前端实际上报参数：打开浏览器F12开发者工具，访问任意非首页页面，在网络面板筛选collect请求，查看请求携带的dt（页面标题）、dl（页面地址）参数值。如果这两个参数已经是当前页的对应内容，问题出在GA4后台配置，和前端代码无关：直接去GA4后台检查数据流配置里是否存在错误的参数覆盖规则、是否配置了将所有页面路径重写为首页的过滤器，删掉错误规则即可。
• 检查GA4代码是否硬编码了固定页面参数：很多人复制GA4安装代码时，会误保留示例中的自定义配置项，把page_title、page_path写死成首页的标题和根路径，类似gtag('config', 'G-XXXXXXX', {page_title: '站点首页', page_path: '/'});，这种写法无论访问哪个页面，都会上报固定的首页参数。默认配置不需要手动传入这两个参数，GA4会自动读取当前页面的标题和地址。
• 排查主题路由逻辑：如果主题用了无刷新切换页面的类SPA逻辑，页面跳转时不会触发整页重载，GA4只会在第一次打开站点（通常是首页）时触发一次默认的page_view上报，后续切换内页不会自动触发新的上报，所有访问就会全被记为首页。验证方式很简单：点击内页跳转时看网络面板有没有新的collect请求上报page_view事件，如果没有就是这个问题。
• 检查代码片段插件的全局逻辑：去Snippets插件的已启用代码列表里，搜索所有包含gtag、dataLayer、ga关键词的代码片段，很多生成器输出的代码会全局给GA注入固定参数，把全站的页面标题、路径统一覆写为首页值，哪怕你头部的安装代码是正确的，后执行的片段代码也会改掉上报参数。
• 校验缓存是否异常：如果站点开了全页缓存、CDN缓存，有可能所有页面的头部内容都被缓存成了首页版本，哪怕PHP代码是动态调用的，实际输出给访客的内容全是首页的固定值。直接用curl请求任意内页地址，看返回的HTML源码里的<title>标签是不是当前页标题、GA代码段有没有被缓存成固定首页值即可。

可行修复方案 #

• 删掉手动写在头部模板里的GA代码，改用WP原生钩子注入，避免被其他逻辑覆盖。可以在Snippets插件里新增如下PHP代码，把GA4 ID替换成你自己的即可，代码会动态读取当前页面的原生标题和路径，不会出现写死的问题：

add_action('wp_head', function() {
    $ga_id = '替换为你的GA4测量ID';
    ?>
    <script async src="https://www.googletagmanager.com/gtag/js?id=<?php echo esc_attr($ga_id); ?>"></script>
    <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', '<?php echo esc_js($ga_id); ?>', {
        'page_title': '<?php echo esc_js(wp_get_document_title()); ?>',
        'page_path': '<?php echo esc_js(wp_parse_url( $_SERVER['REQUEST_URI'], PHP_URL_PATH )); ?>'
      });
    </script>
    <?php
}, 1);

• 如果主题确实用了无刷新加载逻辑，不需要依赖GA的自动page_view上报，在每次页面切换完成的回调函数里，手动触发page_view事件上报即可，上报时传入当前页的标题和路径参数。
• 不想手动改代码的话，可以用官方的Site Kit插件配置GA4，插件会自动适配WP的页面逻辑，动态输出正确的页面参数，不会出现全记为首页的问题。

内容的提问来源于stack exchange，提问作者Brenda Burgoa