—— 适用于 GA4、Google Ads、GTM 三种场景，跟着做 30 分钟搞定 ——
一、先判断：你到底属于哪种安装方式？
用浏览器打开首页 → 右键“查看页面源码” → Ctrl+F 搜索下列关键词：
出现 plugins/ga-google-analytics → A 插件方式
出现 gtag/js?id=G- 且路径不在 /plugins/ → B 手动方式
出现 gtm.js 或 GoogleTagManager → C GTM 方式
记录结果，再进入对应章节。
二、A 插件方式：5 步把“未添加”变“已添加”
装对插件
推荐顺序：Site Kit by Google（官方）＞ GA Google Analytics ＞ WPCode
填对 ID
在插件设置里只填测量 ID，格式一定是 G-XXXXXXXXXX（GA4）或 AW-XXXXXXXXXX（Ads），前后别加空格。
禁用重复插件
同一站点同时启用 2 个以上 GA 插件会互相覆盖，全部关掉只留一个。
清缓存
WP Rocket、LiteSpeed、Cloudflare、宝塔、OPcache 五处缓存全部清空，并开“隐身窗口”刷新。
用 Tag Assistant 复查
浏览器装「Tag Assistant Legacy」→ 点亮小图标 → 看是否出现绿色笑脸「Google tag detected」。
绿色出现仍显示“未添加”？直接跳“七、24 小时规则”。
三、B 手动方式：确保代码躺在 <head> 第 1 屏
最佳入口
用子主题 functions.php 添加，避免主题更新被覆盖。代码如下：
/* 插入 Google tag 到 <head> */
add_action('wp_head', 'my_google_tag', 1);
function my_google_tag() { ?>
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'G-XXXXXXXXXX');
</script>
<?php }禁止放错地方
不要放在 footer.php、文章编辑器、小工具；延迟加载插件（Flying Scripts 等）不要把 gtag 推迟。
检查是否被合并/延迟
在「查看源码」里搜索 gtag 关键词，如果出现在 defer 或 lazy-load 类里，把该脚本加入插件白名单。
清缓存 → Tag Assistant → 绿色笑脸即成功。
四、C GTM 方式：容器发布了才算数
先装 GTM 插件
推荐「Google Tag Manager for WordPress」by DuracellTomi，激活后填容器 ID GTM-XXXXXXX。
在 tagmanager.google.com 里新建标签：
标签类型选「Google Analytics: GA4 配置」→ 触发器选「All Pages」→ 右上角「提交」→「发布」。
仅保存不提交 = 网站永远“未添加代码」。
开启「预览」模式，输入自己域名，确认 Page View 事件触发；成功后关闭预览。
清缓存 → Tag Assistant 应显示「GTM-XXXXXXX」绿色，再展开能看到 GA4 标签被触发。
若 Tag Assistant 只检测到 GTM 却看不到 GA4，回到步骤 2 检查触发器是否配错。
五、通用排查：90%“未添加”都是这 4 个低级错误
robots.txt 封禁
不要出现：
User-agent: *
Disallow: /
允许 Googlebot 抓取即可。
防火墙/安全插件
Wordfence、iThemes Security、宝塔 WAF 把「googlebot」当恶意 UA 拦截，临时关闭再测。
浏览器广告屏蔽
uBlock、AdGuard 会把 gtag 屏蔽，Tag Assistant 要在无插件的隐身窗下运行。
复制错 ID
把 GA4 的 G- 填成 UA- 或把 Ads 的转化 ID AW- 填成 G- 都会让后台终身显示“未添加”。
六、验证生效的 3 个黄金标准
Tag Assistant 绿色笑脸 + 列表出现对应 ID
GA4「实时」报告 30 秒内出现活跃用户
Google Ads「转化」列显示“最近 7 天收到数据”
同时满足两项即可 100% 确定成功。
七、24 小时规则：做完以上仍显示“未添加”怎么办？
Google 的“代码覆盖情况”摘要并非实时，最长 24 h 刷新。
建议：
当天不再反复改代码，避免触发多次验证。
第二天上午再回 [Google Ads 账户 > 工具与设置 > 数据跟踪 > 代码覆盖情况] 看是否已变绿。
超过 24 h 仍红色 → 回到本教程第二章重新检测，必定能定位问题。
八、一次性复查清单（打印出来打钩）
□ 插件只启用 1 个 GA 相关
□ ID 格式正确且无空格
□ 代码躺在 <head> 第一屏
□ GTM 已发布而非仅保存
□ 五处缓存全部清空
□ Tag Assistant 绿色
□ GA4 实时报告有用户
□ robots.txt 允许抓取
□ 防火墙未拦截 googlebot
全部打钩 → 安心等待 24 h，状态必变“已添加”。
WordPress 上让 Google 正确识别代码，其实就是“装对地方 + 装对格式 + 清缓存 + 等刷新”。
跟着本文 8 大步做完，最快 5 分钟、最慢 24 小时，就能把“未添加代码”变成绿色“已添加”，广告投放和数据分析立刻生效。祝你一次成功！
暂无评论内容