在文章裡嵌一支 YouTube 影片，理論上能讓內容更豐富、停留時間更長，但很多 WordPress 站長都遇過同一件事：影片明明放上去了，Google 搜尋結果卻完全看不到那支影片的縮圖，連帶頁面也沒拿到「影片」分頁的版位。問題通常不在影片本身，而在於 Google 根本不知道那塊嵌入區域裡有一支值得收錄的影片。
影片 SEO 要解決的就是這件事：讓搜尋引擎找得到、看得懂、也願意把你的影片放進搜尋結果。而其中最關鍵的技術環節，就是替頁面加上 VideoObject 結構化資料。這篇會把焦點放在 WordPress 嵌入影片的實際情境，從「Google 怎麼判讀一支影片」一路講到 schema 欄位該怎麼填、在 WordPress 裡實際從哪裡加，以及影片沒被收錄時該怎麼排查。
影片 SEO 是什麼，跟 YouTube SEO 哪裡不一樣
影片 SEO 指的是讓影片在 Google 搜尋（網頁搜尋、影片分頁、圖片分頁，甚至 Google Discover）拿到曝光的最佳化工作，跟 YouTube 站內排名是兩套完全不同的邏輯。很多人搜「影片 SEO」查到的全是 YouTube 教學，結果套到自己的 WordPress 網站上完全沒效，原因就在這裡。
YouTube SEO 的戰場在 YouTube App 與 YouTube 站內搜尋，演算法吃的是觀看時長、點擊率、互動率這些站內訊號。Google 影片 SEO 的戰場則是 Google 搜尋結果頁，它在意的是「影片嵌在哪個頁面、那個頁面有沒有足夠的文字脈絡可以說明這支影片在講什麼」。
對 WordPress 與 WooCommerce 站來說，後者才是重點。你的目的不是讓影片在 YouTube 多幾次播放，而是讓搜尋的人從 Google 點進你自己的網站。所以同一支影片，你既可以放在 YouTube 衝站內流量，也應該透過嵌入頁面的結構化資料，去爭取 Google 搜尋結果的影片版位。
Google 是怎麼收錄一支嵌入網頁的影片
Google 看待影片時，看的不是孤立的影片檔，而是「影片加上影片所在的頁面」這個組合體。換句話說，一段嵌入碼丟在空白頁面上，Google 幾乎無從理解它的內容；要被好好收錄，影片周圍必須有對應的文字。
整個收錄流程可以拆成三步。第一步是檢索，搜尋引擎透過 sitemap、結構化資料或頁面上的嵌入元素，發現這裡有一支影片。第二步是建立索引，Google 分析標題、描述、縮圖與頁面文字，判斷這支影片在講什麼。第三步才是排名，依相關性與頁面權重決定它出現在哪。
這裡有一個 WordPress 站長常忽略的細節：當你嵌入的是 YouTube 影片，Google 通常會建立兩筆索引資料，一筆屬於 YouTube 那一端，一筆屬於你網站的這個頁面。你要爭取的是後者，也就是讓「點進去會連回你網站」的那筆版位出現。這也是為什麼只把影片丟上 YouTube、不在自己頁面做任何脈絡與標記，等於把流量整碗讓給 YouTube。
要讓收錄順利，有幾個前置條件得先滿足。影片所在的觀賞頁面本身必須可被索引，不能被 robots.txt 擋掉、不能掛 noindex；影片也不能藏在頁面很下方、側邊欄，或折疊收合的區塊裡，否則 Google 可能不把它當成頁面的主要元素。Google 文件也明確要求，要套用影片功能，影片總長度至少要有 30 秒。
VideoObject schema 必填與建議欄位有哪些
VideoObject 是 schema.org 定義、用來描述影片內容的結構化資料類型，Google 建議用 JSON-LD 格式撰寫。它的作用是用搜尋引擎讀得懂的語言，把影片的標題、描述、縮圖、上傳日期等資訊明白地告訴 Google，沒有它，頁面就拿不到帶縮圖與時長的影片複合式搜尋結果。
Google 對 VideoObject 列出的必填欄位有三個，外加一組二擇一：
- name：影片標題，建議跟頁面上看得到的標題一致。
- thumbnailUrl：指向影片縮圖圖檔的網址，可以給多種比例（1:1、4:3、16:9）。
- uploadDate：影片首次發布的日期時間，必須是 ISO 8601 格式，建議帶上時區。
- contentUrl 或 embedUrl 至少要有一個:contentUrl 指向影片檔本身的位元組（例如 mp4 檔網址），embedUrl 指向可嵌入的播放器網址。少了這兩者其中之一，Google 就無法顯示影片複合式結果。
另外有兩個欄位 Google 列為建議、但實務上幾乎是必備：description（影片描述，要跟頁面描述用不同文字）與 duration（影片長度，同樣是 ISO 8601 格式，例如 PT1M54S 表示 1 分 54 秒）。
兩個格式細節最容易讓 WordPress 使用者卡關。uploadDate 不能隨手寫「2024/3/31」，要寫成像 2024-03-31T08:00:00+08:00 這樣帶時區的 ISO 8601 格式；duration 也不是「3 分鐘」，而是 PT3M 這種以 PT 開頭的時間長度寫法。格式錯了，複合式搜尋結果測試會直接報錯。
除了基本的 VideoObject，還有三個進階類型可以視情況加上去：
章節時間軸
Action
關鍵時刻
Event
直播 LIVE 標記
Clip 用來標記影片裡的重要段落，讓搜尋結果直接顯示可點擊的章節；SeekToAction 是告訴 Google 你的影片網址怎麼用時間參數深連結，讓它自動產生「關鍵時刻」；BroadcastEvent 則專供直播使用，能讓縮圖掛上 LIVE 標記。要特別提醒的是，LIVE 標記只限真正的直播，一般影片不能用，而且直播因為有時效性，除了結構化資料外還得搭配 Indexing API 通知 Google 即時檢索。
WordPress 要怎麼幫嵌入影片加上 VideoObject schema
WordPress 上要替嵌入影片加 VideoObject schema，主要有兩條路：用支援影片 schema 的 SEO 外掛，或自己用 JSON-LD 程式碼手動掛。選哪一條，取決於你願不願意碰程式碼，以及影片數量多不多。
外掛路線最省事。市面上的 SEO 外掛中，Yoast 的影片 SEO 模組、Rank Math、All in One SEO 的進階方案，都能自動偵測頁面裡的影片嵌入並輸出 VideoObject 結構化資料；也有專門的 Video Schema 外掛會透過 YouTube Data API 抓回影片的標題、縮圖、長度等中繼資料，自動幫你組好 schema。要留意的是，這類自動產生 schema 與影片 sitemap 的功能，多半落在外掛的付費方案裡，免費版通常不含。
如果你只有少數幾篇文章要做、或想完全掌控輸出內容，手動掛 JSON-LD 也不難。做法是把一段 <script type="application/ld+json"> 的 VideoObject 程式碼，放進文章對應的頁面 <head> 或內文裡。最乾淨的方式是在佈景主題的 functions.php 裡用 wp_head 這個 hook，依條件（例如某個分類、某個自訂欄位有填影片網址）動態輸出對應的 JSON-LD，這樣同一套程式碼能服務整批文章，不必每篇手刻。
不論走哪條路，有三個重點不能省。第一、name 與 description 要用獨特、貼合影片內容的文字，不要直接複製頁面標題充數。第二、thumbnailUrl 要指向真實存在、可被 Google 抓取的縮圖圖檔。第三、嵌入區塊周圍一定要有相關的文字段落，描述這支影片在講什麼。前面說過，Google 是把影片跟頁面文字當成一個組合體在理解，光有 schema、頁面卻是一片空白，收錄效果會大打折扣。
有些站長會想用 Google 代碼管理工具（GTM）動態注入 schema，這在電商平台無法改原始碼時是可行的暫時手段，但 GTM 執行自訂 HTML 會拖慢頁面，長期還是建議從佈景主題或外掛端正規地輸出。
寫完 schema 後，務必拿 Google 的複合式搜尋結果測試工具驗證一次，把所有重大錯誤修掉，再用 Search Console 的網址審查工具看 Google 實際怎麼讀這個頁面。
影片 sitemap 跟結構化資料分別解決什麼問題
影片 sitemap 與 VideoObject 結構化資料常被混為一談，但兩者解決的是不同的問題，理想狀況是兩個都做。簡單區分：sitemap 告訴 Google「影片在哪裡」，schema 告訴 Google「這支影片是什麼」。
影片 sitemap 的作用是輔助搜尋引擎發現並索引頁面裡的影片，它會列出影片的標題、描述、縮圖網址與觀賞頁面位置，等於遞給 Google 一份明確的影片清單，加快被找到的速度。結構化資料則是在頁面內部，補充影片的脈絡細節，例如摘要、長度、是否為直播，幫搜尋引擎理解影片內容。
對 WordPress 來說，現實是一般免費 SEO 外掛不會自動產生影片 sitemap，要靠付費方案才有。如果暫時沒有影片 sitemap，也不必太焦慮，因為只要結構化資料做好、頁面文字脈絡充足，Google 仍有機會透過頁面內容找到並理解你的影片。Google 文件也提到，如果它判斷頁面文字比 sitemap 裡的資訊更實用，會優先採用頁面上的文字。
順序上的建議是：先把 VideoObject 結構化資料與影片周邊文字做扎實，這是基本盤；行有餘力，再透過付費外掛補上影片 sitemap，讓收錄速度與覆蓋率更完整。
影片沒被收錄時，要從 Search Console 哪裡排查
當影片遲遲拿不到搜尋版位，第一個該打開的是 Google Search Console 的影片索引報表，它會列出網站影片在 Google 資料庫裡的狀態，哪些已收錄、哪些有問題、問題出在哪，都看得到。依報表指出的方向修，再請 Google 重新檢索，是最有效率的排查路徑。
排查時可以照這個順序往下檢查：
- 觀賞頁面有沒有被索引：影片要被收錄的前提是它所在的頁面本身已進索引。如果頁面都還沒被收，影片自然不會出現，先確認頁面沒有掛 noindex、沒被 robots.txt 擋。
- Google 抓不抓得到影片檔與縮圖:contentUrl 指向的影片檔、thumbnailUrl 指向的縮圖，都要能被 Googlebot 存取，被擋住就無法處理。
- 結構化資料有沒有錯：用複合式搜尋結果測試與 Search Console 的複合式結果報表，確認 VideoObject 沒有報必填欄位缺漏或格式錯誤，ISO 8601 的日期與長度格式是最常見的出錯點。
- 影片在頁面的位置：影片若埋在頁面很下方或折疊區塊，Google 可能不把它當主要元素，試著移到頁面上方明顯處。
- 同頁是否塞了多支影片：一個頁面建議只放一支主要影片，否則 Google 不確定該收錄哪一支。
要有耐心。從部署結構化資料到影片出現在搜尋結果的影片輪播，通常需要好幾天到約兩週不等，Google 也明說發布新頁面後可能要數天才會被找到並檢索。修正後別急著反覆改，給它一點重新檢索的時間。
WooCommerce 商品影片要注意哪些收錄重點
WooCommerce 商品頁的影片邏輯，跟一般文章其實大同小異，差別在於影片的角色更直接綁著轉換。如果你替個別商品拍了介紹或使用示範影片，建議把它嵌在商品頁內容的最上方，而不是埋在規格表下面。
位置之所以重要，除了符合「影片要放在明顯處才好被當主要元素」的原則，也牽涉到使用者行為。電商實務上常見的觀察是，看過商品影片的訪客轉換意願明顯高於沒看的；而當一個頁面有多支影片時，最先出現的那支互動最多。所以一頁主打一支、放在上方，對收錄與轉換都有利。
技術面上，多數電商平台與佈景主題預設不會替嵌入的 YouTube 影片產生 VideoObject 結構化資料，你可以先用複合式搜尋結果測試檢查現況。若平台不支援，做法跟前面一樣：透過支援的 SEO 外掛，或在商品頁模板裡用程式碼掛上 VideoObject，並在商品描述裡寫清楚影片內容，讓 Google 把影片與商品脈絡連起來。涉及商品收款的部分，這裡不展開，重點仍回到讓影片被搜尋引擎正確理解。
從嵌入到被搜到，該怎麼把這套流程跑順
影片要被 Google 收錄，核心觀念只有一句：讓搜尋引擎把「影片」和「它所在的頁面」當成一個能被理解的整體。嵌入碼只是把影片放上去，真正讓它被找到、被看懂、拿到搜尋版位的，是 VideoObject 結構化資料、影片周邊的文字脈絡，以及（行有餘力時）影片 sitemap 這三件事的疊加。
接下來可以這樣動手：先挑一篇已經嵌了影片的重點文章或商品頁，補上完整的 VideoObject schema 與影片描述文字，用複合式搜尋結果測試驗過沒錯，再到 Search Console 用網址審查請 Google 重新檢索。跑通一篇、確認它進了影片索引報表，再把同一套流程複製到其他頁面。先把一支影片做對，比一次替全站亂掛 schema 更可靠。