通过站点的 Astro 布局和静态文件集成 Google AdSense。这种方式使用站点代码,不需要 EmDash 插件。你需要能够访问站点的源代码和部署环境,并持有 AdSense 账号中的验证代码和发布商 ID。
站点审批、广告投放和用户同意要求均由 Google 控制。请按照 Google 的站点连接说明为你的账号完成设置。下面的示例展示的是这些代码在 EmDash 中应放置的位置,并不保证能通过 AdSense 审批。
添加验证代码和广告代码
-
打开你想要变现的公开页面所使用的共享布局。在博客模板中,它是
src/layouts/Base.astro。请保留其中已有的<EmDashHead>和其他 head 内容。 -
将 AdSense 代码粘贴到布局的
<head>中。下面的加载器示例使用了占位的发布商 ID;请把整个ca-pub-0000000000000000值替换为你自己的。<script is:inline async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000" crossorigin="anonymous" ></script>Astro 的
is:inline会让脚本保持原样,而不是对其打包。即使同一页面上有多个广告单元,也只需在每个页面加载一次该脚本。请参阅 Astro 的脚本处理文档。如果你选择 AdSense 的 meta 标签验证方式,请将 Google 提供的标签原样放入同一个
<head>中。下面的示例展示了带占位 ID 的 AdSense 账号标签。<meta name="google-adsense-account" content="ca-pub-0000000000000000" />EmDash Settings > SEO 中的 Google Verification 字段输出的是
google-site-verification,而不是google-adsense-account。请勿把 AdSense 发布商 ID 填入该字段。 -
对于自动广告,请在 AdSense 中配置广告位置。对于手动广告单元,请把 Google 提供的广告单元标记和初始化脚本粘贴到需要显示广告的 Astro 组件或页面中。请为所有初始化用的
<script>添加is:inline,以便 Astro 保留它。共享的加载器应保留在布局中,不要为每个广告单元重复添加。
请将可执行的广告代码放在受信任的站点源代码中,而不是文章内容里。启用广告脚本之前,请先落实各项同意要求;本示例并未实现同意管理器。如果站点设置了内容安全策略(Content Security Policy),请根据 Google 当前说明所需的资源进行配置。
在根目录提供 ads.txt
在你的 Astro 站点项目中创建 public/ads.txt,与站点的 src/ 目录同级。Astro 会原样复制 public 文件,因此该文件会通过 /ads.txt 提供访问。
将 AdSense 提供的那一行以纯文本形式复制到文件中。下面的示例使用了占位的发布商 ID;请使用 Google 为你的账号提供的那一行。
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
如果 ads.txt 已经存在,请在保留其他广告提供商条目的同时添加 AdSense 那一行。关于所需的域名和文件内容,请参阅 Google 的 ads.txt 指南。请将此文件保存在站点项目中,而不是 EmDash 媒体库中。
部署并检查
修改布局或 public/ 文件后,请重新部署站点。在已于 AdSense 注册的公开域名上,检查以下几点:
- 页面源代码的
<head>中包含所选的验证标签或脚本,其中带有你的发布商 ID,并且只有一个共享的 AdSense 加载器。 https://your-domain.example/ads.txt返回的是预期的纯文本,而不是 404 或 HTML 页面。- 浏览器的网络和控制台面板中没有脚本错误,也没有被站点安全策略拦截的请求。广告拦截器可能会导致本地检查时广告无法加载。
返回 AdSense 申请验证和审核。脚本成功加载或 ads.txt 文件可以访问,本身并不表示站点已通过审批,也不表示广告一定会显示。
在插件中复用该集成
对于需要在多个站点之间共享的集成,受信任的原生插件可以通过 page:fragments 提供脚本。宿主布局必须渲染相应的 EmDash 插入组件。沙箱插件无法注入脚本或原始 HTML。静态的 public/ads.txt 文件仍属于站点级的部署事项。