Avvio dell’interruzione pubblicitaria

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.

Web SDK

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

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

Mobile SDK

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

iOS (Swift)

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

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

Android (Cotlino)

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

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

Roku (BrightScript)

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

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

API di Media Edge

Chiama l’endpoint adBreakStart con advertisingPodDetails richiesto:

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

Media SDK

Passa il nome, la posizione e l’ora di inizio dell’interruzione pubblicitaria a ADB.Media.createAdBreakObject:

var adBreakInfo = ADB.Media.createAdBreakObject(
  "pre-roll",  // name
  1,           // position
  0            // start time (seconds)
);

tracker.trackEvent(ADB.Media.Event.AdBreakStart, adBreakInfo, null);

API Media Collection

Invia un POST adBreakStart all’endpoint eventi:

{
  "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