설명서Analytics스트리밍 미디어용 서비스 안내서

드롭된 프레임

마지막 업데이트: 2026년 5월 29일

작성 대상:

  • Developer

이 페이지에서는​ 삭제된 프레임 ​변수에 대한 데이터 수집을 다룹니다. 해당 보고 차원 및 지표에 대해서는 삭제된 프레임을(를) 참조하십시오.

style
shade-box

드롭된 프레임 변수는 세션 중에 플레이어가 드롭한 프레임의 실행 횟수입니다. QoE 개체에 설정하고 플레이어가 새 드롭을 보고할 때마다 값을 업데이트합니다. 백엔드가 세션 종료 시 최신 값을 보고합니다.

NOTE
간격 델타가 아닌 해당 시점까지 전체 세션에 대해 드롭된 프레임의 누적 합계​를 항상 전달하십시오. 업데이트 사이에 값을 0(으)로 재설정하면 백엔드가 0을(를) 최종 값으로 수신하고 이전에 실제로 삭제한 내용과 관계없이 세션에 대해 0개의 삭제된 프레임을 보고합니다.
속성
값
컨텍스트 데이터 변수
a.media.qoe.droppedFrameCount
XDM 컬렉션 필드
xdm.mediaCollection.qoeDataDetails.droppedFrames
Audience Manager 트레이트
c_contextdata.a.media.qoe.droppedFrameCount
필수
아니요
전송 시점
품질 이벤트(비트율 변경, 버퍼 시작, 오류), 세션 닫기

권장 구현 유형

웹 SDK

sendEvent을(를) 호출할 때 xdm.mediaCollection.qoeDataDetails 내에서 droppedFrames을(를) 설정합니다.

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 3200,
        droppedFrames: 3
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

드롭된 프레임을 createQoEObject에 네 번째 인수로 전달합니다. 품질 이벤트가 실행되기 전에 추적기를 업데이트합니다.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

드롭된 프레임을 createQoEObject에 네 번째 인수로 전달합니다. 품질 이벤트가 실행되기 전에 추적기를 업데이트합니다.

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

tracker.updateQoEObject(qoeObject)
Roku

sendMediaEvent을(를) 호출할 때 xdm.mediaCollection.qoeDataDetails 내에서 droppedFrames을(를) 설정합니다.

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 3200,
                "droppedFrames": 3
            },
            "playhead": 90
        }
    }
})
미디어 Edge API

xdm.mediaCollection.qoeDataDetails 내의 droppedFrames을(를) 사용하여 bitrateChange 끝점을 호출합니다.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "droppedFrames": 3
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

드롭된 프레임을 ADB.Media.createQoEObject에 네 번째 인수로 전달:

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

드롭된 누적 프레임 수를 네 번째 인수로 ADBMobile.media.createQoSObject에 전달하고 추적기를 업데이트합니다.

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames (cumulative total)
);
ADBMobile.media.updateQoSObject(qosInfo);
미디어 컬렉션 API

params 개체에 media.qoe.droppedFrames 포함:

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.droppedFrames": 3
  }
}

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

recommendation-more-help
media-analytics-help