適用於Brightcove Player的Google跟踪代碼管理器插件

概覽

Google 的跟踪代碼管理器 (GTM) 允許您跟踪您的網站、視頻內容和移動應用程序的使用情況。首先，您將一個容器標籤添加到您的資產中。然後，您使用基於 Web 的用戶界面根據您的業務規則自定義與您的容器標籤相關聯的各個標籤。

以下是一些標籤示例：

• 谷歌分析通用跟踪代碼
• Adwords 再營銷和/或轉化跟踪代碼
• 自定義 HTML 腳本

如果您是 GTM 的新手，請查看 Google 的跟踪代碼管理器概覽文檔。

如果您已經在使用 Google Analytics、Adwords 和 DoubleClick，您可能還想使用 Google Tag Manager，因為它與這些工具集成得很好。GTM提供了大量的變量和触發器選項。

主要實施步驟

從較高的層次來看，以下是實施和使用 GTM 必須遵循的主要步驟：

1. 創建一個 GTM 帳戶並設置一個容器——這些都是初始 GTM 設置的一部分
2. 複製並粘貼需要在您的網頁上實施的容器片段。Google 建議將這段代碼放在<頭>標記或在打開後立即<正文>標籤。
3. 創建標籤 - 適用於 Google Analytics 或 Brightcove Player
4. 發布您的標籤。

有關設置的詳細信息，請參閱 Google 的設置和安裝跟踪代碼管理器文檔。

使用 Brightcove Player

Brightcove 的 GTM 插件使您能夠使用 Google Analytics 儀表板跟踪 Brightcove Player 事件。可以跟踪以下玩家事件：

• 播放器負載
• 影片曝光
• 影片觀看
• 視訊參與
• 播放要求
• 影片完成
• 廣告開始、廣告結束等高級播放器事件
• 破壞播放體驗的錯誤

需求

使用 GTM 插件需要滿足以下要求：

• Brightcove Player v6.46.0 或更高版本

入門

要設置Google跟踪代碼管理器，請按以下步驟操作：

步驟

1. 在標籤管理器，創建一個帳戶或使用現有帳戶。要創建新帳戶，請單擊創建賬戶按鈕。

   默認情況下，將為新帳戶創建一個新容器。您可以在每個帳戶中創建其他容器。

   

2. 輸入新帳戶頁面的值，包括帳戶名稱和容器名稱，並選擇一個目標平台。

   

3. 點擊創造按鈕。
4. 同意服務條款。
5. 這安裝谷歌標籤管理器對話框出現。從這裡您需要復製片段並將它們放在指定的位置。

   

6. 如果您需要返回到代碼片段，請單擊 GTM 儀表板中的容器 ID。

   

查看事件和維度

從 Brightcove Player 選擇要跟踪的事件和維度。

活動

Brightcove 玩家使用的任何事件名稱analytics-beacon可以使用事件，但以下在 GTM 插件中有特殊處理。

尺寸

將針對所有事件發送以下維度（錯誤除外）

特定於事件的維度

這些自定義維度將在特定事件中發送。

創建變量，標籤和触發器

您要跟踪的每個 Brightcove 事件都必須在 Google 標籤管理器 (GTM) 中創建為事件標籤。來自 GTM 的事件 ID 將在玩家模塊中使用。這允許將 Brightcove 事件數據傳遞給 GTM 事件。

對於每個事件標籤，您需要創建一個 GTM 觸發器以將事件發送到 Google Analytics。然後，在 GTM 變量選項卡，您將創建與每個事件關聯的自定義參數。

將變量添加到GTM

Brightcove 參數攜帶附加數據並與事件一起傳遞。必須在Google跟踪代碼管理器中將每個將要記錄的Brightcove參數創建為變量。參數名稱將在播放器內部使用，從而允許將 Brightcove 參數傳遞給 Google 跟踪代碼管理器變量。

要在Google跟踪代碼管理器中創建變量，請按照以下步驟操作

1. 登錄到您的Google跟踪代碼管理器帳戶

2. 點擊變量在左側導航中。

3. 在裡面用戶定義的變量部分，單擊新的按鈕。

   

4. 為了變量類型， 選擇數據層變量 .

   

5. 這些是配置細節：

   • 數據層變量名稱 -變量名
   • 數據層版本 - 版本 2

6. 首先，創建三個用戶定義的變量；事件動作 , 活動類別， 和事件標籤 .配置應類似於此。

   • 事件動作 - 事件動作
   • 活動類別 - 事件類別
   • 事件標籤 - 事件標籤

   

7. 然後創建反映 Brightcove 參數所需的變量。在這種情況下，名稱數據層變量應該匹配播放器的 JSON 配置中的內容跟踪參數後自定義維度在 GTM 變量中。這是一個例子：

   

8. 您可以創建為 GTM 變量的 Brightcove 參數：

   • 帳戶 - Brightcove 賬戶 ID
   • 播放器 -玩家編號
   • 選手姓名 - 選手姓名
   • 平台版本 -平台版本號
   • 屆會 -會話標識符
   • 視頻 -影片ID
   • 影片名稱 -影片名稱
   • 範圍 -以StartSecond..EndSecond格式查看的秒數範圍
   • 觀看視頻秒數 -觀看秒數
   • 視頻時長 -視頻的持續時間（以秒為單位）
   • 觀看視頻百分比 -觀看視頻的百分比
   • 錯誤代碼 -與事件相關的平台特定的錯誤代碼
   • 視頻里程碑 -視頻完成的里程碑（25％，50％，75％，100％）
   • 影片播放頭 -視頻中觸發事件的時間
   • 目的地 -發起事件的URI

9. 您的用戶定義變量在GTM中應類似於此：

   

將標籤添加到GTM

確定要跟踪的事件後，必須在Google跟踪代碼管理器中創建代碼。

要在Google跟踪代碼管理器中創建代碼，請按照以下步驟操作

1. 登錄到您的Google跟踪代碼管理器帳戶

2. 點擊標籤在左側導航中，然後單擊新的按鈕。

3. 選擇標籤類型如谷歌分析：通用分析。

   

4. 輸入標籤詳細信息：

   • 軌道類型 - 設置事件
   • 類別 -事件類別變量
   • 行動 -事件動作變量
   • 標籤 -事件標籤變量
   • 值 -無
   • 非互動命中 - 設置真正
   • Google Analytics（分析）設置 - 默認設置
   • 跟踪號碼 -GA信息中心的跟踪ID。選擇“跟踪ID變量”。

5. 轉到高級設置，然後設置相關的自定義尺寸索引和尺寸值。這些索引應與 Google Analytics 中的內容相匹配。

6. 您的代碼在GTM中看起來應該與此類似：

   

向GTM添加觸發器

對於每個要跟踪的事件，您還需要Google跟踪代碼管理器中的觸發器。

要在Google跟踪代碼管理器中創建觸發器，請按照以下步驟操作

1. 登錄到您的Google跟踪代碼管理器帳戶

2. 點擊觸發器在左側導航中，然後單擊新的按鈕。

3. 選擇觸發類型如自訂活動。

   

4. 輸入事件名稱；事件名稱應類似於下圖。

   

5. 為要跟踪的每個事件創建一個觸發器。

6. 您的觸發器應在GTM中看起來與此類似：

   

與Brightcove集成

要將GTM與Brightcove Player集成，請將Google跟踪代碼管理器插件添加到播放器中。

使用工作室

使用視頻雲工作室加載插件下面的步驟細節。

1. 在視頻雲工作室，打開播放器模塊，並創建一個新的播放器或找到你想添加插件的播放器。
2. 按一下播放程式的連結以開啟播放程式的屬性。
3. 按一下左側導覽選單中的外掛程式。

4. 接下來，單擊添加插件按鈕，然後選擇Brightcove 插件 .

   

5. 展開Brightcove插件下拉菜單並選擇Google跟踪代碼管理器。

   

6. 要告訴播放器您要跟踪哪些事件和自定義維度，請創建一個JSON對像以粘貼到選項（JSON）文本框。

   欄位說明：

   • tracker -您的Google跟踪代碼管理器跟踪ID（GTM-XXXXXXX）
   • eventsToTrack -您要追踪的活動
   • paramsToTrack -您要跟踪的自定義尺寸
   • milestones - 一個整數數組，用於從默認值 25、50、75、100% 更改里程碑。當然，這僅適用於bcvideo_video_milestone正在被跟踪。

   這是一個例子：

    { 
     "tracker":"your Google Tag Manager id", 
     "eventsToTrack": {
       "ad_end": "Ad End",
       "ad_start": "Ad Start",
       "error": "Error",
       "play_request": "Play Request",
       "player_load": "Player Load",
       "video_complete": "Video Complete",
       "video_engagement": "Video Engagement", "video_impression": "Video Impression", "video_view": "Video View"
     },
     "paramsToTrack": {
       "bcvideo_video_duration": "duration",
       "bcvideo_error_code": "error",
       "bcvideo_account": "account",
       "bcvideo_session": "session",
       "bcvideo_video_milestone": "milestone", "bcvideo_video_name": "video_name",
       "bcvideo_range": "range",
       "bcvideo_video_seconds_viewed": "seconds_viewed", "bcvideo_player_name": "player_name",
       "bcvideo_video_percent_viewed": "percent_viewed", "bcvideo_destination": "destination",
       "bcvideo_video_playhead": "playhead"
     }
    
    }

7. 按一下「儲存」按鈕。您現在將看到Google跟踪代碼管理器插件已添加到播放器的插件列表中。

   

8. 若要發佈播放程式，請選取 [ 發佈和嵌入 > 發佈變更 ]。
9. 要關閉對話框，請單擊關閉 .

10. 返回到媒體模塊並使用您剛剛為 Google 跟踪代碼管理器更新的播放器發布您的視頻或播放列表。

    當您的播放器加載並且用戶與播放器交互時，將跟踪指定的事件和參數。

創建自定義尺寸

自定義維度是您在Google Analytics（分析）中創建的指標。添加自定義維度有兩種方式，一種是直接在Google Analytics中添加維度，另一種是使用Google Scripts。

使用 Google Analytics 添加自定義維度

要直接在 Google Analytics 中添加自定義維度，請執行以下步驟：

1. 登錄谷歌分析。

2. 點擊行政 .

   

3. 點擊自定義定義展開它，然後選擇自定義尺寸。

   

4. 點擊新建自定義維度按鈕。

   

5. 輸入自定義維度名稱然後點擊創造 .Google Analytics 會自動分配一個索引號。您需要為要跟踪的每個參數創建一個自定義維度。

   

使用 Google App Script 添加自定義維度

要使用 Google App 腳本創建自定義維度，請執行以下步驟：

1. 如果您不熟悉自定義維度，請查看 Google 的自定義維度和指標文檔。
2. 登錄到Google。

3. 導航到G Suite開發人員中心並選擇Apps Script新的空白項目。

   

4. 選擇無標題項目並給您的項目起個名字。

   

5. 將以下定制應用程序腳本代碼複製到編輯器，並更新以下值：

   • accountId -您的Google Analytics（分析）帳戶ID
   • webPropertyId -您的Google帳戶跟踪ID
   • dimensions -要添加的自定義尺寸。當前列表包含所有自定義維度。請注意，尺寸以開頭bcvideo_。這是為了確保與這些變量沒有命名衝突。

    //Set values for GA Account ID and web property ID to which you have to set custom dimensions.
    var accountId='your account id'; var webPropertyId='your tracking code'; 
    //Add required custom dimensions to be created to this list 
    var dimensions=['bcvideo_video_seconds_viewed','bcvideo_video_playhead','bcvideo_account','bcvideo_player','bcvideo_player_name','bcvideo_video','bcvideo_video_name','bcvideo_session','bcvideo_platform_version','bcvideo_range','bcvideo_video_duration', 'bcvideo_video_percent_viewed','bcvideo_error_code','bcvideo_milestone','bcvideo_destination']; 
    //Function to create custom dimensions in GA 
    function createGACustomDimensions() {
    //This loop iterates through the custom dimensions in order to set the custom dimension scope, active values into our GA property 
    for(var index=0;index<dimensions.length;index++){ 
     var customDimensions ={
       'name': dimensions[index],
       'scope':'HIT',
       'active':true,
    }
    //This create a request to the new custom dimension Analytics.Management.CustomDimensions.insert(customDimensions,accountId,webPropertyId); 
    // Pause for 1 second between adding each custom dimension, this ensure that the GA property has time 
    // to process the request fully before moving to the next custom dimension.
    Utilities.sleep(1000)
    }
    }

6. 更換function myFunction(){}代碼塊（如下所示）以及您的自定義應用腳本。

    function myFunction() { }

7. 保存項目。您需要保存項目才能使用Google Analytics（分析）API。

8. 要啟用Google Analytics（分析）API，請在腳本編輯器中選擇資源資源 > 進階Google服務。

   

9. 然後找到進階Google服務，然後將其打開上。按一下「確定」。

   

10. 要運行您的應用腳本，請單擊跑步 > 運行功能，然後選擇您的腳本。

    

11. 在授權對話框中，單擊查看權限 .

    

12. 點擊允許按鈕。

    

查看自定義尺寸

要在Google Analytics（分析）中查看自定義維度，請按照以下步驟操作：

1. 登錄谷歌分析。

2. 點擊行政

   

3. 點擊自定義定義展開它，然後選擇自定義尺寸。

   

4. 您應該看到自定義維度及其關聯的索引。