更新時間：2025年12月10日
如果你的網站嵌入了YouTube影片，希望了解使用者是否有播放影片、觀看到多少進度或是否完整看完影片，可以透過GA4進行追蹤。
目前主要有兩種做法：
- 使用GA4內建的「加強型評估」影片追蹤功能
- 使用GTM的「YouTube 影片觸發條件」
其中第一種設定最簡單，而第二種則擁有更高的彈性，可自訂事件名稱與事件參數。
追蹤前的必要條件
無論採用哪一種方法，都必須符合以下條件：
- 網站上的YouTube影片必須使用iframe內嵌方式
- YouTube iframe必須啟用JavaScript API，如影片網址需包含?enablejsapi=1，若未啟用JavaScript API，GA4與GTM都無法偵測影片播放行為。
方法一：使用GA4加強型評估中的「影片參與」
GA4內建的「影片參與」功能，不需要額外撰寫程式碼即可追蹤YouTube影片。
啟用後，GA4會自動收集以下事件：
| 事件名稱 | 說明 |
|---|---|
| video_start | 使用者開始播放影片 |
| video_progress | 觀看進度達到指定百分比，GA4會自動送出事件 |
| video_complete | 使用者完整觀看影片 |
這三個時間預設會附帶以下參數：
| 事件參數 | 說明 |
|---|---|
| video_current_time | 目前播放秒數 |
| video_duration | 影片總長度 |
| video_percent | 已觀看百分比 |
| video_provider | 影片平台（例如 YouTube） |
| video_title | 影片標題 |
| video_url | 影片網址 |
| visible | 影片是否位於可視範圍內 |
如何啟用影片參與功能
在 GA4中，點擊 「管理」————「資源設定」——「資料收集和修改」——「資料串流」，點擊要設定的網站串流，然後點擊「加強型評估」，只需要勾選它，就可以開啟：
開啟後仍沒有資料？
如果已啟用影片參與功能，但在GA4中看不到相關事件，可以依序確認：
- YouTube影片是否啟用JS API：最常見的原因就是 iframe 網址中沒有加入enablejsapi=1
- 是否受到資料閾值影響：當事件數量過少時，部分報表可能因隱私保護而不顯示資料
方法二：使用GTM的YouTube影片觸發條件
如果需要：
- 自訂事件名稱
- 自訂事件參數
- 自訂觀看進度
- 整合其他追蹤工具
建議使用GTM的YouTube影片觸發條件。
這項功能自2017年推出至今，仍是追蹤YouTube影片最常見的方法之一。
步驟 1：啟用影片相關內建變數
YouTube影片觸發器包含一些內建變數，需要將其開啟，在GTM中點擊「變數」—「內建變數」—「設定」，就可以看到：
各變數的說明如下：
| 變數名稱 | 說明 |
|---|---|
| Video Current Time | 目前播放秒數 |
| Video Duration | 影片總長度 |
| Video Percent | 觀看百分比 |
| Video Provider | 影片平台 |
| Video Status | 播放狀態 |
| Video Title | 影片標題 |
| Video URL | 影片網址 |
| Video Visible | 是否位於可視範圍內 |
這些GTM內建變數，其實就是GA4「影片參與」事件所使用的核心資料來源，因此如果未來想建立自訂事件或自訂維度，通常都會用到這些變數。
步驟 2：建立 YouTube 影片觸發條件
在GTM中點擊「觸發條件」—「新增」—「選擇一個觸發條件類型以開始設定」——「YouTube 影片」，命名為“YouTube 影片示範”，然後做如下設定：
- 擷取：这里是设定触发条件。
- 開始：當使用者開始播放影片時觸發。
- 完成：當影片播放完畢時觸發。
- 暫停、跳轉和緩衝處理：如果影片正在緩衝處理，或者是使用者暫停播放影片/移動影片的播放進度控制列，觸發條件就會啟動。
- 進度：可設定百分比或時間門檻：
- 百分比：這個值代表影片已播放長度所佔的百分比。用逗號分隔的清單輸入一或多個表示百分比的整數，例如 5、20、50、80 分別表示 5%、20%、50% 和 80%。
- 時間門檻：這個值代表影片已經播放的秒數。用逗號分隔的清單輸入一或多個表示時間門檻的整數，例如 5、15、60、120 分別表示 5 秒、15 秒、60 秒和 120 秒。
- 進階：
- 在所有 YouTube 影片中加入 JavaScript API 支援功能：一般不建议开启。如果Youtube影片的URL已經有enablejsapi=1，開啟後會導致影片刷新。
- 啟用這項觸發條件的時機：就是什么时候载入Youtube影片触发条件，通常維持預設值即可，不需要特別調整。
步驟 3：建立GA4事件代碼
最後就是設定代碼。
在GTM中點擊「代碼」—「新增」—「請選擇代碼類型以開始設定…」——「Google Analytics（分析）：GA4 事件」，命名為“Youtube 影片追踪”，做如下設定：
事件名稱定義為“youtube_video_tracking”，同時設定事件參數video_provider和video_url，其他內建變數也都可以設定會事件參數。
步驟 4：使用GTM預覽模式進行測試
設定完成後，在GTM中點擊預覽進行調試，確認：
- 觸發條件是否正常觸發
- 事件參數是否正確帶入
- GA4事件是否成功送出
步驟 5：註冊自訂維度
如果希望在 GA4 報表中分析影片資料，需要將自訂參數註冊為自訂維度。
以video_provider為例，在GA4中點擊「管理」——「資源設定」——「資料顯示」——「自訂定義」——「新建自訂維度」，然後做如下設定：
總結
GA4追蹤YouTube影片主要有兩種方式：
- GA4 加強型評估：設定簡單，適合快速部署。
- GTM YouTube影片觸發條件：彈性較高，可自訂事件名稱、參數與觀看門檻。
如果只是想知道影片播放與觀看進度，直接使用GA4加強型評估即可；若需要更進階的分析、建立轉換事件或串接其他工具，則建議使用GTM建立自訂影片追蹤機制。
如果要對VImeo影片做追蹤，延伸閱讀：Google Tag Manager上對Vimeo影片做追蹤(GA4)
