레거시 - Media SDK 설정 개요

비디오 앱 또는 플레이어용 Media SDK를 다운로드한 후 이 섹션의 정보에 따라 Media SDK를 설정하고 구현합니다.

일반 구현 지침

Adobe 스트리밍 미디어 추적에 사용되는 세 가지 기본 SDK 구성 요소가 있습니다.

  • 미디어 하트비트 구성 - MediaHeartbeatConfig 보고를 위한 기본 설정을 포함합니다.
  • 미디어 하트비트 위임 - MediaHeartbeatDelegate 재생 시간 및 QoS 개체를 제어합니다.
  • 미디어 하트비트 - MediaHeartbeat 는 멤버와 메서드가 포함된 기본 라이브러리입니다.

스트리밍 미디어 SDK 구현

스트리밍 미디어 SDK를 설정하고 사용하려면 다음 구현 단계를 완료하십시오.

  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 추적의 경우 이 값은 미디어 항목이 시작된 후 현재까지의 시간(초)으로 지정됩니다.
    라이브 스트리밍의 경우 플레이어가 콘텐츠 지속 시간에 대한 정보를 제공하지 않으면 해당 날짜의 자정(UTC) 이후 경과된 시간(초 수)으로 값을 지정할 수 있습니다.
    참고: 진행률 마커를 사용할 경우 콘텐츠 지속 시간이 필요하며 플레이헤드는 0부터 시작하여 미디어 항목의 시작부터 초 단위로 업데이트해야 합니다.

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

    변수 이름 설명 필수 여부
    bitrate 초당 비트 수 단위의 미디어 비트율.
    startupTime 밀리초 단위의 미디어 시작 시간.
    fps 초당 표시되는 프레임 수.
    droppedFrames 지금까지 드롭된 프레임 수.
  3. MediaHeartbeat 인스턴스를 생성합니다.

    MediaHertbeatConfigMediaHertbeatDelegate를 사용하여 MediaHeartbeat 인스턴스를 생성합니다.

    중요

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

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

  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에서 제공합니다.

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

이 페이지에서는