레거시 - Media SDK 설정 개요 setup-overview

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

일반 구현 지침 general-implementation-guidelines

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

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

Streaming Media SDK 구현

Streaming Media SDK를 설정하고 사용하려면 다음 구현 단계를 완료합니다.

  1. MediaHeartbeatConfig 인스턴스를 생성하고 매개 변수 값을 구성합니다.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center
    변수 이름 설명 필수 여부 기본값
    trackingServer 미디어 분석을 위한 추적 서버입니다. 분석 추적 서버와 다릅니다. 빈 문자열
    channel 채널 이름 아니요 빈 문자열
    ovp 콘텐츠가 배포되는 온라인 미디어 플랫폼의 이름입니다. 아니요 빈 문자열
    appVersion 미디어 플레이어 앱/SDK의 버전입니다. 아니요 빈 문자열
    playerName 사용 중인 미디어 플레이어의 이름입니다. 예: "AVPlayer", "HTML5 Player", "My Custom Player" 아니요 빈 문자열
    ssl 호출이 HTTPS를 통해 수행되야 하는지 여부를 나타냅니다. 아니요 false
    debugLogging 디버그 로깅이 사용되는지 여부를 나타냅니다. 아니요 false
  2. MediaHeartbeatDelegate를 구현합니다.

    table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center
    메서드 이름 설명 필수 여부
    getQoSObject() 현재 QoS 정보가 포함된 MediaObject 인스턴스를 반환합니다. 이 메서드는 재생 세션 중에 여러 번 호출됩니다. 플레이어 구현은 항상 최근에 사용 가능한 QoS 데이터를 반환해야 합니다.
    getCurrentPlaybackTime() 플레이헤드의 현재 위치를 반환합니다.
    VOD 추적의 경우 이 값은 미디어 항목이 시작된 후 현재까지의 시간(초)으로 지정됩니다.
    라이브 스트리밍의 경우 플레이어가 콘텐츠 지속 시간에 대한 정보를 제공하지 않으면 해당 날짜의 자정(UTC) 이후 경과된 시간(초 수)으로 값을 지정할 수 있습니다.
    참고: 진행률 마커를 사용할 경우 콘텐츠 지속 시간이 필요하며 플레이헤드는 0부터 시작하여 미디어 항목의 시작부터 초 단위로 업데이트해야 합니다.
    note tip
    TIP
    QoS(서비스 품질) 개체는 선택 사항입니다. 플레이어에 대해 QoS 데이터를 사용할 수 있고 해당 데이터를 추적하려는 경우 다음 변수가 필요합니다.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    변수 이름 설명 필수 여부
    bitrate 초당 비트 수 단위의 미디어 비트율.
    startupTime 밀리초 단위의 미디어 시작 시간.
    fps 초당 표시되는 프레임 수.
    droppedFrames 지금까지 드롭된 프레임 수.
  3. MediaHeartbeat 인스턴스를 생성합니다.

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

    note important
    IMPORTANT
    세션이 끝날 때까지 이 인스턴스에 대한 할당이 취소되지 않는지 그리고 MediaHeartbeat 인스턴스가 액세스할 수 있는지 확인하십시오. 이 인스턴스는 다음의 모든 미디어 추적 이벤트에 사용됩니다.
    note tip
    TIP
    Adobe Analytics에 대한 호출을 전송하려면 MediaHeartbeatAppMeasurement의 인스턴스가 필요합니다.
  4. 모든 조각을 결합합니다.

    다음 샘플 코드는 HTML5 비디오 플레이어에 Adobe의 JavaScript 2.x SDK를 사용합니다.

    code language-javascript
    // 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);
    

유효성 검사 validate

Media Analytics 추적 구현에서는 다음 두 가지 유형의 추적 호출을 생성합니다.

  • 미디어 및 광고 시작 호출은 Adobe Analytics(AppMeasurement) 서버에 직접 전송됩니다.

  • 하트비트 호출은 Media Analytics(하트비트) 추적 서버로 전송되어 처리되고, Adobe Analytics 서버로 전달됩니다.

  • Adobe Analytics(AppMeasurement) 서버
    추적 서버 옵션에 대한 자세한 내용은 trackingServer 및 trackingServerSecure 변수를 올바르게 채우기를 참조하십시오.

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

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

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

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

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb