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, muted 상태를 포함한 미디어 플레이어의 현재 상태를 반환합니다. |
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