DocumentaciónAnalyticsGuía de servicios de medios de streaming

Longitud de contenido

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Longitud del contenido. Ver Longitud del contenido para la dimensión de informe correspondiente.

style
shade-box

La variable de duración del contenido es la duración total del contenido en segundos. Es obligatorio para todas las implementaciones de medios de streaming y debe configurarse al inicio de la sesión. La longitud del contenido impulsa varias métricas calculadas por el back-end, incluidos los marcadores de progreso (10/25/50/75/95 %) y la audiencia media por minuto. Si la longitud del contenido no está establecida o no es mayor que cero, esas métricas no se generan. Para las transmisiones en vivo de duración desconocida, use 86400 (24 horas).

Propiedad
Valor
Variable de datos de contexto
a.media.length
Campo de colección XDM
xdm.mediaCollection.sessionDetails.length
rasgo de Audience Manager
c_contextdata.a.media.length
Requerido
Sí
Enviado con
Inicio de sesión, cierre de sesión

Tipos de implementación recomendados

SDK web

Establecer length dentro de xdm.mediaCollection.sessionDetails al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        length: 128,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        streamType: "video"
      },
      playhead: 0
    }
  }
});
iOS

Pase la duración del contenido en segundos como el argumento length a createMediaObject.

code language-swift 
let mediaObject = Media.createMediaObjectWith(name: "My Video",
                                                id: "video-123",
                                            length: 128,
                                        streamType: MediaConstants.StreamType.VOD,
                                         mediaType: MediaType.Video)

tracker.trackSessionStart(info: mediaObject, metadata: nil)
Android

Pase la duración del contenido en segundos como el argumento length a createMediaObject.

code language-kotlin 
var mediaInfo = Media.createMediaObject("My Video",
                                        "video-123",
                                        128,
                                        MediaConstants.StreamType.VOD,
                                        Media.MediaType.Video)

tracker.trackSessionStart(mediaInfo, null)
Roku

Establecer length dentro de xdm.mediaCollection.sessionDetails al llamar a createMediaSession:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "name": "video-123",
                "friendlyName": "My Video",
                "length": 128,
                "contentType": "vod",
                "playerName": "Roku Player",
                "channel": "Sports",
                "streamType": "video"
            },
            "playhead": 0
        }
    }
})
API de Media Edge

Llame al extremo sessionStart con length dentro de xdm.mediaCollection.sessionDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.sessionStart",
      "mediaCollection": {
        "sessionDetails": {
          "name": "video-123",
          "length": 128,
          "contentType": "vod",
          "playerName": "HTML5 Player",
          "channel": "Sports"
        },
        "playhead": 0
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la duración del contenido en segundos como tercer argumento a ADB.Media.createMediaObject:

code language-javascript 
var mediaInfo = ADB.Media.createMediaObject(
  "My Video",
  "video-123",
  128,                      // length in seconds
  ADB.Media.StreamType.VOD,
  ADB.Media.MediaType.Video
);

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Pase la duración del contenido en segundos como tercer argumento a ADBMobile.media.createMediaObject:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject(
  "My Video",
  "video-123",
  128,
  ADBMobile.media.StreamType.VOD,
  ADBMobile.media.MediaType.Video
);
ADBMobile.media.trackSessionStart(mediaInfo, null);
API de recopilación de medios

Incluir media.length en el objeto params de su solicitud POST de sessionStart:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "sessionStart",
  "params": {
    "media.length": 128
  }
}

Consulte la referencia de sesiones de la API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help