HTML5용 Google 동적 광고 삽입 (DAI) SDK는 SIMID (Secure Interactive Media Interface Definition) 버전 1.1을 지원합니다. 이 가이드에서는 DAI SDK에서 지원하는 특정 SIMID 기능과 메시지를 다룹니다.
광고 소재에서 플레이어에게 보내는 메시지 이해하기
다음 표에는 SIMID 광고 소재가 IMA DAI에 전송할 수 있는 메시지가 나와 있습니다.
| 메시지 | 설명 |
|---|---|
clickThru |
DAI SDK는 DAI 광고 태그에 구성된 클릭연결 추적 URL을 핑합니다. DAI SDK는 광고 소재에서 제공하는 맞춤 URI 또는 탐색 옵션을 무시합니다. |
getMediaState |
currentTime, duration, volume, muted, paused, fullscreen 속성을 포함하여 미디어 플레이어의 현재 상태를 반환합니다. DAI는 서버 측 스티칭 스트림을 사용하므로 currentSrc 속성은 항상 null를 반환합니다. |
log |
문제 해결을 위해 광고 소재 로그 메시지를 DAI SDK 디버그 콘솔 로깅으로 전달합니다. |
reportTracking |
DAI SDK가 광고 소재의 추적 URL을 핑하도록 요청합니다. |
requestPause |
DAI SDK가 미디어 플레이어를 일시중지하도록 요청합니다. |
requestPlay |
DAI SDK가 미디어 플레이어에서 재생을 재개하도록 요청합니다. |
requestSkip |
DAI SDK가 현재 광고를 건너뛰도록 요청합니다. VOD 스트림에만 지원됩니다. 광고 소재가 라이브 스트림에 대해 이 메시지를 전송하는 경우 거부됩니다. |
지원되지 않는 광고 소재에서 플레이어에게 전송된 메시지 검토
DAI SDK는 다음 CreativeMessage 유형을 처리하지 않습니다.
fatalErrorrequestChangeAdDurationrequestFullscreenrequestExitFullscreenhandleSkipShownrequestFocusrequestNavigation: 항상 거부됩니다. 플레이어는 광고 소재가 탐색을 처리할 것으로 예상합니다.requestResize: 항상 거부됩니다. DAI SDK는 광고 소재 크기 조정을 지원하지 않습니다.requestStop: 항상 거부됩니다. 이 유형은 DAI에서 지원하지 않는 긴 기간 사용 사례를 위한 것입니다.requestChangeVolume: DAI SDK가 이 이벤트를 성공적으로 해결하지만 광고 소재의 볼륨 변경을 실행하지 않습니다.
플레이어-광고 소재 메시지 이해하기
다음 표에는 DAI SDK가 SIMID 광고 소재로 전송할 수 있는 메시지가 나와 있습니다.
| 메시지 | 설명 |
|---|---|
init |
환경 데이터 및 광고 매개변수와 함께 세션 설정 중에 전송됩니다. |
startCreative |
광고 소재에 광고 소재 iframe을 시작하고 표시하도록 알립니다. |
adStopped |
광고 세션이 종료되었음을 알립니다(이유 코드 포함). |
adSkipped |
사용자 또는 DAI SDK가 광고를 건너뛰었음을 광고 소재에 알립니다. VOD 스트림에만 지원됩니다. |
지원되지 않는 플레이어의 광고 소재 메시지 검토
DAI SDK는 광고 소재에 다음 메시지를 지원하거나 전송하지 않습니다.
resizeappBackgroundedappForegroundedlog
미디어 상태 업데이트 검토
DAI SDK는 다음 이벤트에 대해 mediaStateUpdate 메시지를 광고 소재에 전송합니다.
playpausestalled(버퍼링 중)seekingseekedtimeupdate(주기적으로)volumechange(음소거 상태 포함)
DAI SDK는 다음 이벤트를 지원하지 않으며 이벤트가 발생할 때 미디어 상태 업데이트를 전송하지 않습니다.
endeddurationchangeerror