DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Start der Werbeunterbrechung

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Start-Ereignis für die Werbeunterbrechung signalisiert den Beginn einer Werbeunterbrechung. Eine Werbeunterbrechung ist eine Sequenz aus einer oder mehreren Anzeigen. Jedes adStart-, adComplete- und adSkip-Ereignis muss zwischen einem adBreakStart- und adBreakComplete-Paar auftreten, auch wenn eine einzelne Anzeige abgespielt wird.

IMPORTANT
Anzeigenereignisse (adStart, adComplete, adSkip) werden ohne adBreakStart und adBreakComplete Buchstützen ignoriert. Ohne sie wird die Anzeigendauer der Hauptinhaltsdauer zugeordnet, was sich auf aggregierte Berichtsdaten auswirkt.

Empfohlene Implementierungsarten

Web SDK

Rufen Sie sendEvent mit eventType: "media.adBreakStart" und den erforderlichen advertisingPodDetails auf:

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

Übergeben Sie den Namen, die Position und die Startzeit der Werbeunterbrechung an createAdBreakObject und rufen Sie dann trackEvent auf.

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

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

Übergeben Sie den Namen, die Position und die Startzeit der Werbeunterbrechung an createAdBreakObject und rufen Sie dann trackEvent auf.

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

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

Rufen Sie sendMediaEvent mit eventType: "media.adBreakStart" und den erforderlichen advertisingPodDetails auf:

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

Rufen Sie den adBreakStart-Endpunkt mit dem erforderlichen advertisingPodDetails auf:

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"
    }
  }]
}'

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie den Namen, die Position und die Startzeit der Werbeunterbrechung an 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

Übergeben Sie den Namen, die Position und die Startzeit der Werbeunterbrechung an 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);
Media Collection API

Senden eines adBreakStart POST an den events-Endpunkt:

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