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
yExperience Cloud Identity Service
para JavaScript en la aplicación multimediaPara 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
-
Añada la biblioteca descargada al proyecto. Cree referencias locales a las clases para mayor comodidad.
-
Expanda el archivo
MediaSDK-js-v3*.zip
que descargó. -
Compruebe si el archivo
MediaSDK.js
existe en el directoriolibs
. -
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.
-
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>
-
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.
-
-
Cree una instancia de
AppMeasurement
y configurevisitor
.La configuración del SDK de medios requiere una instancia de
AppMeasurement
convisitor
configurado.code language-js var appMeasurement = new AppMeasurement("<rsid>"); appMeasurement.visitor = visitor; appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";
-
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);
-
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