DocumentaciónAnalyticsGuía de servicios de medios de streaming

Inicio de pausa publicitaria

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

El evento de inicio de pausa publicitaria indica el comienzo de una pausa publicitaria. Una pausa para anuncios es una secuencia de uno o más anuncios. Cada evento de adStart, adComplete y adSkip debe producirse entre un par de adBreakStart y adBreakComplete, incluso cuando se reproduce un solo anuncio.

IMPORTANT
Los eventos de anuncio (adStart, adComplete, adSkip) se omiten sin los bookends adBreakStart y adBreakComplete. Sin ellos, la duración del anuncio se atribuye a la duración del contenido principal, que afecta a los datos de informes agregados.

Tipos de implementación recomendados

SDK web

Llamar a sendEvent con eventType: "media.adBreakStart" y el advertisingPodDetails requerido:

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, la posición y la hora de inicio de la pausa publicitaria a createAdBreakObject y luego llame a trackEvent.

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, la posición y la hora de inicio de la pausa publicitaria a createAdBreakObject y luego llame a trackEvent.

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

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

Llamar a sendMediaEvent con eventType: "media.adBreakStart" y el advertisingPodDetails requerido:

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 el elemento advertisingPodDetails requerido:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/adBreakStart?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.adBreakStart",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 0,
        "advertisingPodDetails": {
          "index": 0,
          "offset": 0
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pasar el nombre, la posición y la hora de inicio de la pausa publicitaria a ADB.Media.createAdBreakObject:

code language-javascript 
var adBreakInfo = ADB.Media.createAdBreakObject(
  "pre-roll",  // name
  1,           // position
  0            // start time (seconds)
);

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

Pasar el nombre, la posición y la hora de inicio de la pausa publicitaria a ADBMobile.media.createAdBreakObject:

code language-javascript 
var adBreakInfo = ADBMobile.media.createAdBreakObject(
  "pre-roll",  // name
  1,           // position
  0            // start time (seconds)
);

ADBMobile.media.trackEvent(ADBMobile.media.Event.AdBreakStart, adBreakInfo);
API de recopilación de medios

Enviar un POST de adBreakStart al extremo de eventos:

code language-json 
{
  "playerTime": { "playhead": 0, "ts": 1699523820000 },
  "eventType": "adBreakStart",
  "params": {
    "media.ad.podFriendlyName": "pre-roll",
    "media.ad.podIndex": 1,
    "media.ad.podSecond": 0
  }
}
recommendation-more-help
media-analytics-help