Apply Google AdSense

註冊與提交 URL：
- 訪問 Google AdSense 官網，點擊「開始使用」。
- 輸入你的網站網址（注意：必須是頂級域名，如 yourblog.com。如果是 GitHub Pages 的子域名 user.github.io 有時審核較嚴格）。
放置驗證代碼 (Connect your site)：
- AdSense 會提供一段 <script> 代碼。
- MkDocs 設置：請將此代碼放入你之前建立的 overrides/main.html 的 {% block extrahead %} 中。
設置 ads.txt (關鍵步驟)：
- 在 AdSense 後台下載 ads.txt。
- 將其放在 MkDocs 的 docs/ 文件夾下。
- 確保 mkdocs.yml 配置了 extra_assets 包含此文件，確保發布後可以通過 yourblog.com/ads.txt 訪問。
等待審核：
- Google 會派機器人爬取你的內容。這通常需要 2 天到 2 週。
- 技巧：審核期間請保持文章更新（建議至少有 10-15 篇高品質技術文章）。

2. 目錄結構

my-project/
├── mkdocs.yml
├── docs/
│   ├── ads.txt
│   └── privacy.md
└── overrides/
    └── main.html

3. 廣告設置

在你的項目根目錄（mkdocs.yml 所在位置）創建一個名為 overrides 的文件夾。
通常廣告適合放在側邊欄下方或文章底部。我們可以修改 main.html。在 overrides 文件夾內新建一個文件 main.html，將代碼貼在 extrahead 區塊
1. AdSense 程式碼片段
2. 中繼標記
  1. 搜尋引擎優化 (SEO) 的中繼標記
  2. 能幫助 Google 更好地索引你的文章，進而提高廣告收益

main.html

Google 不提供專門的測試廣告代碼給一般網站開發者

{% extends "base.html" %}

{% block extrahead %}

   {# 1. AdSense 程式碼片段 #}
   
  <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-XXXXXXXXXXXXXXXX" crossorigin="anonymous"></script>

   {# 2. 中繼標記 #}
  <meta name="google-adsense-account" content="ca-pub-XXXXXXXXXXXXXXXX">
{% endblock %}

{% block content %}
  {{ super() }}

  {# 2. 在內容之後插入廣告區塊 #}

  {# 4. 廣告區塊 #}
  <div style="margin-top: 2rem;">
    <ins class="adsbygoogle"
         style="display:block"
         data-ad-client="ca-pub-XXXXXXXXXXXXXXXX"
         data-ad-slot="XXXXXXXXXX"
         data-ad-format="auto"
         full-width-responsive="true"></ins>
    <script>
         (adsbygoogle = window.adsbygoogle || []).push({});
    </script>
  </div>
{% endblock %}

AdSense 驗證碼：一定要放進 <head> 與 </head> 之間（即 MkDocs 的 extrahead 區塊）

mkdocs.yml

theme:
  name: material
  custom_dir: overrides

mkdocs.yml 對於技術 Blog 來說，建議也在 mkdocs.yml 中設置基本的 SEO 中繼標記，這能幫助 Google 更好地索引你的文章，進而提高廣告收益

site_name: 你的技術筆記
site_description: 提供最新的技術教學與開發心得
site_author: 你的名字
site_url: https://yourblog.com

4. ads.txt

用途： - 防止廣告詐欺：它告訴廣告商，只有這個帳號（你的 pub ID）被授權在這個網域上賣廣告。

收益保障：如果 Google 抓不到這個文件，AdSense 後台會出現紅色的警告訊息，甚至會導致廣告停止投放。

ads.txt：Google AdSense 通常要求你在網站根目錄放置一個 ads.txt。請將該文件放在 docs/ 目錄下，並在 mkdocs.yml 確保它被包含：

mkdocs.yml

extra_assets:
  - ads.txt

在 AdSense 後台下載 ads.txt。
將其放在 MkDocs 的 docs/ 文件夾下。
訪問 http://127.0.0.1:8000/ads.txt
- 如果瀏覽器直接顯示了類似 google.com, pub-xxxxxxxxxxxxxxxx, DIRECT, f08c47fec0942fa0 的文字，表示配置成功。

5. 隱私政策（Privacy Policy）

想透過 Google AdSense 獲利，隱私政策（Privacy Policy）是 強制要求的合規義務。如果你的網站沒有這頁，或者內容不合規，AdSense 申請幾乎 100% 會被拒絕。

Google 在其服務條款中明確規定，發布商（也就是你）必須告知使用者：

網站使用了 Cookie。
第三方廠商（如 Google）會根據使用者之前的訪問記錄來投放廣告。
使用者可以選擇退出個性化廣告（提供退出連結）。

即便你的 Blog 是個人性質，只要有來自歐洲（GDPR）或美國加州（CCPA）的讀者，法律就要求你必須說明：

你收集了哪些數據（例如 IP 地址、瀏覽器資訊）。
你如何處理這些數據。
技術 Blog 常見數據來源：Google Analytics 追蹤代碼、留言板的 Email、廣告追蹤器。

5.3. 隱私政策公版 (Markdown 格式)

# Privacy Policy | 隱私政策

本站（以下簡稱「我們」）非常重視您的隱私。本頁面旨在告知您我們如何收集、使用和披露當您使用本服務時產生的個人信息。

## 1. 信息的收集與使用
本站主要為技術分享博客，通常不會主動要求您提供個人識別信息。但在以下情況下，我們可能會獲取相關數據：
* **日誌數據 (Log Data)**：如您的 IP 地址、瀏覽器類型、訪問頁面及停留時間。
* **Cookie**：我們使用 Cookie 來提升用戶體驗，您可以通過瀏覽器設置拒絕所有 Cookie。

## 2. 廣告與第三方服務 (AdSense & Analytics)
為了維持站點運營，我們使用了第三方服務：
* **Google AdSense**：Google 作為第三方供應商，使用 Cookie 根據用戶對本站及其他網站的訪問情況來投放廣告。您可訪問 [Google 廣告設置](https://www.google.com/settings/ads) 退出個性化廣告。
* **Google Analytics**：我們使用其分析流量，幫助我們了解哪些技術文章對讀者更有幫助。

## 3. 外部連結
本站包含許多指向其他技術資源或文檔的連結。我們不對這些第三方網站的內容或隱私政策負責。

## 4. 政策修訂
我們可能會不時更新此隱私政策。建議您定期查閱本頁面。

---
*最後更新日期：2026年2月4日*

可以在 Footer 添加連結

mkdocs.yml

theme:
  name: material
  features:
    - navigation.footer
copyright: |
  Copyright &copy; 2026 YourName - <a href="/privacy/">Privacy Policy</a>

Be the first one to support oldfesixsixsix.

Apply Google AdSense

1. Google AdSense 申請流程

2. 目錄結構

3. 廣告設置

4. ads.txt

5. 隱私政策（Privacy Policy）

5.1. Google AdSense 的官方條款

5.2. 法律合規性 (GDPR / CCPA)

5.3. 隱私政策公版 (Markdown 格式)