HTML5용 Google 양방향 미디어 광고 (IMA) SDK는 SIMID (Secure Interactive Media Interface Definition) 버전 1.1을 지원합니다. 이 가이드에서는 IMA SDK에서 지원하는 특정 SIMID 기능과 메시지를 다룹니다.
광고 소재-플레이어 메시지 이해
다음 표에는 SIMID 광고 소재가 IMA SDK로 전송할 수 있는 메시지가 나와 있습니다.
| 메시지 | 설명 |
|---|---|
clickThru |
광고 소재에서 제공하는 URI를 기반으로 광고 클릭을 처리합니다. |
fatalError |
광고 세션을 종료하고 광고 소재에서 치명적인 오류를 보고합니다. |
getMediaState |
URI, currentTime, duration, volume, 음소거 상태를 비롯한 미디어 플레이어의 현재 상태를 반환합니다. |
log |
디버깅을 위해 광고 소재 로그 메시지를 IMA SDK로 전달합니다. |
reportTracking |
광고 소재를 대신하여 추적 URL을 핑하도록 IMA SDK에 요청합니다. |
requestChangeAdDuration |
광고 세션의 총 기간을 수정하도록 요청합니다. |
requestNavigation |
외부 URI로 이동하도록 요청합니다. |
requestPause |
IMA SDK에서 미디어 플레이어를 일시중지하도록 요청합니다. |
requestPlay |
IMA SDK에서 미디어 플레이어를 재개하거나 재생하도록 요청합니다. |
requestResize |
동영상 플레이어의 크기를 조절하도록 요청합니다. 플레이어에서 크기 조절을 허용하는 경우 IMA SDK에서 플레이어의 크기를 조절합니다. |
requestSkip |
SDK에서 현재 광고를 건너뛰도록 요청합니다. |
requestStop |
SDK에서 광고 세션을 중지하도록 요청합니다. |
handleSkipShown |
광고 소재에서 광고 건너뛰기 UI를 표시했음을 IMA SDK에 알립니다. |
requestFocus |
광고 소재의 iframe에 포커스를 요청합니다. |
지원되지 않는 광고 소재-플레이어 메시지 검토
IMA SDK는 다음 CreativeMessage 유형을 처리하지 않습니다.
requestChangeVolumerequestFullscreenrequestExitFullscreen
플레이어-광고 소재 메시지 이해
다음 표에는 IMA SDK에서 SIMID 광고 소재로 전송하도록 지원하는 메시지가 나와 있습니다.
| 메시지 | 설명 |
|---|---|
init |
환경 데이터 및 광고 매개변수를 사용하여 세션 설정 중에 전송됩니다. |
startCreative |
광고 소재 iframe을 시작하고 표시하도록 광고 소재에 알립니다. |
adStopped |
이유 코드를 포함하여 광고 세션이 종료되었음을 알립니다. |
adSkipped |
사용자 또는 IMA SDK에서 광고를 건너뛰었음을 광고 소재에 알립니다. |
resize |
플레이어 또는 동영상 크기 변경사항을 광고 소재에 알립니다. |
appBackgrounded |
애플리케이션이 백그라운드로 전환되었음을 광고 소재에 알립니다. |
appForegrounded |
애플리케이션이 포그라운드로 돌아왔음을 광고 소재에 알립니다. |
fatalError |
플레이어 측 오류를 광고 소재에 알립니다. |
log |
플레이어에서 광고 소재로 로그 메시지를 전송합니다. |
focusIn |
광고 소재가 포커스를 받았음을 알립니다. |
미디어 상태 업데이트 검토
IMA SDK는 다음 이벤트에 대해 mediaStateUpdate 메시지를 광고 소재로 전송합니다.
playpausestalled(버퍼링)seekingseekedendeddurationchangetimeupdate(주기적으로)- 음소거 상태를 포함한
volumechange