DokumentationAnalyticsGuide för direktuppspelande medietjänster

Annonsradbrytning - start

Senast uppdaterad: 29 maj 2026

Skapat för:

  • Developer

Starthändelsen för annonsbrytningen signalerar början på en annonsbrytning. En annonsbrytning är en sekvens med en eller flera annonser. Varje adStart-, adComplete- och adSkip-händelse måste inträffa mellan ett adBreakStart- och adBreakComplete-par, även när en annons spelas upp.

IMPORTANT
Annonshändelser (adStart, adComplete, adSkip) ignoreras utan bokstöd för adBreakStart och adBreakComplete. Utan sådana anges annonsens varaktighet som det huvudsakliga innehållet, vilket påverkar aggregerade rapporteringsdata.

Rekommenderade implementeringstyper

SDK för webben

Anropa sendEvent med eventType: "media.adBreakStart" och det obligatoriska advertisingPodDetails:

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

Skicka annonsbrytningens namn, position och starttid till createAdBreakObject och anropa sedan 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

Skicka annonsbrytningens namn, position och starttid till createAdBreakObject och anropa sedan trackEvent.

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

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

Ring sendMediaEvent med eventType: "media.adBreakStart" och det obligatoriska advertisingPodDetails:

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

Anropa slutpunkten adBreakStart med den nödvändiga advertisingPodDetails:

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

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Skicka annonsbrytningens namn, position och starttid till 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

Skicka annonsbrytningens namn, position och starttid till 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

Skicka en adBreakStart POST till händelsens slutpunkt:

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