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

세션 세부 정보 보고 데이터 형식

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

작성 대상:

개발자

세션 세부 정보 보고는 미디어 재생 세션과 관련된 데이터를 추적하는 표준 XDM(Experience Data Model) 데이터 형식입니다.
미디어 보고 필드는 Adobe 서비스에서 사용자가 보낸 미디어 컬렉션 필드를 분석하는 데 사용됩니다. 이 데이터는 다른 특정 사용자 지표와 함께 계산되고 보고됩니다. 스키마는 사용자 비헤이비어 및 콘텐츠 소비 패턴에 대한 통찰력을 제공하는 광범위한 속성을 포함합니다. 세션 세부 정보 보고 데이터 형식을 사용하여 재생 이벤트, 광고 상호 작용, 진행률 마커, 일시 중지 및 기타 지표를 로깅하여 사용자 참여를 캡처합니다.

세션 세부 정보 보고 데이터 유형의 다이어그램을 표시하려면 선택합니다.

NOTE

각 디스플레이 이름에는 해당 오디오 및 비디오 매개 변수에 대한 추가 정보를 볼 수 있는 링크가 포함되어 있습니다. 연결된 페이지에는 Adobe, 구현 값, 네트워크 매개 변수, 보고 및 중요 고려 사항으로 수집된 비디오 및 데이터에 대한 세부 사항이 포함되어 있습니다.

표시 이름

속성

데이터 유형

설명

10% 진행률 마커

hasProgress10

부울

스트림 길이에 따라 플레이헤드가 미디어 마커의 10%를 통과했음을 나타냅니다. 마커는 뒤로 검색하는 경우에도 한 번만 카운트됩니다. 앞으로 검색하는 경우 건너뛴 마커는 카운트되지 않습니다.

25% 진행률 마커

hasProgress25

부울

스트림 길이에 따라 플레이헤드가 미디어 마커의 25%를 통과했음을 보여 줍니다. 마커는 뒤로 검색하는 경우에도 한 번만 카운트됩니다. 앞으로 검색하는 경우 건너뛴 마커는 카운트되지 않습니다.

50% 진행률 마커

hasProgress50

부울

스트림 길이에 따라 플레이헤드가 미디어 마커의 50%를 통과했음을 보여 줍니다. 마커는 뒤로 검색하는 경우에도 한 번만 카운트됩니다. 앞으로 검색하는 경우 건너뛴 마커는 카운트되지 않습니다.

75% 진행률 마커

hasProgress75

부울

스트림 길이에 따라 플레이헤드가 미디어 마커의 75%를 통과했음을 보여 줍니다. 마커는 뒤로 검색하는 경우에도 한 번만 카운트됩니다. 앞으로 검색하는 경우 건너뛴 마커는 카운트되지 않습니다.

95% 진행률 마커

hasProgress95

부울

스트림 길이에 따라 플레이헤드가 미디어 마커의 95%를 통과했음을 보여 줍니다. 마커는 뒤로 검색하는 경우에도 한 번만 카운트됩니다. 앞으로 검색하는 경우 건너뛴 마커는 카운트되지 않습니다.

광고 수

adCount

정수

재생 도중 시작된 광고 횟수.

광고 로드 유형

adLoad

문자열

고객별 내부 표현으로 정의되는 로드된 광고 유형.

앨범

album

문자열

뮤직 레코딩 또는 비디오가 포함된 앨범 이름.

아티스트

artist

문자열

뮤직 레코딩 또는 비디오의 앨범 아티스트나 단체의 이름.

자산 ID

assetID

문자열

자산 ID은(는) TV 시리즈 에피소드 식별자, 동영상 자산 식별자 또는 라이브 이벤트 식별자와 같은 미디어 자산 콘텐츠에 대한 고유 식별자입니다. 일반적으로 이러한 ID는 EIDR, TMS/Gracenote 또는 Rovi와 같은 메타데이터 권한에서 파생됩니다. 이러한 식별자는 다른 소유권 또는 사내 시스템에서도 사용할 수 있습니다.

작성자

author

문자열

미디어 작성자의 이름입니다.

대상 평균 시간

averageMinuteAudience

숫자 특정 미디어 항목에 사용된 평균 콘텐츠 시간(즉, 총 콘텐츠 시간을 모든 재생 세션의 길이로 나눈 시간)을 설명합니다.

브로드캐스트 콘텐츠 형식

contentType

문자열

스트림 배달의 브로드캐스트 콘텐츠 형식. 스트림 유형당 사용 가능한 값은 다음과 같습니다.
오디오: "song", "podcast", "audiobook" 및 "radio";
비디오: "VoD", "Live", "Linear", "UGC" 및 "DVoD".
고객은 이 매개 변수에 대한 사용자 지정 값을 제공할 수 있습니다.

브로드캐스트 네트워크

network

문자열

네트워크/채널 이름.

챕터 수

chapterCount

정수

재생 도중 시작된 챕터 횟수.

콘텐츠 채널

channel

문자열

콘텐츠 채널은(는) 콘텐츠가 재생된 배포 채널입니다.

컨텐츠 완료

isCompleted

부울

콘텐츠 완료은(는) 시간 미디어 에셋이 완료될 때까지 관찰되었는지 여부를 나타냅니다. 이 이벤트가 뷰어가 전체 비디오를 시청했음을 의미하지는 않습니다. 뷰어는 앞으로 건너뛸 수도 있습니다.

콘텐츠 배달 네트워크

cdn

문자열

재생된 콘텐츠의 콘텐츠 배달 네트워크.

콘텐츠 ID

name

문자열

콘텐츠 ID은(는) 콘텐츠의 고유 식별자입니다. 다른 업계 또는 CMS ID에 다시 연결하는 데 사용할 수 있습니다.

콘텐츠 이름

friendlyName

문자열

콘텐츠 이름은(는) 콘텐츠의 "친숙한"(사람이 읽을 수 있음) 이름입니다.

콘텐츠 플레이어 이름

playerName

문자열

콘텐츠 플레이어의 이름입니다.

콘텐츠 시작

isPlayed

부울

미디어의 첫 번째 프레임이 사용되면 콘텐츠 시작이(가) true가 됩니다. 광고, 버퍼링 중에 사용자가 그만두면 콘텐츠 시작 이벤트가 일어나지 않습니다.

콘텐츠 체류 시간

timePlayed

정수

콘텐츠 체류 시간은(는) 기본 콘텐츠에서 재생 유형의 모든 이벤트에 대한 이벤트 기간(초)을 합합니다.

작성자 이름

originator

문자열

콘텐츠 작성자의 이름입니다.

일 파트

dayPart

문자열

콘텐츠가 브로드캐스트 또는 재생되는 시간을 정의하는 속성입니다. 이는 고객이 필요에 따라 값을 설정할 수 있습니다

에피소드 번호

episode

문자열

에피소드의 번호입니다.

예상 스트림

estimatedStreams

숫자

각 개별 콘텐츠에 대한 예상 비디오 또는 오디오 스트림 수입니다.

페더레이션 데이터

isFederated

부울

히트가 페더레이션되면( 고객이 자체 구현이 아니라 페더레이션된 데이터 공유의 일부로 수신함) 페더레이션 데이터가 true로 설정됩니다.

피드 유형

feed

문자열

EAST HD 또는 SD와 같은 실제 피드 관련 데이터나 URL과 같은 피드 소스를 나타낼 수 있는 피드 유형입니다.

첫 방송 날짜

firstAirDate

문자열

컨텐츠가 TV에 처음 방송된 날짜. 모든 날짜 형식이 허용되지만, Adobe은 YYYY-MM-DD 형식을 권장합니다.

첫 번째 디지털 날짜

firstDigitalDate

문자열

콘텐츠가 디지털 채널 또는 플랫폼에서 처음으로 방송된 날짜. 모든 날짜 형식이 허용되지만, Adobe은 YYYY-MM-DD 형식을 권장합니다.

장르

genre

문자열

콘텐츠 생성자가 정의한 콘텐츠 유형 또는 그룹입니다. 값은 변수 구현에서 쉼표로 구분해야 합니다.

승인된 미디어

authorized

문자열

Adobe 인증을 통해 사용자에게 권한이 부여되었는지 확인합니다.

미디어 콘텐츠 길이

length

정수

예

미디어 다운로드 플래그

isDownloaded

부울

다운로드되면 스트림은 디바이스에서 로컬로 재생됩니다.

미디어 세그먼트 보기 수

hasSegmentView

부울

미디어 세그먼트 보기 수는 첫 번째 프레임이 아니라 최소 하나 이상 본 시기를 나타냅니다.

미디어 세션 ID

ID

문자열

미디어 세션 ID은(는) 개별 재생에 고유한 콘텐츠 스트림의 인스턴스를 식별합니다.
참고:sessionId은(는) sessionStart과(와) 다운로드한 모든 이벤트를 제외한 모든 이벤트에 전송됩니다.__

미디어 세션 서버 시간 초과

secondsSinceLastCall

숫자 미디어 세션 서버 시간 제한은(는) 마지막으로 알려진 사용자의 상호 작용과 세션이 닫힌 시간 사이에 경과된 시간(초)을 나타냅니다.

미디어 시작

isViewed

부울

미디어에 대한 로드 이벤트입니다. 이는 뷰어가 재생 버튼을 선택할 때 발생합니다. 이 이벤트는 프리롤 광고, 버퍼링, 오류 등이 있는 경우에도 계산됩니다.

미디어 체류 시간

totalTimePlayed

정수

광고 시청 시간을 포함해 특정 시간 미디어 에셋에서 사용자가 사용한 총 시간을 설명합니다.

MVPD 식별자

mvpd

문자열

Adobe 인증을 통해 제공된 MVPD 식별자.

이벤트 일시 중지

pauseCount

정수

일시 중지 이벤트는 재생 중에 발생한 일시 중지 기간 수를 계산합니다.

영향을 받는 스트림 일시 중지

hasPauseImpactedStreams

부울 단일 미디어 항목 재생 중에 한 번 이상의 일시 정지가 발생했는지 여부를 나타냅니다.

Pcccr

pccr

부울

Pcccr은(는) 리디렉션이 발생했음을 나타냅니다.

Pev3

pev3

문자열

Pev3은(는) 보고에 사용되는 미디어 스트림 유형입니다.

게시자

publisher

문자열

오디오 콘텐츠 게시자의 이름입니다.

라디오 방송국

station

문자열

오디오가 재생되는 라디오 방송국 이름.

등급 값

rating

문자열

TV 유해 콘텐츠 가이드라인으로 정의된 등급.

레코드 레이블

label

문자열

레코드 레이블의 이름입니다.

다시 시작

hasResume

부울

버퍼, 일시 중단 또는 중단이 30분 이상 경과하고 다시 시작된 각 재생을 표시합니다.

시즌 번호

season

문자열

표시가 속한 시즌 번호입니다. 시즌 시리즈는 표시가 시리즈의 일부인 경우에만 필요합니다.

시리즈 이름

show

문자열

프로그램/시리즈 이름. 프로그램 이름은 표시가 시리즈의 일부인 경우에만 필요합니다.

유형 표시

showType

문자열

컨텐츠 유형(예: 트레일러 또는 전체 에피소드).

스트림 형식

streamFormat

문자열

스트림 형식(HD, SD)입니다.

스트림 형식

streamType

문자열

미디어 스트림의 유형입니다.

총 일시 중단 기간

pauseTime

정수

총 일시 중지 기간은(는) 사용자가 재생을 일시 중지한 기간(초)을 설명합니다.

고유 재생 시간

uniqueTimePlayed

정수

시간 미디어 에셋에서 사용자가 본 고유 간격의 합을 설명합니다(즉, 여러 번 본 재생 간격 길이는 오직 한 번만 카운트됨).

버전

appVersion

문자열

플레이어에서 사용하는 SDK 버전입니다. 플레이어에 적합한 사용자 정의 값을 가질 수 있습니다.

비디오 세그먼트

segment

문자열

조회한 콘텐츠 중 일부를 설명하는 간격(단위: 분).

recommendation-more-help

62e9ffd9-1c74-4cef-8f47-0d00af32fc07