DocumentaciónAnalyticsGuía de servicios de medios de streaming

Indicador de medios descargados

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Indicador de medios descargados. Ver Medios descargados para la dimensión de informes correspondiente.

style
shade-box

El indicador de medios descargados indica que una sesión es una reproducción de contenido sin conexión previamente descargado en lugar de un flujo en directo desde Internet. Configúrelo al inicializar el rastreador (Mobile SDK) o inclúyalo en la carga sessionStart (API de recopilación de medios/Edge). Utilice este indicador para separar la reproducción sin conexión de las sesiones transmitidas en los informes.

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

Tipos de implementación recomendados

SDK web

Establecer isDownloaded en true 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",
        isDownloaded: true
      },
      playhead: 0
    }
  }
});
iOS

Establezca la marca de contenido descargado en la configuración del rastreador al crear el rastreador con MediaConstants.TrackerConfig.DOWNLOADED_CONTENT.

code language-swift 
var config: [String: Any] = [:]
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"
config[MediaConstants.TrackerConfig.DOWNLOADED_CONTENT] = true

Media.createTrackerWith(config: config) { tracker in
    self.tracker = tracker
}
Android

Establezca la marca de contenido descargado en la configuración del rastreador al crear el rastreador con MediaConstants.TrackerConfig.DOWNLOADED_CONTENT.

code language-kotlin 
val config = HashMap<String, Any>()
config[MediaConstants.TrackerConfig.PLAYER_NAME] = "HTML5 Player"
config[MediaConstants.TrackerConfig.CHANNEL] = "Sports"
config[MediaConstants.TrackerConfig.DOWNLOADED_CONTENT] = true

val tracker = Media.createTracker(config)
Roku

Establecer isDownloaded en true dentro de xdm.mediaCollection.sessionDetails al llamar a createMediaSession:

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

Llame al extremo downloaded después de que el dispositivo vuelva a estar en línea, agrupando toda la sesión sin conexión dentro de mediaDownloadedEvents. Adobe establece automáticamente isDownloaded en true y asigna un ID de sesión; no incluya ninguno de los dos en la carga útil.

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.downloaded",
      "mediaDownloadedEvents": [
        {
          "mediaEventTimestamp": "YYYY-09-26T15:52:24+00:00",
          "mediaEventType": "media.sessionStart",
          "mediaCollection": {
            "sessionDetails": {
              "name": "video-123",
              "length": 128,
              "contentType": "vod",
              "playerName": "HTML5 Player",
              "channel": "Sports"
            },
            "playhead": 0
          }
        },
        {
          "mediaEventTimestamp": "YYYY-09-26T15:54:32+00:00",
          "mediaEventType": "media.sessionComplete",
          "mediaCollection": {
            "playhead": 128
          }
        }
      ]
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Establezca downloadedContent en ADB.MediaConfig antes de crear el rastreador:

code language-javascript 
var mediaConfig = new ADB.MediaConfig();
mediaConfig.trackingServer = "your.tracking.server";
mediaConfig.playerName = "HTML5 Player";
mediaConfig.channel = "Sports";
mediaConfig.downloadedContent = true;

var tracker = ADB.Media.getInstance(mediaConfig);
Chromecast

Establezca MediaDownloaded en el objeto de información multimedia antes de llamar a trackSessionStart:

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

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

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

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

recommendation-more-help
media-analytics-help