YouTube影片追蹤擴充功能概觀
先決條件
Adobe Experience Platform中的每個標籤屬性都需要從「擴充功能」畫面安裝及設定下列擴充功能：
- Adobe Analytics
- Experience Cloud 訪客 ID 服務
- 核心擴充功能
使用 "使用\內嵌播放器<iframe> 標籤」 每個影片播放器預計運行的網頁HTML中，Google開發人員檔案的程式碼片段。
此2.0.1版擴充功能可透過插入「 」，支援在單一網頁內嵌一或多部YouTube影片。 id 在iframe指令碼標籤中具有唯一值的屬性，並附加 enablejsapi=1 和 rel=0 到結尾 src 屬性值（如果尚未包含）。 例如：
<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
此擴充功能也設計為可動態檢查唯一的ID屬性值，例如 player1，不論 enablejsapi 和 rel 查詢字串引數存在，且預期值是否正確。 因此，無論是否有，都可以將YouTube指令碼標籤新增至網頁。 id 屬性以及是否 enablejsapi 和 rel 是否包含查詢字串引數。
擴充功能需仰賴下列邏輯來重寫iFrame：
document.onreadystatechange = function () {
if (document.readyState === 'complete') {
因此，頁面載入後會有稍微閃爍的現象。 這是預期中的正常行為。
資料元素
擴充功能中有6個可用的資料元素，且皆無需設定。
- 播放點位置： 在標籤規則呼叫時，記錄影片時間軸上的播放點位置（以秒為單位）。
- 影片 ID： 指定與影片相關聯的 YouTube ID。
- 影片名稱： 指定描述影片的名稱或易記名稱。
- 影片 URL： 傳回目前所載入/播放影片的 YouTube.com URL。
- 影片長度： 記錄影片內容長度 (以秒為單位)。
- 擴充功能版本： 此資料元素會記錄YouTube追蹤擴充功能版本，例如「Video Tracking_YouTube_2.0.0」。
事件
擴充功能提供 8 種事件，其中只有「自訂提示點追蹤」需要設定。
- 影片就緒： 影片收到提示並準備播放時觸發此事件。
- 影片開始： 影片首次開始播放及
player.getCurrentTime() === 0時觸發此事件。 - 影片重播： 系統提示播放影片時觸發此事件，並在首次播放後重播。每次重播都會觸發此事件。
- 影片暫停： 影片暫停播放時觸發此事件。
- 影片繼續： 影片繼續播放及
player.getCurrentTime() !== 0時觸發此事件。 - 自訂提示追蹤： 影片播放到指定的臨界值百分比時觸發。 例如，如果影片長度為60秒，而指定的提示點為50%，則播放點位置等於30秒時會觸發此事件。 「提示點追蹤」適用於首次播放和重播。請注意，如果使用者在提示點之間隨機搜尋片段，事件不會觸發。 唯有當播放點越過時間軸上計算的提示點位置，且視訊播放器正在播放時，才會觸發提示點事件。
- 影片緩衝： 播放器開始播放影片前下載特定數量的資料時，就會觸發此事件。
- 影片結束： 影片播放完畢時觸發此事件。
使用方式
您可以為每個視訊事件（即上方列出的七個事件）設定一個標籤規則。 為每個您要追蹤的事件建立特定的標籤規則。 如果您不想追蹤事件，只需省略以為其建立規則即可。
規則包含三個動作：
- 設定變數： 設定 Adobe Analytics 變數 (對應至所有或部分包含的資料元素)。
- 傳送信標： 以自訂連結追蹤呼叫的形式傳送Adobe Analytics信標，並提供「連結名稱」的值。
- 清除變數： 清除 Adobe Analytics 變數。
「影片開始」的標籤規則範例
需包括以下影片擴充功能物件。
-
活動：「影片開始」(此事件會在訪客開始播放YouTube影片時觸發規則)。
-
條件：無
-
動作：使用 Analytics擴充功能 若要「設定變數」動作，則對應：
- 視訊開始事件，
- 「影片長度」資料元素的 prop/eVar
- 「影片 ID」資料元素的 prop/eVar
- 「影片名稱」資料元素的 prop/eVar
- 「影片 URL」資料元素的 prop/eVar
接著，加入「傳送信標」動作(
s.tl)搭配「視訊開始」的連結，接著進行「清除變數」動作。
若要串連視訊資訊值，請建立名為「視訊中繼資料」的新資料元素，並將其設定為提取所有視訊資料元素（如上所列），接著將其彙整起來。 例如：
var r = [];
r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));
return r.join('|');
如需如何在Platform內有效建立及運用資料元素的詳細資訊，請參閱 資料元素 檔案。