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

비트율

마지막 업데이트: 2026년 9월 30일

작성 대상:

  • 개발자

이 페이지에서는​ Bitrate ​변수에 대한 데이터 수집을 다룹니다. 해당 보고 변수에 대해서는 평균 비트율 (차원) 및 평균 비트율 (지표)을(를) 참조하십시오.

style
shade-box

bitrate 변수는 현재 재생 비트율입니다(초당 킬로비트). 플레이어가 비트율을 협상할 때마다 QoE 개체에 설정하고 비트율이 변경되면 QoE 개체를 업데이트합니다. 백엔드는 비트율 값을 사용하여 평균 비트율, 비트율 버킷당 차원 및 비트율 변경 지표를 계산합니다.

속성
값
컨텍스트 데이터 변수
a.media.qoe.bitrateAverageBucket
XDM 컬렉션 필드
xdm.mediaCollection.qoeDataDetails.bitrate
Audience Manager 트레이트
c_contextdata.a.media.qoe.bitrateAverageBucket
필수
아니요
전송 시점
품질 이벤트(비트율 변경, 버퍼 시작, 오류), 세션 닫기

권장 구현 유형

웹 SDK

sendEvent을(를) 호출할 때 media.bitrateChange(또는 품질 관련 이벤트)의 xdm.mediaCollection.qoeDataDetails 내에서 bitrate을(를) 설정합니다.

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

비트율을 첫 번째 인수로 createQoEObject에 전달합니다. 품질 이벤트가 실행되기 전에 추적기에서 QoE 개체를 업데이트합니다.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

비트율을 첫 번째 인수로 createQoEObject에 전달합니다. 품질 이벤트가 실행되기 전에 추적기에서 QoE 개체를 업데이트합니다.

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

tracker.updateQoEObject(qoeObject)
Roku Edge

media.bitrateChange과(와) 같은 품질 이벤트에 대해 sendMediaEvent을(를) 호출할 때 xdm.mediaCollection.qoeDataDetails 내에서 bitrate을(를) 설정합니다.

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

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

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

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

비트율을 첫 번째 인수로 ADB.Media.createQoEObject에 전달하고 추적기를 업데이트하십시오.

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(
  3200,  // bitrate (kbps)
  0,     // startup time (ms)
  24,    // fps
  0      // dropped frames
);

tracker.updateQoEObject(qoeObject);
Chromecast

ADBMobile.media.createQoSObject에 첫 번째 인수로 비트 전송률을 kbps로 전달하고 추적기를 업데이트합니다.

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate (kbps)
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
Roku 2.x

adb_media_init_qosinfo에 첫 번째 인수로 비트 전송률을 kbps로 전달하고 mediaUpdateQoS(으)로 추적기를 업데이트하세요.

code language-brightscript 
adb = ADBMobile()
qosInfo = adb_media_init_qosinfo(3200.0, 0.0, 24.0, 0.0)  ' bitrate, startupTime, fps, droppedFrames

adb.mediaUpdateQoS(qosInfo)
미디어 컬렉션 API

bitrateChange POST 요청의 params 개체에 media.qoe.bitrate 포함:

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

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

recommendation-more-help
media-analytics-help