文件Analytics串流媒體服務指南

開始時間

最後更新： 2026年5月29日

建立對象：

  • Developer

本頁涵蓋​ 開始時間 ​變數的資料集合。 如需對應的報表維度和量度，請參閱開始時間。

style
shade-box

開始時間變數是播放器起始播放與第一個影格轉譯之間經過的時間，以毫秒為單位。 在工作階段開始事件引發之前，在QoE物件上設定它。 Adobe會以秒為單位儲存和報告值；傳遞毫秒，Adobe會在擷取時轉換。

IMPORTANT
播放器開始轉譯內容框架後，請停止更新timeToStart。 此值可能會在初始緩衝或載入階段期間增加，但應視為從播放開始時刻起即已固定。 在第一個影格轉譯後繼續更新，會產生膨脹或不正確的開始時間量度。
屬性
價值
內容資料變數
a.media.qoe.timeToStart
XDM集合欄位
xdm.mediaCollection.qoeDataDetails.timeToStart
Audience Manager特徵
c_contextdata.a.media.qoe.timeToStart
必要
否
與​一起傳送
工作階段開始，工作階段關閉

建議的實作型別

Web SDK

呼叫sendEvent時，在media.sessionStart的xdm.mediaCollection.qoeDataDetails中設定timeToStart：

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      qoeDataDetails: {
        timeToStart: 30000
      },
      playhead: 0
    }
  }
});
iOS

將啟動時間作為第二個引數(startupTime)傳遞給createQoEObject。

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 30000,
                                               fps: 24,
                                     droppedFrames: 0)

tracker.updateQoEObject(qoe: qoeObject)
Android

將啟動時間作為第二個引數(startupTime)傳遞給createQoEObject。

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      30000.0,
                                      24.0,
                                      0L)

tracker.updateQoEObject(qoeObject)
Roku

呼叫createMediaSession時，在media.sessionStart的xdm.mediaCollection.qoeDataDetails中設定timeToStart：

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "qoeDataDetails": {
                "timeToStart": 30000
            },
            "playhead": 0
        }
    }
})
Media Edge API

呼叫xdm.mediaCollection.qoeDataDetails內有timeToStart的sessionStart端點：

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "qoeDataDetails": {
          "timeToStart": 30000
        },
        "playhead": 0
      }
    }
  }]
}

舊版實作型別（僅限Analytics）

Media SDK JS 3.x

將開始時間作為第二個引數傳遞給ADB.Media.createQoEObject：

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(3200, 30000, 24, 0);
tracker.updateQoEObject(qoeObject);
Chromecast

將啟動時間以毫秒為單位作為第二個引數(startupTime)傳遞至ADBMobile.media.createQoSObject並更新追蹤器：

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,   // bitrate
  0,      // startupTime (ms)
  24,     // fps
  0       // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
媒體收集API

在sessionStart上的params物件中包含media.qoe.timeToStart：

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.qoe.timeToStart": 30000
  }
}

如需完整的要求結構，請參閱媒體收集API工作階段參考。

recommendation-more-help
media-analytics-help