DocumentaciónAnalyticsGuía de servicios de medios de streaming

Tipo de carga de anuncio

Última actualización: 4 de junio de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Tipo de carga de anuncio. Consulte Cargas de publicidad para la dimensión de informe correspondiente.

style
shade-box

La variable de tipo de carga de anuncio identifica el tipo de anuncio cargado al principio de la sesión. El sistema de entrega de anuncios interno de su organización define este valor, que no se limita a una enumeración estándar. Puede utilizar cualquier cadena que sea significativa para su implementación, como "linear", "dynamic" o "programmatic".

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

Tipos de implementación recomendados

SDK web

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

code language-javascript 
alloy("createMediaSession", {
  xdm: {
    eventType: "media.sessionStart",
    mediaCollection: {
      sessionDetails: {
        name: "video-123",
        friendlyName: "My Video",
        length: 300,
        contentType: "vod",
        playerName: "HTML5 Player",
        channel: "Sports",
        adLoad: "linear"
      },
      playhead: 0
    }
  }
});
iOS

Pase el tipo de carga de publicidad como clave de metadatos en el argumento del diccionario a trackSessionStart. Utilice MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-swift 
var videoMetadata: [String: String] = [:]
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

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

Pase el tipo de carga de publicidad como clave de metadatos en el argumento HashMap a trackSessionStart. Utilice MediaConstants.VideoMetadataKeys.AD_LOAD.

code language-kotlin 
val videoMetadata = HashMap<String, String>()
videoMetadata[MediaConstants.VideoMetadataKeys.AD_LOAD] = "linear"

tracker.trackSessionStart(mediaInfo, videoMetadata)
Roku

Use createMediaSession para establecer adLoad dentro de sessionDetails:

code language-brightscript 
m.aepSdk.createMediaSession({
    "xdm": {
        "eventType": "media.sessionStart",
        "mediaCollection": {
            "sessionDetails": {
                "adLoad": "linear"
            },
            "playhead": 0
        }
    }
})
API de Media Edge

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

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pasar el tipo de carga de anuncio en el objeto contextData mediante ADB.Media.VideoMetadataKeys.AdLoad:

code language-javascript 
var contextData = {};
contextData[ADB.Media.VideoMetadataKeys.AdLoad] = "linear";

tracker.trackSessionStart(mediaInfo, contextData);
Chromecast

Use ADBMobile.media.VideoMetadataKeys.AD_LOAD para establecer el tipo de carga de anuncio en la propiedad StandardMediaMetadata del objeto de medios antes de llamar a trackSessionStart:

code language-javascript 
var mediaInfo = ADBMobile.media.createMediaObject("My Video", "video-123", 300,
  ADBMobile.media.StreamType.VOD, ADBMobile.media.MediaType.Video);
var standardMetadata = {};
standardMetadata[ADBMobile.media.VideoMetadataKeys.AD_LOAD] = "linear";
mediaInfo[ADBMobile.media.MediaObjectKey.StandardMediaMetadata] = standardMetadata;
ADBMobile.media.trackSessionStart(mediaInfo, null);
API de recopilación de medios

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

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

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

recommendation-more-help
media-analytics-help