DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Begin van einde toevoegen

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

De gebeurtenis start ad break geeft het begin van een ad-break aan. Een advertentie-einde is een reeks van een of meer advertenties. Elke gebeurtenis adStart, adComplete en adSkip moet plaatsvinden tussen een adBreakStart en adBreakComplete paar, zelfs wanneer één advertentie wordt afgespeeld.

IMPORTANT
Ad-gebeurtenissen ( adStart , adComplete , adSkip ) worden genegeerd zonder adBreakStart - en adBreakComplete -boekensteunen. Zonder deze gegevens wordt de duur van de advertentie toegeschreven aan de duur van de hoofdinhoud, wat van invloed is op de geaggregeerde rapportagegegevens.

Aanbevolen implementatietypen

SDK van het Web

Roep sendEvent ​ met eventType: "media.adBreakStart" en de vereiste advertisingPodDetails aan:

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

Geef de naam, de positie en de begintijd van het advertentieeinde door aan createAdBreakObject en roep vervolgens trackEvent aan.

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

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

Geef de naam, de positie en de begintijd van het advertentieeinde door aan createAdBreakObject en roep vervolgens trackEvent aan.

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

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

Roep sendMediaEvent aan met eventType: "media.adBreakStart" en de vereiste 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

Roep het ​ adBreakStart ​ eindpunt met vereiste 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"
    }
  }]
}'

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Geef de naam, de positie en de begintijd van het advertentieeinde door aan 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

Geef de naam, de positie en de begintijd van het advertentieeinde door aan 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);
de Inzameling API van Media

Verzend een adBreakStart POST naar het ​ gebeurteniseindpunt ​:

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