설명서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
필수
아니요
전송 시점
세션 시작, 세션 닫기

권장 구현 유형

웹 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
        }
    }
})
미디어 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
  }
}

전체 요청 구조에 대해서는 Media Collection API 세션 참조를 참조하십시오.

recommendation-more-help
media-analytics-help