Google 看不懂你的網站？別再瞎猜！工程師的 Schema 結構化資料手術指南

我們的唯一選擇，也是 Google 官方推薦的格式，就是 JSON-LD (JavaScript Object Notation for Linked Data)。為什麼？

• 乾淨分離：JSON-LD 通常放在 `` 或 `` 的一個 `` 標籤裡，完全不侵入你原本的 HTML 結構。這對我們這些有程式碼潔癖的工程師來說，簡直是福音。
• 易於生成與維護：因為它就是一個 JSON 物件，在後端用 PHP 動態生成簡直不要太輕鬆。你可以輕易地用 WordPress 的函式抓取資料，然後 `json_encode` 就搞定了。
• 可讀性高：巢狀的鍵值對結構，讓複雜的實體關係一目了然。

WordPress 實作：從外掛便利貼到程式碼手術刀

我知道，很多人會說：「裝個 Yoast SEO 或 Rank Math 不就好了？」沒錯，這些外掛確實提供了基本的 Schema 功能，對於標準的文章 (Article)、頁面 (WebPage) 來說，它們做得不錯。但這就像是便利貼，方便快速，卻解決不了根本問題。

外掛的極限在哪？

當你的網站有「自訂內容類型 (Custom Post Type)」時，外掛就開始力不從心了。例如，你可能有一個「課程」CPT，包含講師、開課日期、價格等自訂欄位。或是「團隊成員」CPT，包含職稱、分機、專業領域。這時候，通用型的 SEO 外掛產生的 Schema 很可能只是陽春的 `Article` 或 `WebPage`，完全無法體現你內容的獨特性。

親自動手：用 `functions.php` 注入你的專屬 Schema

這才是今天的主菜。我們要做的，就是針對特定的頁面類型，用程式碼動態產生精準的 JSON-LD。假設我們有個名為 `course` 的自訂文章類型，並且用 ACF (Advanced Custom Fields) 建立了一些欄位，如 `course_teacher` (講師)、`course_price` (價格)、`course_start_date` (開課日)。

我們可以在佈景主題的 `functions.php` 或是一個自訂外掛中，加入以下程式碼：

<?php
add_action('wp_head', 'roamer_add_course_schema');

function roamer_add_course_schema() {
    // 只在 'course' 這個自訂文章類型的單一頁面執行
    if (is_singular('course')) {
        global $post;

        // 獲取自訂欄位的值，記得加上第二個參數 true 來取得單一值
        $teacher_name = get_post_meta($post->ID, 'course_teacher', true);
        $course_price = get_post_meta($post->ID, 'course_price', true);
        $start_date = get_post_meta($post->ID, 'course_start_date', true); // 假設儲存格式為 Y-m-d

        // 建立 Schema 陣列
        $schema = array(
            '@context' => 'https://schema.org',
            '@type' => 'Course', // 使用 Course 類型
            'name' => get_the_title(),
            'description' => get_the_excerpt(),
            'provider' => array( // 課程提供者，可以是組織
                '@type' => 'Organization',
                'name' => get_bloginfo('name'),
                'url' => home_url()
            ),
            // 如果有講師資訊，才加入 offers 區塊
            'offers' => array(
                '@type' => 'Offer',
                'price' => $course_price ? $course_price : '0',
                'priceCurrency' => 'TWD',
                'availability' => 'https://schema.org/InStock'
            )
        );

        // 如果有講師資訊，才加入 provider 區塊
        if (!empty($teacher_name)) {
            $schema['provider']['name'] = $teacher_name;
        }

        // 如果有開課日期，才加入 startDate 欄位
        if (!empty($start_date)) {
            $schema['startDate'] = date('Y-m-d', strtotime($start_date));
        }

        // 將 PHP 陣列轉換為 JSON-LD 格式並輸出
        echo '<script type="application/ld+json">' . json_encode($schema, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT) . '</script>';
    }
}
?>

看看這段程式碼，我們做了什麼？

1. 用 `add_action('wp_head', ...)` 把我們的函式掛載到網站的 `` 區域。
2. 用 `is_singular('course')` 條件判斷，確保這段程式碼只會在「課程」的內頁執行，避免污染其他頁面。
3. 使用 `get_post_meta()` 和 `get_the_title()` 等 WordPress 標準函式來動態抓取頁面資料。這才是精髓！你的 Schema 會跟著你的內容自動更新。
4. 建立一個 PHP 陣列 `$schema`，結構完全對應 Schema.org 的 `Course` 類型。我們甚至可以做一些判斷，例如有價格才顯示 `offers` 區塊。
5. 最後，使用 `json_encode()` 把它轉換成 JSON 字串，並用 `` 包起來輸出。其中 `JSON_UNESCAPED_UNICODE` 參數可以確保中文字不會變成亂碼，非常重要。

這就是工程師的作法——精準、自動化、可擴展。你可以依此類推，為任何 CPT 打造專屬的 Schema，不管是 `Event`、`Recipe` 還是 `LocalBusiness`。

驗證！驗證！驗證！工程師的偏執

寫完程式碼就結束了？當然不。身為一個負責任的工程師，「沒有測試過的程式碼就只是個昂貴的祈禱」。你必須驗證你產生的 Schema 是否正確無誤。

這裡有兩個你必須加到書籤的工具：

• Google 的 Rich Results Test (豐富結果測試)：這個工具會告訴你，你的頁面「是否符合」Google 豐富結果的資格。它比較嚴格，只會針對 Google 支援的類型進行驗證。
• Schema Markup Validator：這是 Schema.org 官方的驗證器，它會檢查你的語法是否符合規範，不管 Google 支不支援。通常我會先用這個確保語法正確，再用 Google 的工具確認資格。

一個常見的坑是，很多 SEO 外掛會自己產生一套 Schema。當你又手動加入另一套時，頁面上就會有「重複」的結構化資料。雖然 Google 說它會試圖理解，但這無疑增加了混淆的風險。最好的作法是，如果你決定手動控制某個頁面類型的 Schema，就去 SEO 外掛裡關掉該頁面的自動生成功能，確保來源單一。

結論：不只是為了 SEO，更是為了未來

從工程師的角度來看，實作 Schema 結構化資料，不僅僅是為了討好 Google、提升排名。它的核心價值在於「讓資訊變得機器可讀 (Machine-Readable)」。這是在為一個更智慧、更自動化的網路世界鋪路。

當我們不再滿足於外掛提供的「罐頭」方案，而是親手為網站的獨特內容量身打造精準的 Schema 時，我們不僅是在做 SEO，更是在實踐一種「語意網 (Semantic Web)」的理想。我們把網站從一個單純給人看的「數位傳單」，升級成一個能與各種 AI、智慧助理、搜尋引擎深度對話的「結構化數據庫」。

這件事，很酷，而且非常值得我們工程師投入時間去把它做好。

延伸閱讀

• 2026 AI 時代 SEO 完整指南：AEO、GEO 與被 AI 引用的新戰場
• 流量不是靠拜拜！資深工程師的 WordPress SEO 終極藍圖：從技術健檢到內容策略，打造永續成長引擎
• 流量進不來，不是你的內容差！資深工程師揭秘 WordPress 技術 SEO 三大支柱：速度、結構與程式碼
• functions.php 不是只能複製貼上！資深工程師解鎖 WordPress 主題的『大腦中樞』

如果你也認同這種「從根本解決問題」的理念，厭倦了不斷用外掛疊床架屋，希望為你的企業網站打造一個真正健壯、高效、且對搜尋引擎友善的數位基礎設施，那麼，你可能需要的不只是一個網頁設計師，而是一個懂技術、懂架構、懂 SEO 的技術夥伴。歡迎與浪花科技聯繫，讓我們聊聊如何為你的網站進行一場徹底的體質改造。