Show Menu
主題×

設定概述

下列指示適用於 2.x Media SDK。若您正在實施 Media SDK 1.x 版,請參閱 1.x Media SDK 文件。 如需 Primetime 整合器的相關資訊,請參閱以下的
Primetime Media SDK 文件

最低平台版本支援

下表說明自 2019 年 2 月 19 日起各個 SDK 支援的最低平台版本。
作業系統/瀏覽器
需要的最低版本
iOS 應用程式
iOS 6+
Android
Android 5.0+ - Lollipop
Chrome
v22+
Mozilla
v27+
Safari
v7+
IE
v11+

一般實施指引

有三個主要的 SDK 元件與媒體追蹤有關:
  • 媒體心率設定 - 此設定包含報表的基本設定。
  • 媒體心率代理人 - 代理人可控制播放時間和 QoS 物件。
  • 媒體心率 - 包含成員與方法的主要程式庫。
完成下列實施步驟:
  1. 建立
    MediaHeartbeatConfig
    例項並設定您的設定參數值。
     變數名稱
    說明
    必填
     預設值 
    trackingServer
    適用於媒體分析的追蹤伺服器。這與您的分析追蹤伺服器不同。
    空白字串
    channel
    管道名稱
    空白字串
    ovp
    線上媒體平台的名稱,透過它分送內容
    空白字串
    appVersion
    媒體播放器應用程式/SDK 的版本
    空白字串
    playerName
    使用的媒體播放器名稱,例如「AVPlayer」、「HTML5 播放器」、「我的自訂播放器」
    空白字串
    ssl
    指出呼叫是否應透過 HTTPS 進行
    false
    debugLogging
    指出是否已啟用除錯記錄
    false
  2. 實作
    MediaHeartbeatDelegate
    .
     方法名稱 
     說明
    必填
    getQoSObject()
    傳回包含目前 QoS 資訊的
    MediaObject
    例項。將在播放工作階段期間呼叫此方法多次。播放器實施必須一律傳回最新可用的 QoS 資料。
    getCurrentPlaybackTime()
    傳回播放點的目前位置。對於 VOD 追蹤,該值是從媒體項目的開頭開始以秒為單位指定的。對於 LINEAR/LIVE 追蹤,該值是從節目的開頭開始以秒為單位指定的。
    服務品質 (QoS) 物件為選用。若 QoS 資料可供您的播放器使用,且您希望追蹤該資料,則需要下列變數:
    變數名稱
    說明
    必填
    bitrate
    媒體的位元速率,以每秒位元組數為單位。
    startupTime
    媒體的啟動時間 (以毫秒為單位)
    fps
    每秒顯示的畫面。
    droppedFrames
    目前掉格的數量。
  3. 建立
    MediaHeartbeat
    例項。
    使用
    MediaHertbeatConfig
    MediaHertbeatDelegate
    來建立
    MediaHeartbeat
    例項。
    請確保您的
    MediaHeartbeat
    例項可供存取,並且不會在工作階段結束前遭到取消配置。此例項將用於下列所有媒體追蹤事件。
    MediaHeartbeat
    需要
    AppMeasurement
    的例項,才能傳送呼叫至 Adobe Analytics。
  4. 組合所有片段。
    以下範例程式碼將 JavaScript 2.x SDK 用於 HTML5 視訊播放器:
    // 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);

驗證

Media Analytics 追蹤實施會產生兩種類型的追蹤呼叫:
  • 媒體和廣告開始呼叫會直接傳送到 Adobe Analytics (AppMeasurement) 伺服器。
  • 心率呼叫會傳送到 Media Analytics (心率) 追蹤伺服器並於該位置處理,然後再傳遞到 Adobe Analytics 伺服器。
  • Adobe Analytics (AppMeasurement) 伺服器
    如需有關追蹤伺服器選項的詳細資訊,請參閱 正確填入 trackingServer 和 trackingServerSecure 變數
    Experience Cloud 訪客 ID 服務需要 RDC 追蹤伺服器,或 CNAME 解析至 RDC 伺服器。
    分析追蹤伺服器的結尾應該是「
    .sc.omtrdc.net
    」或應該是 CNAME。
  • ** Media Analytics (心率) 伺服器** 此格式一律為「
    [your_namespace].hb.omtrdc.net
    」。「
    [your_namespace]
    」會指定您的公司,並且由 Adobe 提供。
媒體追蹤的運作方式在所有平台、桌上型電腦及行動裝置上都一樣。目前音訊追蹤可在行動平台運作。在所有追蹤呼叫中,有一些要驗證的關鍵通用變數:

SDK 1.x 文件

Video Analytics 1.x SDK
 開發人員指南 (僅提供 PDF)
Android
AppleTV
Chromecast
iOS 應用程式
JavaScript
Primetime
TVML

Primetime Media SDK 文件