DocumentaciónAnalyticsGuía de servicios de medios de streaming

Nombre de pausa publicitaria

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Nombre del salto de anuncio. Ver Nombre de secuencia para la dimensión de informe correspondiente.

style
shade-box

La variable del nombre de la pausa publicitaria es el nombre descriptivo de la pausa publicitaria (por ejemplo, "pre-roll", "mid-roll-1", "post-roll"). El valor se establece en el objeto de pausa publicitaria, no en anuncios individuales.

Propiedad
Valor
Variable de datos de contexto
a.media.ad.podFriendlyName
Campo de colección XDM
xdm.mediaCollection.advertisingPodDetails.friendlyName
rasgo de Audience Manager
c_contextdata.a.media.ad.podFriendlyName
Requerido
Sí (Mobile SDK); No (Edge, API de recopilación de medios)
Enviado con
Inicio de la pausa publicitaria, cierre del anuncio

Tipos de implementación recomendados

SDK web

Establecer friendlyName dentro de xdm.mediaCollection.advertisingPodDetails al llamar a sendEvent para media.adBreakStart:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.adBreakStart",
    mediaCollection: {
      advertisingPodDetails: {
        friendlyName: "pre-roll",
        index: 1,
        offset: 0
      },
      sessionID: "{sid}",
      playhead: 0
    }
  }
});
iOS

Pase el nombre de la pausa publicitaria como el primer argumento (name) a createAdBreakObject y, a continuación, realice un seguimiento del evento de inicio de la pausa publicitaria antes del evento de inicio de la misma.

code language-swift 
let adBreakObject = Media.createAdBreakObjectWith(name: "pre-roll",
                                              position: 1,
                                             startTime: 0)

tracker.trackEvent(event: MediaEvent.AdBreakStart, info: adBreakObject, metadata: nil)
Android

Pase el nombre de la pausa publicitaria como el primer argumento (name) a createAdBreakObject y, a continuación, realice un seguimiento del evento de inicio de la pausa publicitaria antes del evento de inicio de la misma.

code language-kotlin 
val adBreakObject = Media.createAdBreakObject("pre-roll",
                                              1L,
                                              0.0)

tracker.trackEvent(Media.Event.AdBreakStart, adBreakObject, null)
Roku

Establecer friendlyName dentro de xdm.mediaCollection.advertisingPodDetails al llamar a sendMediaEvent para media.adBreakStart:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.adBreakStart",
        "mediaCollection": {
            "advertisingPodDetails": {
                "friendlyName": "pre-roll",
                "index": 1,
                "offset": 0
            },
            "playhead": 0
        }
    }
})
API de Media Edge

Llame al extremo adBreakStart con friendlyName dentro de xdm.mediaCollection.advertisingPodDetails:

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.adBreakStart",
      "mediaCollection": {
        "advertisingPodDetails": {
          "friendlyName": "pre-roll",
          "index": 1,
          "offset": 0
        },
        "sessionID": "{sid}",
        "playhead": 0
      }
    }
  }]
}

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase el nombre de la pausa publicitaria como primer argumento a ADB.Media.createAdBreakObject:

code language-javascript 
var adBreakInfo = ADB.Media.createAdBreakObject(
  "pre-roll",
  1,
  0
);

tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakInfo, null);
Chromecast

Pase el nombre de la pausa publicitaria como primer argumento a ADBMobile.media.createAdBreakObject:

code language-javascript 
var adBreakInfo = ADBMobile.media.createAdBreakObject(
  "pre-roll",
  1,
  0
);
ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakStart, adBreakInfo);
API de recopilación de medios

Incluir media.ad.podFriendlyName en el objeto params de su solicitud POST de adBreakStart:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adBreakStart",
  "params": {
    "media.ad.podFriendlyName": "pre-roll"
  }
}

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

recommendation-more-help
media-analytics-help