Google AdSense

本頁內容

透過網站的 Astro 版面配置和靜態檔案整合 Google AdSense。這種方式使用網站程式碼,不需要 EmDash 外掛。你需要能夠存取網站的原始碼和部署環境,並持有 AdSense 帳號中的驗證碼和發佈商 ID。

網站審核、廣告投放和使用者同意要求均由 Google 控制。請依照 Google 的網站連結說明為你的帳號完成設定。下方範例展示的是這些程式碼在 EmDash 中應放置的位置,並不保證能通過 AdSense 審核。

新增驗證碼和廣告程式碼

  1. 開啟你想要變現的公開頁面所使用的共用版面配置。在部落格範本中,它是 src/layouts/Base.astro。請保留其中既有的 <EmDashHead> 和其他 head 內容。

  2. 將 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 填入該欄位。

  3. 對於自動廣告,請在 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 檔案仍屬於網站層級的部署事項。