DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Início de ad break

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

O evento de início de ad break sinaliza o início de um ad break. Um ad break é uma sequência de um ou mais anúncios. Cada evento adStart, adComplete e adSkip deve ocorrer entre um par adBreakStart e adBreakComplete, mesmo quando um único anúncio é reproduzido.

IMPORTANT
Eventos de anúncio (adStart, adComplete, adSkip) são ignorados sem adBreakStart e adBreakComplete delimitadores. Sem eles, a duração do anúncio é atribuída à duração do conteúdo principal, que afeta os dados de relatório agregados.

Tipos de implementação recomendados

Web SDK

Chame sendEvent com eventType: "media.adBreakStart" e o advertisingPodDetails necessário:

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

Passe o nome do ad break, a posição e a hora de início para createAdBreakObject, depois chame 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

Passe o nome do ad break, a posição e a hora de início para createAdBreakObject, depois chame trackEvent.

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

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

Chame sendMediaEvent com eventType: "media.adBreakStart" e o(a) advertisingPodDetails necessário(a):

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

Chame o ponto de extremidade adBreakStart com o advertisingPodDetails necessário:

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 implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar o nome do ad break, a posição e a hora de início para 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

Passar o nome do ad break, a posição e a hora de início para 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);
Roku 2.x

Crie um objeto ad break com adb_media_init_adbreakinfo e rastreie o evento. Observe a ordem dos parâmetros Roku: name, startTime, position.

code language-brightscript 
adb = ADBMobile()
adBreakInfo = adb_media_init_adbreakinfo("pre-roll", 0.0, 1)  ' name, startTime, position

adb.mediaTrackEvent(adb.MEDIA_AD_BREAK_START, adBreakInfo)
API da coleção de mídia

Enviar uma POSTAGEM adBreakStart para o ponto de extremidade 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