DocumentationAnalyticsGuide des services des médias en streaming

Début de la coupure publicitaire

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

L’événement de début de coupure publicitaire signale le début d’une coupure publicitaire. Une coupure publicitaire est une séquence d’une ou de plusieurs publicités. Chaque événement adStart, adComplete et adSkip doit se produire entre une paire adBreakStart et adBreakComplete, même lorsqu’une seule publicité est lue.

IMPORTANT
Les événements d’annonce (adStart, adComplete, adSkip) sont ignorés sans adBreakStart et adBreakComplete les signets. Sans elles, la durée de l’annonce publicitaire est attribuée à la durée du contenu principal, ce qui affecte les données de rapports agrégées.

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec les eventType: "media.adBreakStart" et les advertisingPodDetails requises :

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

Transmettez le nom, la position et l’heure de début de la coupure publicitaire à createAdBreakObject, puis appelez 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

Transmettez le nom, la position et l’heure de début de la coupure publicitaire à createAdBreakObject, puis appelez trackEvent.

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

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

Appelez sendMediaEvent avec les eventType: "media.adBreakStart" et les advertisingPodDetails requises :

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

Appelez le point d’entrée adBreakStart avec les advertisingPodDetails requises :

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

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez le nom, la position et l’heure de début de la coupure publicitaire à 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

Transmettez le nom, la position et l’heure de début de la coupure publicitaire à 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 Media Collection

Envoyez une adBreakStart POST au point d’entrée événements :

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