설명서Analytics스트리밍 미디어용 서비스 안내서

광고 브레이크 시작

마지막 업데이트: 2026년 9월 30일

작성 대상:

  • 개발자

광고 브레이크 시작 이벤트는 광고 브레이크를 시작한다는 신호를 보냅니다. 광고 브레이크는 하나 이상의 광고 시퀀스입니다. adStart, adComplete 및 adSkip 이벤트마다 adBreakStart과(와) adBreakComplete 쌍 사이에 발생해야 하며, 단일 광고가 재생되는 경우에도 마찬가지입니다.

IMPORTANT
광고 이벤트(adStart, adComplete, adSkip)는 adBreakStart 및 adBreakComplete 북엔드 없이 무시됩니다. 광고 지속 시간이 없으면 광고 지속 시간은 집계된 보고 데이터에 영향을 주는 기본 콘텐츠 지속 시간으로 인한 것입니다.

권장 구현 유형

웹 SDK

eventType: "media.adBreakStart" 및 필수 advertisingPodDetails(으)로 sendEvent 호출:

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

광고 브레이크 이름, 위치 및 시작 시간을 createAdBreakObject에 전달한 다음 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

광고 브레이크 이름, 위치 및 시작 시간을 createAdBreakObject에 전달한 다음 trackEvent을(를) 호출합니다.

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

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

eventType: "media.adBreakStart" 및 필수 advertisingPodDetails(으)로 sendMediaEvent 호출:

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

필요한 advertisingPodDetails(으)로 adBreakStart 끝점을 호출합니다.

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

이전 구현 유형(Analytics 전용)

Media SDK JS 3.x

광고 브레이크 이름, 위치 및 시작 시간을 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

광고 브레이크 이름, 위치 및 시작 시간을 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

adb_media_init_adbreakinfo을(를) 사용하여 광고 브레이크 개체를 만든 다음 이벤트를 추적합니다. 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

이벤트 끝점에 adBreakStart POST 보내기:

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