Instalación de Media Analytics mediante JavaScript

Última actualización: 2023-05-15
  • Creado para:
  • User
    Admin
    Developer

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

Como alternativa, puede utilizar la extensión de Adobe Media Analytics para implementar Analytics, tal como se describe en Implementación de Analytics mediante la extensión de Media Analytics.

Requisitos previos

  • 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

  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:

      <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.

      NOTA

      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.

     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.

    IMPORTANTE

    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:

     // 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.

    var tracker = ADB.Media.getInstance();
    IMPORTANTE

    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

Página anterior
Next page

En esta página