在构建基于 Google AdSense 盈利的网站时，开发者可能会遇到广告单元不自动刷新或填充失败的问题，尤其是在单页应用（SPA）场景中。当页面发生内容切换，广告未能及时更新，会影响展示效果和收益。
为解决这一类问题，本文介绍一个我自己实现、实际使用中的轻量级 JavaScript 脚本 auto-refresh-gad.js，用于在特定条件下自动刷新页面上的 Google AdSense 广告单元。
👉 已开源：https://github.com/axiaoxin/auto-refresh-gad.js
背景与动机
Google AdSense 通常依赖于页面加载事件自动填充广告内容。然而在以下场景中，这种机制可能失效：
- 单页应用中的路由切换：广告不会重新加载；
- 广告填充失败：可能因网络、缓存或竞价失败导致空白；
- 用户长时间停留在同一页面：广告内容不会变更，收益效率降低。
Google 官方尚无标准方案可解决这些问题，因此通过脚本控制广告刷新成为一个实际可行的技术补丁。
实现原理
该脚本的核心机制包括：
- 视口可见性检测：判断广告是否进入视口，仅刷新可视区域内的广告单元；
- 用户行为触发：仅在检测到用户滚动、点击等行为后才启动刷新；
- 计时与节流控制：配置最小刷新间隔与最大刷新次数，避免频繁请求；
- 动态替换广告 HTML 内容：删除原有
<ins class="adsbygoogle">元素，重新插入并执行adsbygoogle.push({})来触发重新加载。
安装与使用
1. 获取脚本
你可以访问 GitHub 仓库下载脚本文件：
建议将脚本托管到自己的网站上，避免因第三方资源不可用导致加载失败。
2. 添加广告容器
确保广告外层使用统一类名（默认 .auto-refresh-gad）：
<div class="auto-refresh-gad">
<ins
class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-XXXXXXX"
data-ad-slot="XXXXXXX"
data-ad-format="auto"
data-full-width-responsive="true"
></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</div>
3. 引入脚本文件
将脚本引入页面底部，在 <body> 标签结束前加载：
<script src="/js/auto-refresh-gad.js"></script>
如果使用构建工具（如 Vite/Webpack），可作为模块引入打包。
4. 可选配置
通过 window.CONFIG 对象进行自定义配置，需在脚本加载前设置：
window.CONFIG = {
minRefreshInterval: 120000,
maxRefreshInterval: 180000,
maxRefreshCount: 5,
viewportThreshold: 0.7,
containerSelector: ".auto-refresh-gad",
debug: false,
};
使用建议
| 配置项 | 推荐值 |
|---|---|
| minRefreshInterval | ≥ 180000ms（3 分钟） |
| maxRefreshCount | ≤ 5 |
| viewportThreshold | ≥ 0.7 |
| 生产环境关闭调试 | 将 debug 设置为 false |
务必避免配置为高频刷新行为，建议设置保守参数，避免触发 AdSense 合规风险。
分享一些和其他站长交流以及我的个人经验：
- 你的网站刚上线，没多少访问量，别冒险，用原生广告加载就行，先过内容审核门槛
- 新注册的 AdSense 账号也最好不要添加自动刷新 AdSense 广告单元的功能，新号的风控级别可能会更严
- 你想提升收益但怕违规，优化内容结构、提升用户粘性、测试高点击率广告位
- 你想测试这个脚本，请用小号测试，风险自负
合规性注意事项
Google AdSense 禁止人为制造无效展示。虽然脚本未模拟点击或虚假行为，但频繁刷新广告可能仍被视为异常。
适用场景包括：
- 单页应用中的广告重载；
- 广告填充失败时的容错机制；
- 页面停留时间过长时的低频刷新。
⚠️ 不建议用于 试图提升广告展示次数 或规避 Google 检测的场景，使用者需自行评估风险。
总结
auto-refresh-gad.js 是一个轻量、易用的广告刷新补丁，适合用于特定前端场景下优化 AdSense 加载行为。
- 支持 SPA 和滚动场景；
- 可配置刷新频率与上限；
- 遵循合理触发机制，尽量减少违规风险。
完整源码与使用说明见：auto-refresh-gad.js GitHub 项目地址。
欢迎 Star 或提 Issue 交流改进。
