설명서Analytics스트리밍 미디어 컬렉션 안내서

JavaScript을 사용하여 Media SDK 설치

마지막 업데이트: 2025년 7월 14일
  • 주제:

작성 대상:

  • 사용자
  • 관리자
  • 개발자

이 페이지의 정보에는 웹 독립형 SDK를 설치하고 JavaScript를 설정하는 방법이 설명되어 있습니다.

또는 Media Analytics 확장을 사용하여 Analytics 구현에 설명된 대로 Adobe Media Analytics 확장을 사용하여 Adobe 스트리밍 미디어 컬렉션을 구현할 수 있습니다.

사전 요구 사항

  • 유효한 구성 매개변수 얻기

    이러한 매개변수는 분석 계정을 설정한 후에 Adobe 담당자로부터 얻을 수 있습니다.

  • 미디어 애플리케이션에서 JavaScript용 AppMeasurement 및 Experience Cloud Identity Service 구현

    자세한 내용은 JavaScript를 사용하여 분석 구현 및 Experience Cloud ID 서비스 구현을 참조하십시오.

  • 미디어 플레이어에서 다음 API 포함

    • 플레이어 이벤트에 가입할 API - Media SDK를 사용하려면 이벤트가 플레이어에서 발생할 때 단순 API 세트를 호출해야 합니다.
    • 플레이어 정보를 제공하는 API - 현재 재생 중인 미디어, 광고 및 챕터에 대한 정보가 포함되어 있습니다.

JavaScript 3.x 설정

  1. 다운로드한 라이브러리를 프로젝트에 추가합니다. 편의상 클래스에 대한 로컬 참조를 작성하십시오.

    1. 다운로드한 MediaSDK-js-v3*.zip 파일을 확장합니다.

    2. 다음 MediaSDK.js 파일이 libs 디렉터리에 있는지 확인합니다.

    3. MediaSDK.js 파일을 호스팅합니다.

      이 코어 JavaScript 파일은 사이트의 모든 페이지에 액세스할 수 있는 웹 서버에 호스팅해야 합니다. 다음 단계를 위해 이 파일에 대한 경로가 필요합니다.

    4. 모든 사이트 페이지에서 MediaSDK.js를 참조합니다.

      다음 코드 행을 각 페이지의 MediaSDK 또는 <head> 태그에 추가하여 JavaScript용 <body>를 포함합니다. 예:

      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>

    5. 라이브러리를 성공적으로 가져왔는지를 신속하게 확인하려면 Window 개체에 ADB.Media를 내보냈는지 확인합니다.

      NOTE
      JavaScript SDK는 AMD 및 CommonJS 모듈 사양과 호환되며, MediaSDK.js를 호환 가능한 모듈 로더와 함께 사용할 수도 있습니다.

  2. AppMeasurement의 인스턴스를 만들고 visitor를 구성합니다.

    Media SDK 구성에는 visitor가 구성된 AppMeasurement의 인스턴스가 필요합니다.

     var appMeasurement = new AppMeasurement("<rsid>");
 appMeasurement.visitor = visitor;
 appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";

  3. Media SDK 구성

    Media SDK는 웹 페이지당 한 번 구성해야 하며, 구성은 생성된 모든 추적기 인스턴스에 적용됩니다.

    IMPORTANT
    Media SDK(3.x)는 2.x SDK에 사용된 HB 엔드포인트와 다른 미디어 추적을 위해 Media Collection API를 사용합니다. 자세한 내용은 Adobe 담당자에게 문의하십시오.

    다음은 샘플 MediaConfig 초기화입니다.

     // Create MediaConfig object (same as above)
 var mediaConfig = new ADB.MediaConfig();
 mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT;
 mediaConfig.playerName = Configuration.PLAYER_NAME;
 mediaConfig.channel = Configuration.CHANNEL;
 mediaConfig.appVersion = Configuration.APP_VERSION;
 mediaConfig.debugLogging = false;
 mediaConfig.ssl = true;

 ADB.Media.configure(mediaConfig, appMeasurement);

  4. MediaTracker 인스턴스를 생성합니다.

    Media SDK를 구성한 후 미디어 콘텐츠를 추적하기 위한 추적기 인스턴스를 getInstance API를 사용하여 만들 수 있습니다.

    var tracker = ADB.Media.getInstance();
    IMPORTANT
    미디어 세션이 끝날 때까지 이 인스턴스에 대한 할당이 취소되지 않는지 그리고 tracker 인스턴스가 액세스할 수 있는지 확인하십시오. 이 인스턴스는 해당 세션의 다음 이벤트를 모두 추적하는 데 사용됩니다.

JavaScript 2.x에서 3.x로 마이그레이션

2.x에서 3.x로 마이그레이션에 대한 자세한 정보는 2.x에서 3.x로 마이그레이션을 참조하십시오.

이전 콘텐츠의 경우, 레거시 구현을 참조하십시오.

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