레거시 - Media SDK 설정 개요
작성 대상:
- 사용자
- 관리자
- 개발자
비디오 앱 또는 플레이어용 Media SDK를 다운로드한 후 이 섹션의 정보에 따라 Media SDK를 설정하고 구현합니다.
일반 구현 지침
스트리밍 미디어 컬렉션을 사용한 추적에 사용되는 세 가지 주요 SDK 구성 요소는 다음과 같습니다.
- 미디어 하트비트 구성 -
MediaHeartbeatConfig
에는 보고할 기본 설정이 포함되어 있습니다. - 미디어 하트비트 위임 -
MediaHeartbeatDelegate
는 재생 시간 및 QoS 개체를 제어합니다. - 미디어 하트비트 -
MediaHeartbeat
는 구성원 및 메서드가 포함된 기본 라이브러리입니다.
Streaming Media SDK 구현
Streaming Media SDK를 설정하고 사용하려면 다음 구현 단계를 완료합니다.
-
MediaHeartbeatConfig
인스턴스를 생성하고 매개 변수 값을 구성합니다.변수 이름설명필수 여부기본값trackingServer
미디어 분석을 위한 추적 서버입니다. 분석 추적 서버와 다릅니다.예빈 문자열channel
채널 이름아니요빈 문자열ovp
콘텐츠가 배포되는 온라인 미디어 플랫폼의 이름입니다.아니요빈 문자열appVersion
미디어 플레이어 앱/SDK의 버전입니다.아니요빈 문자열playerName
사용 중인 미디어 플레이어의 이름입니다. 예: "AVPlayer", "HTML5 Player", "My Custom Player"아니요빈 문자열ssl
호출이 HTTPS를 통해 수행되야 하는지 여부를 나타냅니다.아니요falsedebugLogging
디버그 로깅이 사용되는지 여부를 나타냅니다.아니요false -
MediaHeartbeatDelegate
를 구현합니다.메서드 이름설명필수 여부getQoSObject()
현재 QoS 정보가 포함된MediaObject
인스턴스를 반환합니다. 이 메서드는 재생 세션 중에 여러 번 호출됩니다. 플레이어 구현은 항상 최근에 사용 가능한 QoS 데이터를 반환해야 합니다.예getCurrentPlaybackTime()
플레이헤드의 현재 위치를 반환합니다.
VOD 추적의 경우 이 값은 미디어 항목이 시작된 후 현재까지의 시간(초)으로 지정됩니다.
라이브 스트리밍의 경우 플레이어가 콘텐츠 지속 시간에 대한 정보를 제공하지 않으면 해당 날짜의 자정(UTC) 이후 경과된 시간(초 수)으로 값을 지정할 수 있습니다.
참고: 진행률 마커를 사용할 경우 콘텐츠 지속 시간이 필요하며 플레이헤드는 0부터 시작하여 미디어 항목의 시작부터 초 단위로 업데이트해야 합니다.예TIP
QoS(서비스 품질) 개체는 선택 사항입니다. 플레이어에 대해 QoS 데이터를 사용할 수 있고 해당 데이터를 추적하려는 경우 다음 변수가 필요합니다.변수 이름설명필수 여부bitrate
초당 비트 수 단위의 미디어 비트율.예startupTime
밀리초 단위의 미디어 시작 시간.예fps
초당 표시되는 프레임 수.예droppedFrames
지금까지 드롭된 프레임 수.예 -
MediaHeartbeat
인스턴스를 생성합니다.MediaHertbeatConfig
및MediaHertbeatDelegate
를 사용하여MediaHeartbeat
인스턴스를 생성합니다.IMPORTANT
세션이 끝날 때까지 이 인스턴스에 대한 할당이 취소되지 않는지 그리고MediaHeartbeat
인스턴스가 액세스할 수 있는지 확인하십시오. 이 인스턴스는 다음의 모든 미디어 추적 이벤트에 사용됩니다.TIP
Adobe Analytics에 대한 호출을 전송하려면MediaHeartbeat
에AppMeasurement
의 인스턴스가 필요합니다. -
모든 조각을 결합합니다.
다음 샘플 코드는 HTML5 비디오 플레이어에 Adobe의 JavaScript 2.x SDK를 사용합니다.
// Create local references to the heartbeat classes var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate; //Media Heartbeat Config var mediaConfig = new MediaHeartbeatConfig(); mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net"; mediaConfig.playerName = "HTML5 Basic"; mediaConfig.channel = "Video Channel"; mediaConfig.debugLogging = true; mediaConfig.appVersion = "2.0"; mediaConfig.ssl = false; mediaConfig.ovp = ""; // Media Heartbeat Delegate var mediaDelegate = new MediaHeartbeatDelegate(); // Set mediaDelegate CurrentPlaybackTime mediaDelegate.getCurrentPlaybackTime = function() { return video.currentTime; }; // Set mediaDelegate QoSObject - OPTIONAL mediaDelegate.getQoSObject = function() { return MediaHeartbeat.createQoSObject(video.bitrate, video.startuptime, video.fps, video.droppedframes); } // Create mediaHeartbeat instance this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
유효성 검사
Media Analytics 추적 구현에서는 다음 두 가지 유형의 추적 호출을 생성합니다.
-
미디어 및 광고 시작 호출은 Adobe Analytics(AppMeasurement) 서버에 직접 전송됩니다.
-
하트비트 호출은 Media Analytics(하트비트) 추적 서버로 전송되어 처리되고, Adobe Analytics 서버로 전달됩니다.
-
Adobe Analytics(AppMeasurement) 서버
추적 서버 옵션에 대한 자세한 내용은 trackingServer 및 trackingServerSecure 변수를 올바르게 채우기를 참조하십시오.IMPORTANT
RDC 서버로 확인되는 RDC 추적 서버 또는 CNAME은 Experience Cloud 방문자 ID 서비스에 필요합니다.Analytics 추적 서버는 "
.sc.omtrdc.net
"으로 끝나야 하거나 CNAME이어야 합니다. -
Media Analytics(하트비트) 서버
항상 "[your_namespace].hb.omtrdc.net
" 형식입니다. 다음 "[your_namespace]
"의 값은 회사를 지정하며, Adobe에서 제공합니다.
미디어 추적은 모든 플랫폼, 데스크탑 및 모바일에서 동일하게 작동합니다. 오디오 추적은 현재 모바일 플랫폼에서 작동합니다. 모든 추적 호출에 대해 확인해야 하는 몇 가지 주요 범용 변수가 있습니다.