Show Menu
TOPICS×

Información general de configuración

Las siguientes instrucciones se aplican a Media SDK 2.x. Si va a implementar la versión 1.x del Media SDK, consulte la documentación del Media SDK 1.x. Para integradores de Primetime, consulte
Documentación de Media SDK de Primetime
a continuación.

Compatibilidad con versiones con la plataforma mínima requerida

En la tabla siguiente se describen las versiones de plataforma mínimas admitidas para cada SDK a partir del 19 de febrero de 2019.
OS/Browser
Versión mínima requerida
iOS
iOS 6+
Android
Android 5.0+ - Lollipop
Chrome
v22+
Mozilla
v27+
Safari
v7+
IE
v11+

Directrices generales de implementación

En el seguimiento de medios, existen tres componentes de SDK principales:
  • Configuración de Media Heartbeat: la configuración contiene la configuración básica de los informes.
  • Delegado de Media Heartbeat: el delegado controla el tiempo de reproducción y el objeto QoS.
  • Media Heartbeat: biblioteca principal que contiene miembros y métodos.
Complete los pasos siguientes de la implementación:
  1. Cree una instancia de
    MediaHeartbeatConfig
    y establezca los valores de configuración de parámetros.
     Nombre de variable 
    Descripción 
    Requerido
     Valor predeterminado 
    trackingServer
    Servidor de seguimiento para el análisis de medios. Es distinto del servidor de seguimiento de Analytics.
    Cadena vacía
    channel
    Nombre del canal
    No
    Cadena vacía
    ovp
    Nombre de la plataforma de medios en línea desde la que se distribuye el contenido.
    No
    Cadena vacía
    appVersion
    Versión del SDK/aplicación del reproductor de medios
    No
    Cadena vacía
    playerName
    Nombre del reproductor de medios en uso, por ejemplo, “AVPlayer”, “HTML5 Player”, “Mi reproductor personalizado”.
    No
    Cadena vacía
    ssl
    Indica si las llamadas se deberían hacer mediante HTTPS.
    No
    false
    debugLogging
    Indica si el registro de depuración está habilitado.
    No
    false
  2. Implementación de
    MediaHeartbeatDelegate
    .
     Nombre del método 
     Descripción 
    Requerido
    getQoSObject()
    Devuelve la instancia de
    MediaObject
    que contiene la información actual de QoS. Se llamará varias veces a este método durante una sesión de reproducción. La implementación del reproductor debe devolver siempre los datos de QoS más recientes que haya disponibles.
    getCurrentPlaybackTime()
    Devuelve la posición actual del cabezal de reproducción. Para el seguimiento de vídeos VOD, el valor se especifica segundos después del comienzo del contenido multimedia. Para el seguimiento LINEAR/LIVE, el valor se especifica segundos después del principio del programa.
    El objeto de calidad de servicio (QoS) es opcional. Si los datos de QoS están disponibles para su reproductor y desea realizar un seguimiento de dichos datos, es necesario el uso de las variables siguientes:
    Nombre de variable
    Descripción  
    Requerido
    bitrate
    La velocidad de bits del contenido multimedia en bits por segundo.
    startupTime
    Tiempo de inicio del contenido en milisegundos.
    fps
    Fotogramas mostrados por segundo.
    droppedFrames
    El número de fotogramas perdidos.
  3. Cree la instancia de
    MediaHeartbeat
    .
    Utilice
    MediaHertbeatConfig
    y
    MediaHertbeatDelegate
    para crear la instancia
    MediaHeartbeat
    .
    Asegúrese de que la instancia de
    MediaHeartbeat
    es accesible y no se desasigna hasta el final de la sesión. Esta instancia se utilizará para todos los eventos de seguimiento de medios posteriores.
    MediaHeartbeat
    requiere una instancia de
    AppMeasurement
    para enviar llamadas a Adobe Analytics.
  4. Combine todos los fragmentos.
    El siguiente código de ejemplo utiliza nuestro SDK de JavaScript 2.x para un reproductor de vídeo HTML5:
    // Create local references to the heartbeat classes var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate; //Media Heartbeat Config var mediaConfig = new MediaHeartbeatConfig(); mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net"; mediaConfig.playerName = "HTML5 Basic"; mediaConfig.channel = "Video Channel"; mediaConfig.debugLogging = true; mediaConfig.appVersion = "2.0"; mediaConfig.ssl = false; mediaConfig.ovp = ""; // Media Heartbeat Delegate var mediaDelegate = new MediaHeartbeatDelegate(); // Set mediaDelegate CurrentPlaybackTime mediaDelegate.getCurrentPlaybackTime = function() { return video.currentTime; }; // Set mediaDelegate QoSObject - OPTIONAL mediaDelegate.getQoSObject = function() { return MediaHeartbeat.createQoSObject(video.bitrate, video.startuptime, video.fps, video.droppedframes); } // Create mediaHeartbeat instance this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);

Validación

Las implementaciones de seguimiento de Media Analytics generan dos tipos de llamadas de seguimiento:
  • Las llamadas de inicio de contenido y anuncio se envían directamente al servidor de Adobe Analytics (AppMeasurement).
  • Las llamadas de Heartbeat se envían al servidor de seguimiento de Media Analytics (latidos), se procesan y se pasan al servidor de Adobe Analytics.
  • Servidor de Adobe Analytics (AppMeasurement)
    Para obtener más información sobre las opciones del servidor de seguimiento, consulte Rellenar correctamente las variables trackingServer y trackingServerSecure.
    Es necesario un servidor de seguimiento RDC o CNAME que se resuelva en un servidor RDC para el servicio ID de visitante de Experience Cloud.
    El servidor de seguimiento de análisis debe finalizar en “
    .sc.omtrdc.net
    ” o ser CNAME.
  • ** Servidor de Media Analytics (latidos)** Siempre tiene el formato “
    [your_namespace].hb.omtrdc.net
    ”. El valor de “
    [your_namespace]
    ” especifica su empresa y lo proporciona Adobe.
El seguimiento de medios funciona del mismo modo en todas las plataformas, equipos de escritorio y dispositivos móviles. Actualmente, el seguimiento de audio funciona en plataformas móviles. En todas las llamadas de seguimiento hay algunas variables universales clave que se deben validar:

Documentación de SDK 1.x

SDK de Video Analytics 1.x 
 Guías para desarrolladores (solo PDF)
Android
Apple TV
Chromecast
iOS
JavaScript
Primetime
TVML

Documentación del Media SDK de Primetime