广告与变现
本站支持通过 Google AdSense 在文档页展示广告,用于补贴域名与写作成本。样式已预留位置,未配置环境变量时生产环境不显示广告。
广告位置
| 位置 | 环境变量 | 说明 |
|---|---|---|
| 正文上方 | ADSENSE_SLOT_ARTICLE_TOP | 面包屑下方 |
| 正文下方 | ADSENSE_SLOT_ARTICLE_BOTTOM | 页脚导航上方 |
| 右侧栏 | ADSENSE_SLOT_SIDEBAR | 仅桌面端(有目录时) |
开发环境下会显示 虚线占位框,便于预览版式。
配置步骤
- 在 Google AdSense 注册并通过站点审核(域名需与
docusaurus.config.ts中url一致)。 - 复制项目根目录
.env.example为.env。 - 填入发布商 ID 与各广告单元 slot:
ADSENSE_CLIENT=ca-pub-xxxxxxxxxxxxxxxx
ADSENSE_SLOT_ARTICLE_TOP=1234567890
ADSENSE_SLOT_ARTICLE_BOTTOM=1234567891
ADSENSE_SLOT_SIDEBAR=1234567892
- 重新构建并部署:
npm run build
注意
请勿将 .env 提交到 Git。.gitignore 已忽略该文件。
合规与体验建议
- 在 隐私政策(或独立页面)中说明使用 Cookie / 广告合作伙伴。
- 投资、健康类内容避免误导性广告文案与正文混淆;本站已在广告块上标注「广告」字样。
- 若 AdSense 审核未通过,可考虑 Carbon、EthicalAds 等替代,需自行改
src/components/AdSlot组件。
关闭广告
删除 .env 中的 ADSENSE_CLIENT 或留空即可;构建后全站不加载 AdSense 脚本。