Heredado: Información general sobre la configuración de Media SDK

Después de descargar el Media SDK para su aplicación de vídeo o reproductor, siga la información de esta sección para configurar e implementar el Media SDK.

Directrices generales de implementación

Hay tres componentes principales del SDK que se utilizan en el seguimiento de medios de flujo de Adobe:

  • Configuración de Media Heartbeat: MediaHeartbeatConfig contiene la configuración básica de los informes.
  • Delegado de Media Heartbeat: El MediaHeartbeatDelegate controla el tiempo de reproducción y el objeto QoS.
  • Media Heartbeat: MediaHeartbeat es la biblioteca principal que contiene miembros y métodos.

Implementación del SDK de medios de transmisión

Para configurar y utilizar el SDK de medios de transmisión, complete los siguientes pasos de implementación:

  1. Cree un MediaHeartbeatConfig y establezca los valores de parámetro de configuración.

    Nombre de variable Descripción Requerido Valor predeterminado
    trackingServer Servidor de seguimiento para análisis de medios. Esto es diferente al 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 La versión del SDK/aplicación del reproductor de medios No Cadena vacía
    playerName Nombre del reproductor de medios en uso como "AVPlayer", "HTML5 Player", "Mi reproductor personalizado" No Cadena vacía
    ssl Indica si las llamadas deben realizarse a través de 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 elemento de medios.
    Para el streaming en directo, si el reproductor no proporciona información acerca de la duración del contenido, el valor se puede especificar como el número de segundos desde la medianoche (UTC) de ese día.
    Nota: Cuando se utilizan marcadores de progreso, la duración del contenido es obligatoria y el cabezal de reproducción debe actualizarse como número de segundos desde el principio del elemento de medios, empezando por 0.
    SUGERENCIA

    El objeto de calidad de servicio (QoS) es opcional. Si los datos de QoS están disponibles para el reproductor y desea rastrearlos, se requieren las siguientes variables:

    Nombre de variable Descripción Requerido
    bitrate Velocidad de bits del medio en bits por segundo.
    startupTime Tiempo de activación del inicio del medio en milisegundos.
    fps Los fotogramas mostrados por segundo.
    droppedFrames Número de fotogramas perdidos hasta ahora.
  3. Cree la instancia de MediaHeartbeat.

    Utilice MediaHertbeatConfig y MediaHertbeatDelegate para crear la instancia MediaHeartbeat.

    IMPORTANTE

    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.

    SUGERENCIA

    MediaHeartbeat requiere una instancia de AppMeasurement para enviar llamadas a Adobe Analytics.

  4. Combine todas las piezas.

    El siguiente código de ejemplo utiliza nuestro SDK 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.

    IMPORTANTE

    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:

En esta página