플레이어 상태 매개변수 player-state-parameters

이 항목에서는 솔루션 변수를 통해 Adobe가 수집하는 플레이어 상태 데이터의 목록을 제공합니다.

테이블 데이터 설명:

  • 구현: 구현 값 및 요구 사항에 대한 정보

    • - 앱에서 수동으로 설정하거나 Adobe Media SDK에 의해 자동으로 설정된 변수.
    • 필수 - 기본 비디오 추적에 매개변수가 필요한지 여부를 나타냅니다.
    • 유형 - 설정할 변수의 유형을 문자열 또는 숫자로 지정합니다.
    • 전송 시점 - 데이터가 전송되는 시점을 나타냅니다. 미디어 시작 ​은 미디어 시작 시 분석 호출이 전송되고, 광고 시작 ​은 광고 시작 시 분석 호출이 전송됩니다. 닫기 호출은 미디어 세션 종료 시 또는 광고, 챕터 종료 시 하트비트 서버에서 Analytics 서버로 컴파일된 분석 호출이 직접 전송됩니다. 닫기 호출은 네트워크 패킷 호출에 사용할 수 없습니다.
    • 최소. SDK 버전 - 매개변수에 액세스하는 데 필요한 SDK 버전을 나타냅니다.
    • 샘플 값 - 일반적인 변수 사용의 예를 제공합니다.
  • 네트워크 매개변수: Adobe Analytics 또는 하트비트 서버에 전달되는 값을 표시합니다. 이 열에는 Adobe Media SDK에서 생성한 네트워크 호출에 표시되는 매개변수의 이름이 표시됩니다.

  • 보고: 비디오 데이터를 보고 분석하는 방법에 대한 정보입니다.

    • 사용 가능 - 데이터가 기본적으로() 보고 시 사용할 수 있는지 아니면 사용자 정의 설정(사용자 정의)을 필요로 하는지 여부를 지정합니다.
    • 예약된 변수 - 데이터가 예약된 변수에 이벤트, eVar, prop 또는 분류로 캡처되는지 여부를 나타냅니다.
    • 보고서 이름 - 변수에 대한 Adobe Analytics 보고서의 이름
    • 컨텍스트 데이터 - 보고 서버에 전달되고 처리 규칙에 사용되는 Adobe Analytics 컨텍스트 데이터의 이름
    • 데이터 피드 - 클릭스트림 또는 라이브 스트림 데이터 피드에 있는 변수의 열 이름
    • Audience Manager - Adobe Audience Manager에 있는 트레이트 이름
IMPORTANT
보고/예약 변수 아래에 "분류"로 설명되어 있는 변수의 분류 이름을 변경하지 마십시오.
미디어 분류는 보고서 세트가 미디어 추적에 사용될 때 정의됩니다. Adobe는 수시로 새 속성을 추가하며, 이 경우 고객이 보고서 세트를 다시 활성화하여 새로운 미디어 속성에 액세스해야 합니다. 업데이트 프로세스 중에 Adobe는 변수의 이름을 확인하여 분류를 사용할지 여부를 결정합니다. 누락된 항목이 있을 경우 Adobe가 다시 추가합니다.

플레이어 상태 속성 player-state-properties

플레이어 상태 추적 기능을 오디오 또는 비디오 스트림에 연결할 수 있습니다. 표준화된 플레이어 상태 추적 지표는 솔루션 변수로 저장됩니다. 표준 상태는 fullscreen, mute, closedCaptioning, pictureInPicture 및 inFocus입니다.

전체 화면 속성

전체 화면 영향을 받는 스트림

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​전체 화면의 영향을 받은 스트림 수입니다. 이 지표는 재생 세션 중에 하나 이상의 전체 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.fullscreen.set
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    전체 화면의 영향을 받은 스트림
  • 컨텍스트 데이터
    a.media.states.fullscreen.set
  • 데이터 피드
    videostatefullscreen
  • Audience Manager
    c_contextdata.a.media.states.fullscreen.set
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateSet
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.isSet

전체 화면 카운트

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​전체 화면이 표시된 횟수입니다. 이 지표는 재생 세션 중에 하나 이상의 전체 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 개수는 비디오가 전체 화면 상태에 있었던 횟수와 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.fullscreen.count
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    전체 화면 수
  • 컨텍스트 데이터
    a.media.states.fullscreen.count
  • 데이터 피드
    videostfullscreencount
  • Audience Manager
    c_contextdata.media.states.fullscreen.count
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateCount
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.count

전체 화면 총 기간

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​전체 화면이 표시된 시간 길이입니다. 이 지표는 재생 세션 중에 하나 이상의 전체 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 시간은 비디오가 전체 화면 상태에 있었던 시간과 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.fullscreen.time
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    전체 화면 총 시간
  • 컨텍스트 데이터
    a.media.states.fullscreen.time
  • 데이터 피드
    videostfullscreen
  • Audience Manager
    c_contextdata.media.states.fullscreen.time
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    fullScreen.playerStateTime
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.time

닫힌 캡션 속성

자막의 영향을 받는 스트림

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​닫힌 캡션의 영향을 받은 스트림 수입니다. 이 지표는 재생 세션 중에 하나 이상의 닫힌 캡션 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.closedcaptioning.set
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    닫힌 캡션의 영향을 받은 스트림
  • 컨텍스트 데이터
    a.media.states.closedcaptioning.set
  • 데이터 피드
    videostlisedcaptioning
  • Audience Manager
    c_contextdata.a.media.states.
    closedcaptioning.set
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateSet
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.isSet

자막 카운트

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​자막이 표시된 횟수입니다. 이 지표는 재생 세션 중에 하나 이상의 닫힌 캡션 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 개수는 비디오가 자막 상태에 있었던 횟수와 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.closedcaptioning.count
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    자막 수
  • 컨텍스트 데이터
    a.media.states.closedcaptioning.count
  • 데이터 피드
    videostlosedcaptioncount
  • Audience Manager
    c_contextdata.media.states.
    closedcaptioning.count
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateCount
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.count

자막 총 기간

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​자막이 표시된 시간입니다. 이 지표는 재생 세션 중에 하나 이상의 전체 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 시간은 비디오가 자막 상태에서 있었던 시간과 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.closedcaptioning.time
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    자막 총 시간
  • 컨텍스트 데이터
    a.media.states.closedcaptioning.time
  • 데이터 피드
    videostateclosedcaptioningtime
  • Audience Manager
    c_contextdata.media.states.
    closedcaptioning.time
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    closeCaption.playerStateTime
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.time

음소거 속성

음소거의 영향을 받는 스트림

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​음소거의 영향을 받은 스트림 수입니다. 이 지표는 재생 세션 중에 하나 이상의 음소거 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.mute.set
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    음소거의 영향을 받은 스트림
  • 컨텍스트 데이터
    a.media.states.mute.set
  • 데이터 피드
    videostatemute
  • Audience Manager
    c_contextdata.a.media.states.mute.set
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateSet
  • < 보고 XDM 필드 패스:
    mediaReporting.playerStateData.isSet

음소거 카운트

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    음소거가 표시된 횟수입니다. 이 지표는 재생 세션 중에 하나 이상의 음소거 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 개수는 비디오가 음소거 상태에 있었던 횟수와 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.mute.count
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    음소거 수
  • 컨텍스트 데이터
    a.media.states.mute.count
  • 데이터 피드
    videostatemutecount
  • Audience Manager
    c_contextdata.media.states.mute.count
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.mute.playerStateCount
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.count

음소거 총 기간

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    음소거가 표시된 시간입니다. 이 지표는 재생 세션 중에 하나 이상의 음소거 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 시간은 비디오가 음소거 상태에서 있었던 시간과 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.mute.time
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    음소거 총 시간
  • 컨텍스트 데이터
    a.media.states.mute.time
  • 데이터 피드
    videostatemutetime
  • Audience Manager
    c_contextdata.media.states.mute.time
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    mute.playerStateTime
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.time

화면 속 화면 속성

화면 속 화면의 영향을 받은 스트림

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​화면 속 화면의 영향을 받은 스트림의 수입니다. 이 지표는 재생 세션 중에 화면 속 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.pictureinpicture.set
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    화면 속 화면의 영향을 받은 스트림
  • 컨텍스트 데이터
    a.media.states.pictureinpicture.set
  • 데이터 피드
    videostacepictureinpicture
  • Audience Manager
    c_contextdata.a.media.states.
    pictureinpicture.set
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateSet
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.isSet

화면 속 화면 카운트

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​화면 속 화면을 표시한 횟수입니다. 이 지표는 재생 세션 중에 화면 속 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 개수는 화면 속 화면 상태에 있었던 횟수와 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.pictureinpicture.count
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    화면 속 화면 수
  • 컨텍스트 데이터
    a.media.states.pictureinpicture.count
  • 데이터 피드
    videostacepicturepresentation
  • Audience Manager
    c_contextdata.media.states.
    pictureinpicture.count
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateCount
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.count

화면 속 화면 총 기간

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​화면 속 화면을 표시한 시간 길이입니다. 이 지표는 재생 세션 중에 화면 속 화면 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 시간은 비디오가 화면 속 화면 상태에 있었던 시간과 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.pictureinpicture.time
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    화면 속 화면 총 시간
  • 컨텍스트 데이터
    a.media.states.pictureinpicture.time
  • 데이터 피드
    videostacepicturetime
  • Audience Manager
    c_contextdata.media.states.
    pictureinpicture.time
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    pictureInPicture.playerStateTime
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.time

초점 속성

초점의 영향을 받는 스트림

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​초점의 영향을 받은 스트림 수입니다. 이 지표는 재생 세션 중에 초점 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정된 경우 TRUE 값만 가능합니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.infocus.set
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    초점의 영향을 받은 스트림
  • 컨텍스트 데이터
    a.media.states.infocus.set
  • 데이터 피드
    videostateinfocus
  • Audience Manager
    c_contextdata.a.media.states.infocus.set
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.inFocus.playerStateSet
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.isSet

초점 카운트

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​초점을 표시한 횟수입니다. 이 지표는 재생 세션 중에 초점 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 개수는 비디오가 초점 상태에 있었던 횟수와 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.infocus.count
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    초점 수
  • 컨텍스트 데이터
    a.media.states.infocus.count
  • 데이터 피드
    videostateinfocuscount
  • Audience Manager
    c_contextdata.media.states.infocus.count
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateCount
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.count

초점 총 기간

구현
네트워크 매개변수
보고
  • SDK 키
    자동으로 설정됨
  • API 키
    해당 사항 없음
  • 필수
    아니요
  • 유형
    숫자
  • 전송 시점
    미디어 닫기
  • 최소. SDK 버전
    3.0
  • 샘플 값
    TRUE
  • 설명
    ​초점을 표시한 시간 길이입니다. 이 지표는 재생 세션 중에 초점 상태가 발생한 경우에만 1로 설정됩니다.
    중요
    이 이벤트가 설정되면 시간은 비디오가 초점 상태에서 있었던 시간과 같습니다. 이 이벤트가 설정되지 않은 경우에는 값이 전송되지 않습니다.
  • Adobe Analytics
    a.media.states.infocus.time
  • Heartbeat
    해당 사항 없음
  • 사용 가능
  • 예약된 변수
    이벤트
  • 보고서 이름
    초점 총 시간
  • 컨텍스트 데이터
    a.media.states.infocus.time
  • 데이터 피드
    videostateinfocustime
  • Audience Manager
    c_contextdata.media.states.infocus.time
  • XDM 필드 패스:
    media.mediaTimed.primaryAssetViewDetails.
    inFocus.playerStateTime
  • 보고 XDM 필드 패스:
    mediaReporting.playerStateData.time

관련 API related_apis_section

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb