YouTube影片追蹤擴充功能概觀

注意

Adobe Experience Platform Launch在Adobe Experience Platform中已重新命名為一套資料收集技術。 因此,產品檔案中已推出數個術語變更。 有關術語更改的綜合參考,請參閱以下document

先決條件

Adobe Experience Platform中的每個標籤屬性都需要從「擴充功能」畫面安裝及設定下列擴充功能:

  • Adobe Analytics
  • Experience Cloud 訪客 ID 服務
  • 核心擴充功能

在影片播放器要呈現的每個網頁的HTML中,使用「使用<iframe>標籤"程式碼片段內嵌播放器」,此程式碼片段來自Google開發人員檔案。

此2.0.1版擴充功能可支援在單一網頁內嵌一或多部YouTube影片,方法是在iframe指令碼標籤中插入id屬性(值不可重複),並在src屬性值的結尾加上enablejsapi=1rel=0(若未包含)。 例如:

<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,無論enablejsapirel查詢字串參數是否存在,以及其預期值是否正確。 因此,可將YouTube指令碼標籤新增至具有或不具有id屬性的網頁,以及是否包含enablejsapirel查詢字串參數。

注意

在有多個視訊的頁面上,每個視訊使用該頁面所執行之標籤規則中設定的相同組態。 例如,若您建立的規則是要在影片播放到 50% 時觸發事件,頁面上的每部影片都會在 50% 的提示點觸發規則。

擴充功能需仰賴下列邏輯來重寫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),其連結名稱為「視訊開始」,後面接著「清除變數」動作。

秘訣

若實作中無法使用每個影片元素的多個eVar或prop,可在Platform中串連資料元素值,並以Classification Rule Builder工具將值剖析為分類報告(相關說明請參閱https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?lang=zh-Hant?lang=zh-Hant),接著在Analysis Workspace中以區段形式套用。

若要串連影片資訊的值,請建立名為「影片中繼資料」的新資料元素,並以程式導入所有影片資料元素 (如上所列),將所有資料元素彙整起來。例如:

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('|');

本頁內容