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

비트율 변경

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

작성 대상:

  • Developer

이 페이지에서는 비트율 변경 이벤트를 구현하는 방법에 대해 설명합니다. 해당 보고 변수에 대해서는 비트율 변경 (차원) 및 비트율 변경 (지표)을 참조하십시오.

style
shade-box

비트율 변경 이벤트는 플레이어가 다른 비트율로 전환했음을 알립니다. 먼저 QoE 개체에서 Bitrate 값을 업데이트한 다음 비트율 변경 이벤트를 실행합니다. 백엔드는 이러한 이벤트의 수를 사용하여 비트율 변경 차원과 비트율 변경 지표와 결과 비트율 값 피드 평균 비트율을 계산합니다.

속성
값
컨텍스트 데이터 변수
(없음 — 백엔드에서 계산)
XDM 이벤트 유형
media.bitrateChange
Audience Manager 트레이트
c_contextdata.a.media.qoe.bitrateChangeCount
필수
아니요
전송 시점
비트율 변경

권장 구현 유형

웹 SDK

sendEvent을(를) 사용하여 새 비트율로 media.bitrateChange 이벤트를 보냅니다.

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 4500,
        droppedFrames: 0,
        framesPerSecond: 24,
        timeToStart: 0
      },
      sessionID: "{sid}",
      playhead: 120
    }
  }
});
iOS

새 비트율로 QoE 개체를 업데이트한 다음 비트율 변경 이벤트를 실행합니다.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 4500,
                                       startupTime: 0,
                                               fps: 24,
                                     droppedFrames: 0)
tracker.updateQoEObject(qoe: qoeObject)
tracker.trackEvent(event: MediaEvent.BitrateChange, info: nil, metadata: nil)
Android

새 비트율로 QoE 개체를 업데이트한 다음 비트율 변경 이벤트를 실행합니다.

code language-kotlin 
val qoeObject = Media.createQoEObject(4500L, 0.0, 24.0, 0L)
tracker.updateQoEObject(qoeObject)
tracker.trackEvent(Media.Event.BitrateChange, null, null)
Roku

media.bitrateChange과(와) 함께 sendMediaEvent을(를) 사용하여 비트율 변경을 신호로 보냅니다. qoeDataDetails에 새 비트율 포함:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 4500,
                "droppedFrames": 0,
                "framesPerSecond": 24,
                "timeToStart": 0
            },
            "playhead": 120
        }
    }
})
미디어 Edge API

업데이트된 qoeDataDetails을(를) 사용하여 bitrateChange 끝점을 호출합니다.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "bitrate": 4500
        },
        "sessionID": "{sid}",
        "playhead": 120
      }
    }
  }]
}

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

QoE 개체를 업데이트하고 이벤트를 실행합니다.

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(4500, 0, 24, 0);
tracker.updateQoEObject(qoeObject);
tracker.trackEvent(ADB.Media.Event.BitrateChange);
Chromecast

새 비트율로 QoS 개체를 업데이트한 다음 비트율 변경 이벤트를 실행합니다.

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  4500,  // bitrate (kbps)
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
미디어 컬렉션 API

새 비트율을 사용하여 bitrateChange POST 요청 보내기:

code language-json 
{
  "playerTime": { "playhead": 120, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.bitrate": 4500
  }
}

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

recommendation-more-help
media-analytics-help