createMediaSession
createMediaSession 명령은 웹 SDK streamingMedia 구성 요소에 속합니다. 이 구성 요소를 사용하여 웹 사이트에서 미디어 세션과 관련된 데이터를 수집할 수 있습니다. 이 구성 요소를 구성하는 방법을 알아보려면 streamingMedia 설명서를 참조하세요.
수집된 데이터에는 미디어 재생, 일시 정지, 완료 및 기타 관련 이벤트에 대한 정보가 포함될 수 있습니다. 수집되면 이 데이터를 適用於串流媒體的 Adobe Analytics(으)로 전송하여 지표를 집계할 수 있습니다. 이 기능은 웹 사이트에서의 미디어 소비 행동을 추적하고 이해하는 포괄적인 솔루션을 제공합니다.
Web SDK에서 미디어 세션을 만드는 방법에는 두 가지가 있습니다.
- 자동으로 추적된 미디어 세션을(를) 사용하면 Web 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(으)로 설정됩니다.xdm.mediaCollection.sessionDetails오브젝트
예
세션 세부 정보 개체입니다.
sessionDetails 개체에는 세션 세부 정보 속성이 포함되어야 합니다. 자세한 내용은 미디어 컬렉션 스키마 설명서를 참조하십시오.수동으로 추적된 미디어 세션 만들기 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.sessionDetails오브젝트
예
세션 세부 정보 개체입니다.
sessionDetails 개체에는 세션 세부 정보 속성이 포함되어야 합니다. 자세한 내용은 미디어 컬렉션 스키마 설명서를 참조하십시오.xdm.mediaCollection.playhead정수
예
현재 플레이헤드입니다.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636