DocumentazioneAnalyticsGuida ai servizi Streaming Media

Avvio dell’interruzione pubblicitaria

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

L’evento di inizio dell’interruzione pubblicitaria segnala l’inizio di un’interruzione pubblicitaria. Un’interruzione pubblicitaria è una sequenza di uno o più annunci. Ogni evento adStart, adComplete e adSkip deve verificarsi tra una coppia adBreakStart e adBreakComplete, anche quando viene riprodotto un singolo annuncio.

IMPORTANT
Gli eventi annuncio (adStart, adComplete, adSkip) vengono ignorati senza adBreakStart e adBreakComplete bookend. Senza di essi, la durata dell’annuncio viene attribuita alla durata del contenuto principale, che influisce sui dati di reporting aggregati.

Tipi di implementazione consigliati

Web SDK

Chiama sendEvent con eventType: "media.adBreakStart" e il advertisingPodDetails richiesto:

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

Passa il nome, la posizione e l’ora di inizio dell’interruzione pubblicitaria a createAdBreakObject, quindi chiama 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

Passa il nome, la posizione e l’ora di inizio dell’interruzione pubblicitaria a createAdBreakObject, quindi chiama trackEvent.

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

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

Chiama sendMediaEvent con eventType: "media.adBreakStart" e il advertisingPodDetails richiesto:

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

Chiama l’endpoint adBreakStart con advertisingPodDetails richiesto:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa il nome, la posizione e l’ora di inizio dell’interruzione pubblicitaria a 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

Passa il nome, la posizione e l’ora di inizio dell’interruzione pubblicitaria a 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

Invia un POST adBreakStart all’endpoint eventi:

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