舊版 - Media SDK 設定概觀 setup-overview

當您為視訊應用程式或播放器下載 Media SDK 後,請依照本章節中的資訊設定和實作 Media SDK。

一般實作指引 general-implementation-guidelines

使用串流媒體收集附加元件進行追蹤時,會使用三個主要的SDK元件:

  • 媒體心率設定 - MediaHeartbeatConfig 包含報表的基本設定。
  • 媒體心率代理人 - MediaHeartbeatDelegate 可控制播放時間和 QoS 物件。
  • 媒體心率 - MediaHeartbeat 是包含成員與方法的主要程式庫。

實作 Streaming Media SDK

若要設定和使用 Streaming Media SDK,請完成以下實作步驟:

  1. 建立 MediaHeartbeatConfig 例項並設定您的設定參數值。

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center
    變數名稱 說明 必填 預設值
    trackingServer 適用於媒體分析的追蹤伺服器。這與您的分析追蹤伺服器不同。 空字串
    channel 頻道名稱 空字串
    ovp 線上媒體平台的名稱,透過它分送內容 空字串
    appVersion 媒體播放器應用程式/SDK 的版本 空字串
    playerName 使用的媒體播放器名稱,例如「AVPlayer」、「HTML5 播放器」、「我的自訂播放器」 空字串
    ssl 指出是否應透過 HTTPS 進行呼叫 false
    debugLogging 指出是否已啟用除錯記錄 false
  2. 實作 MediaHeartbeatDelegate

    table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center
    方法名稱 說明 必填
    getQoSObject() 傳回包含目前 QoS 資訊的 MediaObject 例項。將在播放工作階段期間呼叫此方法多次。播放器實作必須一律傳回最新可用的 QoS 資料。
    getCurrentPlaybackTime() 傳回播放點的目前位置。
    對於 VOD 追蹤,此值是從媒體項目的開頭開始以秒為單位指定的。
    對於直播串流,如果播放器未提供內容持續時間的相關資訊,則此值可以指定為自當天 UTC 午夜開始的秒數。
    注意:使用進度標記時,需要內容持續時間,並且播放點需要更新為從媒體項目開始的秒數,從 0 開始。
    note tip
    TIP
    服務品質 (QoS) 物件為選用。若 QoS 資料可供您的播放器使用,且您希望追蹤該資料,則需要下列變數:
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    變數名稱 說明 必填
    bitrate 媒體的位元速率 (以每秒位元組數為單位)。
    startupTime 媒體的啟動時間 (以毫秒為單位)
    fps 每秒顯示的畫面。
    droppedFrames 目前掉格的數量。
  3. 建立 MediaHeartbeat 例項。

    使用 MediaHertbeatConfigMediaHertbeatDelegate 來建立 MediaHeartbeat 例項。

    note important
    IMPORTANT
    請確保您的 MediaHeartbeat 例項可供存取,並且不會在工作階段結束前遭到取消配置。此例項將用於下列所有媒體追蹤事件。
    note tip
    TIP
    MediaHeartbeat 需要 AppMeasurement 的例項,才能傳送呼叫至 Adobe Analytics。
  4. 組合所有片段。

    以下範例程式碼將 JavaScript 2.x SDK 用於 HTML5 視訊播放器:

    code language-javascript
    // Create local references to the heartbeat classes
    var MediaHeartbeat = ADB.va.MediaHeartbeat;
    var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
    var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;
    
    //Media Heartbeat Config
    var mediaConfig = new MediaHeartbeatConfig();
    mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
    mediaConfig.playerName = "HTML5 Basic";
    mediaConfig.channel = "Video Channel";
    mediaConfig.debugLogging = true;
    mediaConfig.appVersion = "2.0";
    mediaConfig.ssl = false;
    mediaConfig.ovp = "";
    
    // Media Heartbeat Delegate
    var mediaDelegate = new MediaHeartbeatDelegate();
    
    // Set mediaDelegate CurrentPlaybackTime
    mediaDelegate.getCurrentPlaybackTime = function() {
        return video.currentTime;
    };
    
    // Set mediaDelegate QoSObject - OPTIONAL
    mediaDelegate.getQoSObject = function() {
        return MediaHeartbeat.createQoSObject(video.bitrate,
                                              video.startuptime,
                                              video.fps,
                                              video.droppedframes);
    }
    // Create mediaHeartbeat instance
    this.mediaHeartbeat =
      new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
    

驗證 validate

Media Analytics 追蹤實作會產生兩種類型的追蹤呼叫:

  • 媒體和廣告開始呼叫會直接傳送到 Adobe Analytics (AppMeasurement) 伺服器。

  • 心率呼叫會傳送到 Media Analytics (心率) 追蹤伺服器並於該位置處理,然後再傳遞到 Adobe Analytics 伺服器。

  • Adobe Analytics (AppMeasurement) 伺服器
    如需有關追蹤伺服器選項的詳細資訊,請參閱正確填入 trackingServer 和 trackingServerSecure 變數

    note important
    IMPORTANT
    Experience Cloud 訪客 ID 服務需要 RDC 追蹤伺服器,或 CNAME 解析至 RDC 伺服器。

    分析追蹤伺服器的結尾應該是「.sc.omtrdc.net」或應該是 CNAME。

  • ​ Media Analytics (心率) 伺服器
    此格式一律為「[your_namespace].hb.omtrdc.net」。「[your_namespace]」會指定您的公司,並且由 Adobe 提供。

媒體追蹤的運作方式在所有平台、桌上型電腦及行動裝置上都一樣。目前音訊追蹤可在行動平台運作。在所有追蹤呼叫中,有一些要驗證的關鍵通用變數:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb