Instalación de Media SDK con JavaScript :headding-anchor:install-web-sdks

La información de esta página describe cómo instalar el SDK web independiente y configurar JavaScript.

También puede usar la extensión de Adobe Medium Analytics para implementar el complemento Recopilación de medios de streaming de Adobe, tal como se describe en Implementar Analytics con la extensión de Media Analytics.

Requisitos previos :headding-anchor:prerequesites

  • Obtener parámetros de configuración válidos

    Estos parámetros se los puede proporcionar un representante de Adobe cuando haya configurado la cuenta de Analytics.

  • Implementación AppMeasurement y Experience Cloud Identity Service para JavaScript en la aplicación multimedia

    Para obtener más información, consulte Implementación de Analytics con JavaScript y Implementación del servicio de identidad de Experience Cloud.

  • Incluya las siguientes API en su reproductor multimedia

    • Una API para suscribirse a eventos del reproductor: Media SDK requiere que llame a un conjunto de API simples cuando se produzcan eventos en el reproductor.
    • Una API que proporciona información sobre el reproductor: incluye información sobre medios, anuncios y capítulos que se están reproduciendo.

Configuración de JavaScript 3.x :headding-anchor:set-up-javascript

  1. Añada la biblioteca descargada al proyecto. Cree referencias locales a las clases para mayor comodidad.

    1. Expanda el archivo MediaSDK-js-v3*.zip que descargó.

    2. Compruebe si el archivo MediaSDK.js existe en el directorio libs.

    3. Aloje el archivo MediaSDK.js.

      Este archivo JavaScript principal debe alojarse en un servidor web al que se pueda acceder desde todas las páginas del sitio. Necesita la ruta a estos archivos para el siguiente paso.

    4. Haga referencia a MediaSDK.js en todas las páginas del sitio.

      Incluya MediaSDK para JavaScript agregando la línea de código siguiente en la etiqueta <head> o <body> de cada página. Por ejemplo:

      code language-html
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>
      
    5. Para verificar rápidamente que la biblioteca se ha importado correctamente, compruebe que ADB.Media se ha exportado en el objeto Window.

      note note
      NOTE
      El SDK de JavaScript es compatible con las especificaciones del módulo AMD y CommonJS, y MediaSDK.js también se puede utilizar con módulos de carga compatibles.
  2. Cree una instancia de AppMeasurement y configure visitor.

    La configuración del SDK de medios requiere una instancia de AppMeasurement con visitor configurado.

    code language-js
     var appMeasurement = new AppMeasurement("<rsid>");
     appMeasurement.visitor = visitor;
     appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
    
  3. Configuración del SDK de medios

    El SDK de medios debe configurarse una vez por página web y la configuración se aplica a todas las instancias del rastreador creadas.

    note important
    IMPORTANT
    El SDK de medios (3.x) utiliza la API de recopilación de medios para el seguimiento de medios, que es diferente del extremo HB utilizado en los SDK 2.x. Póngase en contacto con su representante de Adobe para obtener más información.

    Este es un ejemplo de una inicialización de MediaConfig:

    code language-js
     // 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. Cree la instancia de MediaTracker.

    Después de configurar el SDK de medios, se pueden crear instancias de rastreador para el seguimiento de contenido de medios mediante getInstance de API.

    code language-js
    var tracker = ADB.Media.getInstance();
    
    note important
    IMPORTANT
    Asegúrese de que la instancia de tracker es accesible y no se desasigna hasta el final de la sesión de contenido. Esta instancia se utilizará para el seguimiento de los siguientes eventos para esa sesión.

Migrar de JavaScript 2.x a 3.x

Para obtener información detallada sobre la migración de 2.x a 3.x, consulte Migración de 2.x a 3.x.

Para ver el contenido heredado, consulte Implementaciones heredadas

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