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

초당 프레임

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

작성 대상:

  • Developer

초당 프레임 수 변수는 스트림의 현재 프레임 속도입니다. 백엔드가 각 재생 세션에 대한 전체 품질 컨텍스트를 갖도록 비트율 및 드롭된 프레임과 함께 QoE 개체에 설정합니다. Adobe Analytics은 프레임 속도에 대한 보고 변수를 자동으로 만들지 않습니다. 보고서로 표시하려는 경우 사용자 지정 처리 규칙을 만듭니다.

속성
값
컨텍스트 데이터 변수
없음(Adobe Analytics에서 프레임 속도에 대해 예약된 컨텍스트 데이터 키를 할당하지 않음)
XDM 컬렉션 필드
xdm.mediaCollection.qoeDataDetails.framesPerSecond
Audience Manager 트레이트
해당 사항 없음
필수
아니요
전송 시점
품질 이벤트(비트율 변경, 버퍼 시작, 오류), 세션 닫기

권장 구현 유형

웹 SDK

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

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

프레임 속도를 세 번째 인수(fps)로 createQoEObject에 전달합니다.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

프레임 속도를 세 번째 인수(fps)로 createQoEObject에 전달합니다.

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

tracker.updateQoEObject(qoeObject)
Roku

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

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

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

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

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

프레임 속도를 세 번째 인수로 ADB.Media.createQoEObject에 전달합니다.

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

프레임 속도를 세 번째 인수(fps)로 ADBMobile.media.createQoSObject에 전달하고 추적기를 업데이트합니다.

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

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

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

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

recommendation-more-help
media-analytics-help