createMediaSession
createMediaSession 명령은 웹 SDK streamingMedia 구성 요소에 속합니다. 이 구성 요소를 사용하여 웹 사이트에서 미디어 세션과 관련된 데이터를 수집할 수 있습니다. 이 구성 요소를 구성하는 방법을 알아보려면 streamingMedia 설명서를 참조하세요.
수집된 데이터에는 미디어 재생, 일시 정지, 완료 및 기타 관련 이벤트에 대한 정보가 포함될 수 있습니다. 수집되면 이 데이터를 스트리밍 미디어용 Adobe Analytics에 전송하여 지표를 집계할 수 있습니다. 이 기능은 웹 사이트에서의 미디어 소비 행동을 추적하고 이해하는 포괄적인 솔루션을 제공합니다.
웹 SDK에서 다음 두 가지 방법으로 미디어 세션을 만들 수 있습니다.
- 자동으로 추적된 미디어 세션을(를) 사용하면 웹 SDK에서 스트리밍 미디어용 Adobe Analytics에 대한 미디어 ping 이벤트 발송을 관리할 수 있습니다. 이러한 Ping의 빈도는 streamingMedia 구성 요소의 구성 설정에 따라 결정됩니다.
- 수동으로 추적된 미디어 세션을(를) 통해 스트리밍 미디어용 Adobe Analytics에 세션 Ping 이벤트 발송을 보다 효율적으로 제어할 수 있습니다. 또한 미디어 세션용
sessionID을(를) 저장할 수 있습니다.
자동으로 추적되는 미디어 세션 만들기 automatic
미디어 세션 추적을 자동으로 시작하려면 아래에 설명된 옵션을 사용하여 createMediaSession 메서드를 호출하십시오.
alloy("createMediaSession", {
playerId: "movie-test",
getPlayerDetails: () => {
return {
playhead: document.getElementById("movie-test").currentTime,
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
};
},
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
sessionDetails: {
...
}
}
}
});
속성
유형
필수 여부
설명
playerId문자열
예
미디어 세션을 나타내는 고유 식별자인 플레이어 ID입니다.
getPlayerDetails함수
예
플레이어 세부 정보를 반환하는 함수입니다. 제공된
playerId에 대한 모든 미디어 이벤트 전에 웹 SDK에서 이 콜백 함수를 호출합니다.xdm.eventType오브젝트
아니요
미디어 이벤트 유형. 이 필드를 입력하지 않으면 자동으로
media.sessionStart(으)로 설정됩니다.수동으로 추적된 미디어 세션 만들기 manual
미디어 세션 추적을 수동으로 시작하려면 아래에 설명된 옵션을 사용하여 createMediaSession 메서드를 호출하십시오.
const sessionPromise = alloy("createMediaSession", {
xdm: {
eventType: "media.sessionStart",
mediaCollection: {
playhead: 0,
sessionDetails: {
...
},
qoeDataDetails: {
bitrate: 1000,
startupTime: 1000,
fps: 30,
droppedFrames: 10
}
}
}
});
속성
유형
필수
설명
xdm.eventType오브젝트
아니요
미디어 이벤트 유형. 지정하지 않으면 자동으로
media.sessionStart(으)로 설정됩니다.xdm.mediaCollection.playhead정수
예
현재 플레이헤드입니다.
웹 SDK 태그 확장을 사용하여 미디어 세션 만들기
이 명령과 같은 웹 SDK 태그 확장은 ‘미디어 이벤트 보내기’ 작업 내의 세션 시작 이벤트 형식입니다.
recommendation-more-help
experience-platform-help-collection