Show Menu
TEMAS×

Adobe Media Analytics (SDK 3.x) para la extensión de audio y vídeo

Utilice esta documentación para obtener información sobre la instalación, configuración e implementación del SDK de Adobe Media Analytics (3.x) para la extensión de audio y vídeo (extensión de Media Analytics). Se incluyen las opciones disponibles al utilizar esta extensión para generar una regla, así como ejemplos y vínculos a muestras.
La extensión Media Analytics (MA) agrega el SDK principal de JavaScript Media SDK (SDK Media 3.x). Esta extensión proporciona la funcionalidad para agregar la instancia de seguimiento Media a un sitio o proyecto de Launch. La extensión de MA requiere dos extensiones adicionales:
Esta extensión se implementa con el SDK de Media 3.x, que no es compatible con el SDK de Media 2.x. Si su página ya utiliza el SDK de Media 2.x, utilice Adobe Media Analytics para la extensión de audio y vídeo en lugar de esta extensión.
Después de incluir las tres extensiones mencionadas arriba en su proyecto de Launch, puede continuar de una de las dos maneras siguientes:
  • Use las API de Media desde la aplicación web
  • Incluya o cree una extensión específica del reproductor que asigne eventos específicos del reproductor de medios a las API en la instancia de seguimiento de Media . Esta instancia se expone a través de la extensión de MA.

Instale y configure la extensión de MA

  • Instalar: Para instalar la extensión MA, abra la propiedad de extensión, haga clic en Extensions > Catalog , pase el ratón por encima de la Adobe Media Analytics (3.x SDK) for Audio and Video extensión y haga clic en Install .
  • Configurar: Para configurar la extensión MA, abra la Extensions ficha, pase el ratón sobre la extensión y haga clic en Configure :

Opciones de configuración:

Opción
Descripción
Servidor API de recopilación
Define el servidor de API de Media Collection (póngase en contacto con su representante de Adobe para obtener este servidor)
Versión de la aplicación
La versión del SDK/aplicación del reproductor de medios
Nombre del reproductor
Nombre del reproductor de medios en uso, por ejemplo, "AVPlayer", "HTML5 Player", "Mi reproductor personalizado"
Canal
Propiedad del nombre del canal
Registro de depuración
Habilitar o deshabilitar el registro
Habilitar SSL
Habilitar o deshabilitar el envío de pings a través de HTTPS
Exportar API al objeto de Window
Habilitar o deshabilitar la exportación de las API de Media Analytics al ámbito global
Nombre de variable
Una variable que utiliza para exportar las API de Media Analytics en el objeto window
Recordatorio: La extensión de MA requiere las extensiones de Analytics y de Experience Cloud ID . También debe agregar estas extensiones a la propiedad de extensión y configurarlas.

Uso de la extensión MA

Uso de una página web/aplicación JS

The MA extension exports the Media APIs in the global window object by enabling the "Export APIs to Window Object" setting in the Configuration page. Exporta las API bajo el nombre de la variable configurada. For example, if the variable name is configured to be ADB , then Media APIs can be accessed by window.ADB.Media .
La extensión de MA exporta las API solo cuando window["CONFIGURED_VARIABLE_NAME"] no está definido y tampoco anula las variantes existentes.
  1. API de medios:   window["CONFIGURED_VARIABLE_NAME"].Media
  2. Crear instancia de rastreador de medios:   window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
    Valor devuelto: Instancia de Media rastreador para rastrear una sesión de medios.
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
    
  3. Con la instancia de Media Tracker, siga la documentación de la API de JS para implementar el seguimiento de medios.
Puede obtener el reproductor de muestra aquí: Reproductor de muestra MA . El reproductor de muestra actúa como referencia para exhibir cómo utilizar la extensión MA para admitir Media Analytics directamente desde una aplicación web.

Uso de otras extensiones

La extensión MA expone media como módulo compartido a otras extensiones. (Para obtener más información sobre los módulos compartidos, consulte Shared Modules documentation .)
Solo se puede acceder a los módulos compartidos desde otras extensiones. That is, a webpage/JavaScript app cannot access the shared modules, or use turbine (see code sample below) outside of an extension.
  1. API de medios: media módulo compartido
  2. Cree la instancia de Media Tracker de la siguiente manera:
    Valor devuelto: Instancia de Media rastreador para rastrear una sesión de medios.
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
    
  3. Con la instancia de Media Tracker, siga la documentación de la API de JS para implementar el seguimiento de medios.
Prueba:  En esta versión, para probar la extensión debe cargarla en  Adobe Experience Platform Launch , donde tiene acceso a todas las extensiones dependientes.