DocumentaciónAnalyticsGuía de servicios de medios de streaming

Posición del anuncio en la secuencia

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Ad in pod position. Ver Posición del anuncio en la secuencia para la dimensión de informe correspondiente.

style
shade-box

La variable de posición del anuncio en la secuencia es la posición indizada cero del anuncio dentro de su salto de anuncio principal. El primer anuncio de un pod tiene el índice 0, el segundo tiene el índice 1, etc. Utilice la dimensión para comparar la participación y la finalización por posición dentro de una pausa publicitaria.

Propiedad
Valor
Variable de datos de contexto
a.media.ad.podPosition
Campo de colección XDM
xdm.mediaCollection.advertisingDetails.podPosition
rasgo de Audience Manager
c_contextdata.a.media.ad.podPosition
Requerido
Sí
Enviado con
Inicio del anuncio, cierre del anuncio

Tipos de implementación recomendados

SDK web

Establecer podPosition dentro de xdm.mediaCollection.advertisingDetails al llamar a sendEvent:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adStart",
    mediaCollection: {
      advertisingDetails: {
        name: "ad-2125",
        podPosition: 0
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Pase la posición como tercer argumento a createAdObject.

code language-swift 
let adObject = Media.createAdObjectWith(name: "Ford F-150",
                                          id: "ad-2125",
                                    position: 0,
                                      length: 15)

tracker.trackEvent(event: MediaEvent.AdStart, info: adObject, metadata: nil)
Android

Pase la posición como tercer argumento a createAdObject.

code language-kotlin 
val adObject = Media.createAdObject("Ford F-150",
                                    "ad-2125",
                                    0L,
                                    15.0)

tracker.trackEvent(Media.Event.AdStart, adObject, null)
Roku

Establecer podPosition dentro de xdm.mediaCollection.advertisingDetails al llamar a sendMediaEvent para media.adStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adStart",
        "mediaCollection": {
            "advertisingDetails": {
                "name": "ad-2125",
                "podPosition": 0,
                "length": 15,
                "playerName": "Roku Player"
            },
            "playhead": 0
        }
    }
})
API de Media Edge

Llame al extremo adStart con podPosition dentro de xdm.mediaCollection.advertisingDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adStart",
      "mediaCollection": {
        "advertisingDetails": {
          "name": "ad-2125",
          "length": 15,
          "playerName": "Freewheel",
          "podPosition": 0
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la posición como tercer argumento a ADB.Media.createAdObject:

code language-javascript 
var adInfo = ADB.Media.createAdObject(
  "Ford F-150",
  "ad-2125",
  0,
  15
);

tracker.trackEvent(ADB.Media.Event.AdStart, adInfo, contextData);
Chromecast

Pase la posición como tercer argumento a ADBMobile.media.createAdObject:

code language-javascript 
var adInfo = ADBMobile.media.createAdObject(
  "Ford F-150",
  "ad-2125",
  1,
  30
);
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdStart, adInfo, null);
API de recopilación de medios

Incluir media.ad.podPosition en el objeto params:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adStart",
  "params": {
    "media.ad.podPosition": 0
  }
}

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

recommendation-more-help
media-analytics-help