설정 개요

다음 지침은 2.x Media SDK에 적용됩니다. Media SDK의 1.x 버전을 구현하는 경우 1.x Media SDK 설명서를 참조하십시오. Primetime 통합 업체의 경우 아래 Primetime Media SDK 설명서​를 참조하십시오.

최소 플랫폼 버전 지원

다음 표에서는 2019년 2월 19일부터 각 SDK에 대해 지원되는 최소 플랫폼 버전에 대해 설명합니다.

일반 구현 지침

다음과 같이 미디어 추적에 관련된 세 가지 기본 SDK 구성 요소가 있습니다.

• 미디어 하트비트 구성 - 이 구성에 보고할 기본 설정이 포함되어 있습니다.
• 미디어 하트비트 위임 - 이 위임은 재생 시간 및 QoS 개체를 제어합니다.
• 미디어 하트비트 - 구성원 및 메서드가 포함된 기본 라이브러리입니다.

다음 구현 단계를 완료합니다.

1. 매개 변수 값을 설정하고 MediaHeartbeatConfig 인스턴스를 작성합니다.

   변수 이름	설명	필수 여부	기본값
   trackingServer	미디어 분석을 위한 추적 서버입니다. 분석 추적 서버와 다릅니다.	예	빈 문자열
   channel	채널 이름	아니오	빈 문자열
   ovp	컨텐츠가 배포되는 온라인 미디어 플랫폼의 이름입니다.	아니오	빈 문자열
   appVersion	미디어 플레이어 앱/SDK의 버전입니다.	아니오	빈 문자열
   playerName	사용 중인 미디어 플레이어의 이름입니다. 예: "AVPlayer", "HTML5 Player", "My Custom Player"	아니오	빈 문자열
   ssl	호출이 HTTPS를 통해 수행되야 하는지 여부를 나타냅니다.	아니오	false
   debugLogging	디버그 로깅이 사용되는지 여부를 나타냅니다.	아니오	false

2. MediaHeartbeatDelegate를 구현합니다.

   메서드 이름	설명	필수 여부
   getQoSObject()	현재 QoS 정보가 포함된 MediaObject 인스턴스를 반환합니다. 이 메서드는 재생 세션 중에 여러 번 호출됩니다. 플레이어 구현은 항상 최근에 사용 가능한 QoS 데이터를 반환해야 합니다.	예
   getCurrentPlaybackTime()	플레이헤드의 현재 위치를 반환합니다. VOD 추적의 경우 이 값은 미디어 항목이 시작된 후 현재까지의 시간(초)으로 지정됩니다. LINEAR/LIVE 추적의 경우 이 값은 해당 날의 자정 UTC 이후 시간(초)으로 지정됩니다.	예

   팁

   QoS(서비스 품질) 개체는 선택 사항입니다. 플레이어에 대해 QoS 데이터를 사용할 수 있고 해당 데이터를 추적하려는 경우 다음 변수가 필요합니다.

   변수 이름	설명	필수 여부
   bitrate	초당 비트 수 단위의 미디어 비트율.	예
   startupTime	밀리초 단위의 미디어 시작 시간.	예
   fps	초당 표시되는 프레임 수.	예
   droppedFrames	지금까지 드롭된 프레임 수.	예

3. MediaHeartbeat 인스턴스를 생성합니다.

   MediaHertbeatConfig 및 MediaHertbeatDelegate를 사용하여 MediaHeartbeat 인스턴스를 생성합니다.

   중요

   세션이 끝날 때까지 이 인스턴스에 대한 할당이 취소되지 않는지 그리고 MediaHeartbeat 인스턴스가 액세스할 수 있는지 확인하십시오. 이 인스턴스는 다음의 모든 미디어 추적 이벤트에 사용됩니다.

   팁

   Adobe Analytics에 대한 호출을 전송하려면 MediaHeartbeat에 AppMeasurement의 인스턴스가 필요합니다.

4. 모든 조각을 결합합니다.

   다음 샘플 코드는 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 변수를 올바르게 채우기를 참조하십시오.

  중요

  RDC 서버로 확인되는 RDC 추적 서버 또는 CNAME은 Experience Cloud 방문자 ID 서비스에 필요합니다.

  Analytics 추적 서버는 ".sc.omtrdc.net"으로 끝나야 하거나 CNAME이어야 합니다.

• Media Analytics(하트비트) 서버
  항상 "[your_namespace].hb.omtrdc.net" 형식입니다. 다음 "[your_namespace]"의 값은 회사를 지정하며, Adobe에서 제공합니다.

미디어 추적은 모든 플랫폼, 데스크탑 및 모바일에서 동일하게 작동합니다. 오디오 추적은 현재 모바일 플랫폼에서 작동합니다. 모든 추적 호출에 대해 확인해야 하는 몇 가지 주요 범용 변수가 있습니다.

SDK 1.x 설명서

Primetime Media SDK 설명서

• Primetime 사용자 안내서