随着 A Tour of Go 中文版本部署完成,go-dev.shuijingwanwq.com 已经进入持续优化阶段。
由于 A Tour of Go 采用单页应用(SPA)方式展示课程内容,页面切换并不会触发传统意义上的完整页面刷新。因此,在接入第三方统计和广告服务时,需要确认它们是否能够正确识别课程页面变化。
本文记录 go-dev 接入 Google Analytics、百度统计以及 Google AdSense Auto Ads 后的一轮验证过程。
一、go-dev 单页应用结构
go-dev 基于 A Tour of Go 原始架构进行本地化部署。
课程页面采用动态切换方式:
- 左侧显示课程内容;
- 右侧显示 Go Playground 示例;
- 点击下一页后,通过前端逻辑切换课程页面。
例如:
/tour/basics/16
↓
/tour/flowcontrol/1浏览器不会重新加载整个网站,而是直接更新当前课程状态。
因此,传统依赖页面加载事件的统计和广告代码,需要额外验证。
二、Google Analytics 4 单页统计验证
首先验证 Google Analytics 4(GA4)是否能够记录 SPA 页面变化。
测试过程中,在浏览器开发者工具 Network 面板观察:
analytics.google.com/g/collect请求。
点击下一页后,可以看到:
- 当前页面 URL 发生变化;
- GA4 收到新的
page_view请求。
例如:
dl=https://go-dev.shuijingwanwq.com/tour/flowcontrol/1
dr=https://go-dev.shuijingwanwq.com/tour/basics/17说明:
- GA4 已经正确识别 SPA 页面切换;
- 不需要额外增加手动页面统计代码。

三、百度统计单页应用支持验证
百度统计提供单页应用统计支持。
开启:
启用单页应用数据统计后,继续测试课程切换。
测试发现,点击下一页后,百度统计能够发送:
hm.baidu.com/hm.gif请求。
请求参数中包含:
su和:
u分别对应:
- 上一个页面;
- 当前页面。
例如:
/tour/basics/17
↓
/tour/flowcontrol/1说明百度统计已经能够正确记录课程页面变化。


四、Google AdSense 接入测试
统计验证完成后,继续测试 Google AdSense。
go-dev 当前采用:
Google AdSense Auto Ads自动广告模式。
首次加载页面时,会加载:
adsbygoogle.js并初始化自动广告。
开发者工具中可以看到:
pagead2.googlesyndication.com相关请求。
说明:
- AdSense 脚本加载正常;
- 广告请求链路正常。

五、Google 隐私提示验证
首次访问时,Google Privacy Messaging 会显示隐私提示。
该流程属于 Google 广告系统的一部分,用于处理用户隐私选择。
完成提示操作后,广告请求继续执行。

六、Auto Ads 插页广告测试
在测试过程中,Google Auto Ads 曾成功展示插页广告。
浏览器地址出现:
#google_vignette并显示 Google 自动广告页面。
这说明:
- AdSense 配置有效;
- 网站已经可以正常参与广告投放;
- 自动广告系统能够识别当前站点。

七、当前页面内广告状态
虽然 Auto Ads 已经可以正常工作,但目前页面内自动广告还没有稳定展示。
通过开发者工具检查:
data-adsbygoogle-status="done"
data-ad-status="unfilled"可以看到:
- 广告代码已经执行;
- Google 完成了广告请求;
- 当前广告位没有返回填充内容。
这并不代表配置失败。
可能原因包括:
- 新站点需要积累数据;
- 当前页面结构特殊;
- 广告库存不足;
- Google 自动广告仍在学习页面布局。
因此,当前没有立即调整广告代码,而是继续观察一段时间。
八、真实访问环境测试
为了排除测试环境因素,随后使用普通访问环境再次测试。
结果:
- 页面访问正常;
- GA4 统计正常;
- 百度统计正常;
- Google AdSense 请求正常。
目前没有发现统计和广告代码接入异常。

九、后续计划
当前 go-dev 已完成:
- GA4 单页统计验证;
- 百度统计单页支持验证;
- Google AdSense Auto Ads 接入验证。
后续将继续观察:
- Auto Ads 是否自动增加页面内广告;
- 单页切换后广告是否重新识别;
- 是否需要增加固定广告单元。
如果后续需要更精确控制广告位置,可以考虑在课程页面中加入固定广告区域,而不是完全依赖 Auto Ads。
总结
这次验证确认了 A Tour of Go 单页架构与第三方服务的兼容性:
- Google Analytics 4 可以正常记录 SPA 页面变化;
- 百度统计单页应用支持可以正常工作;
- Google AdSense Auto Ads 可以正常加载并展示广告。
对于基于 Go、JavaScript 动态切换内容的单页网站,统计服务通常需要关注页面变化事件,而广告系统则需要根据实际展示效果持续观察。
go-dev 当前已经具备完整的统计与广告基础设施,后续重点将转向用户体验和广告展示策略优化。
Go 学习与文档多语言本地化项目
本系列完整记录 Go 学习与文档多语言本地化项目从 A Tour of Go 起步,逐步扩展到站点首页、项目说明页、学习内容、文档以及未来内容包的实际开发过程,包括架构设计、统一术语治理、整页翻译、结构保护、自动校验、独立质量审核、生产发布与长期维护。
项目源码:
✅ GitHub:shuijingwan/go-tour-i18n
语言版本:
当前跨项目目标语言池共包含 66 个语言版本。Go 项目本身目前提供 65 个社区 Production 语言版本,下面每一门 Go 语言版本都直接链接到其当前公开站点。语言列表沿用项目首页现有的展示顺序。
英语(美国)仅作为跨项目目标语言纳入列表,并不是单独的 Go Production 语言版本。当前 Go 的英文源内容仍为官方 generic English,因此英语(美国)链接到 Go 官方站点,而不是不存在的本地社区部署。
- 阿姆哈拉语
- 阿拉伯语
- 孟加拉语
- 葡萄牙语(巴西)
- 保加利亚语
- 加泰罗尼亚语
- 克罗地亚语
- 捷克语
- 丹麦语
- 荷兰语
- 英语(美国)(Go 官方英文站点)
- 英语(澳大利亚)
- 英语(加拿大)
- 英语(印度)
- 英语(新加坡)
- 英语(南非)
- 英语(英国)
- 爱沙尼亚语
- 菲律宾语
- 芬兰语
- 法语(法国)
- 法语(加拿大)
- 德语(德国)
- 德语(奥地利)
- 德语(瑞士)
- 希腊语
- 古吉拉特语
- 希伯来语
- 印地语
- 匈牙利语
- 印度尼西亚语
- 意大利语
- 日语
- 卡纳达语
- 哈萨克语
- 韩语
- 西班牙语(拉丁美洲)
- 拉脱维亚语
- 立陶宛语
- 马来语
- 马拉雅拉姆语
- 马拉地语
- 书面挪威语(Bokmål)
- 波斯语
- 波兰语
- 葡萄牙语(葡萄牙)
- 旁遮普语(果鲁穆奇文,印度)
- 罗马尼亚语
- 俄语
- 塞尔维亚语(西里尔文)
- 简体中文(中国大陆)
- 简体中文(新加坡)
- 斯洛伐克语
- 斯洛文尼亚语
- 西班牙语(西班牙)
- 斯瓦希里语(坦桑尼亚)
- 瑞典语
- 泰米尔语
- 泰卢固语
- 泰语
- 繁体中文(台湾)
- 繁体中文(香港)
- 土耳其语
- 乌克兰语
- 乌尔都语
- 越南语
项目正在持续扩展新的 Go 学习与文档内容,并长期维护各语言版本的术语一致性、翻译质量、独立审核、生产发布与后续更新。
本项目属于非官方社区多语言本地化项目,与 Go 官方无隶属、授权或背书关系。

