透過網站的 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 檔案仍屬於網站層級的部署事項。