YouTube影片追蹤擴充功能概觀

上次更新： 2023-05-25
  • 主題：
  • Tags
    檢視有關此主題的更多資訊
  • 建立對象：
  • Developer
    User
    Admin
    Leader
注意

Adobe Experience Platform Launch已經過品牌重塑，現在是Adobe Experience Platform中的一套資料收集技術。 因此，所有產品文件中出現了幾項術語變更。 如需術語變更的彙整參考資料，請參閱以下文件。

先決條件

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 是否包含查詢字串引數。

注意

在含有多個視訊的頁面上，每個視訊都使用在該頁面上執行的標籤規則中設定的相同設定。 例如，若您建立的規則是要在影片播放到 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中串連資料元素值，並使用「分類規則產生器」工具剖析為分類報表，如中所述 https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?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('|');
上一頁
Next page

此頁面上的