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)
Edge 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);
Roku 2.x

Crea un oggetto di interruzione pubblicitaria con adb_media_init_adbreakinfo, quindi tieni traccia dell’evento. Prendere nota dell’ordine dei parametri Roku: name, startTime, position.

code language-brightscript 
adb = ADBMobile()
adBreakInfo = adb_media_init_adbreakinfo("pre-roll", 0.0, 1)  ' name, startTime, position

adb.mediaTrackEvent(adb.MEDIA_AD_BREAK_START, 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