설명서Experience Platform경험 데이터 모델(XDM) 안내서

Player State Data Reporting 데이터 형식

마지막 업데이트: 2026년 6월 3일

작성 대상:

  • Developer

Player State Data Reporting은(는) 미디어 플레이어 내의 다양한 상태와 발생 횟수를 설명하는 표준 경험 데이터 모델(XDM) 데이터 형식입니다. Player State Data Reporting 데이터 형식을 사용하여 전체 화면, 음소거, 자막, PIP(Picture-in-Picture) 및 인포커스 상태 등 다양한 플레이어 상태를 캡처합니다. 각 상태에 대해 상태가 설정되었는지 여부, 발생 횟수 및 미디어 재생 중 활성 상태로 유지되는 총 시간을 기록합니다.

플레이어 상태 데이터 보고 데이터 형식의 다이어그램입니다.

NOTE
이 데이터 유형은 mediaReporting 스키마 — 구현에서 보낸 mediaCollection 데이터에서 스트리밍 미디어 백엔드에서 계산한 필드. 다음은 Adobe이 Platform 데이터 세트에 수집하는 필드입니다. 자세한 내용은 스트리밍 미디어 XDM 보고 스키마를 참조하십시오.
표시 이름
속성
데이터 유형
설명
Player State Name
name
문자열
플레이어 상태의 이름입니다. 열거형: “fullscreen”(플레이어가 전체 화면을 차지함), “mute”(오디오가 침묵됨), “closedCaptioning”(폐쇄 캡션이 활성화됨), “pictureInPicture”(플레이어가 부동 오버레이에 있음), “inFocus”(플레이어는 일반적으로 플레이어 탭이나 창이 전경에 있으므로 뷰어의 활성 주의를 기울임).
Player State Set
isSet
부울
해당 상태에서 플레이어 상태를 설정할지 여부입니다.
Player State Count
count
정수
스트림에 플레이어 상태가 설정된 횟수입니다.
Player State Time
time
정수
해당 플레이어 상태의 총 기간(초)입니다.

전체 스키마 정의는 공용 XDM 리포지토리의 playerstatedata.schema.json을(를) 참조하십시오.

recommendation-more-help
experience-platform-help-xdm