이 페이지에서는 HTML5 IMA 클라이언트 측 지원 및 브라우저, 동영상 형식, 플랫폼과의 호환성에 관한 일반적인 정보를 제공합니다.
지원되는 동영상 형식 및 브라우저
다양한 기능에 대한 지원은 브라우저마다 다르며 모든 주요 브라우저에서 지원하는 단일 기본 동영상 형식은 없습니다. 대부분의 브라우저에서 사용되는 세 가지 주요 동영상 형식은 H.264, WebM, Ogg Theora입니다.
지원되는 동영상 플레이어
대부분의 IMA 기능은 HTML <video> 태그를 포함한 일반적인 HTML5 동영상 플레이어에서 지원됩니다. IMA SDK를 지원하는 알려진 동영상 플레이어 목록은 동영상 기술 파트너 프로그램을 참고하세요.
VAST 이벤트 호환성
이 섹션에는 VAST 응답에서 반환된 정보를 기반으로 서버에 자동으로 보고되는 VAST 이벤트가 나와 있습니다.
완전히 지원
complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (뒤로 탐색이 많이 발생할 때 실행됨), start, thirdQuartile
일부 지원됨
clickClick이벤트는 동영상 광고에만 전송됩니다. Android, iOS 또는 데스크톱의 네이티브 전체 화면 플레이어에서는 클릭을 캡처할 수 없지만, 동영상이 닫힐 때 페이지 내 클릭 추적 요소로 클릭을 캡처할 수 있습니다. 그러나 동영상 요소가 iPad에서 네이티브 컨트롤을 사용하는 경우 클릭을 캡처할 수 없습니다.fullscreen
IMA SDK는 동영상이 전체 브라우저 창을 차지하는 시뮬레이션된 전체 화면 모드를 지원합니다.
offsetWidth및offsetHeight가 문서 본문 크기 이상인 경우 동영상이 전체 화면 모드인 것으로 간주됩니다. 이 모드는 모든 브라우저에서 지원됩니다. 시뮬레이션된 전체 화면의 예는 샘플을 다운로드하세요.iPhone 및 3.0 이전 Android 플랫폼에서는 동영상이 항상 전체 화면 모드로 재생됩니다.
mute,unmuteiOS 및 Android에는 볼륨의 네이티브 컨트롤만 있습니다. 따라서 IMA SDK는 볼륨 또는 음소거 상태를 확인할 수 없으며 변경사항에 대한 알림도 받지 않습니다. 다음은
mute,unmute를 지원하는 브라우저 버전과 지원하지 않는 브라우저 버전의 목록입니다.- 지원: Firefox 3.5 이상, Chrome 8 이상, Safari 4 이상
- 지원되지 않음: iOS, Android
VAST 광고 게재에 대한 자세한 내용은 IAB 가이드라인을 참고하세요.
JavaScript 프레임워크 주의사항
IMA HTML5 SDK와 함께 React 또는 AngularJS와 같은 JavaScript 프레임워크를 사용할 때는
몇 가지 고려사항이 있습니다. 이러한 프레임워크는 DOM의 요소를 이동하는 경우가 많으며, SDK가 시작될 때 IMA는 DOM이 정적일 것으로 예상하므로 IMA 기능이 중단될 수 있습니다. IMA는 프레임워크가 DOM 요소 이동을 완료한 후 IMA가 시작되는 한 JavaScript 프레임워크를 지원합니다. 특히 AdDisplayContainer를 구성할 때 containerElement 인수로 전달된 HTML5 요소는 인스턴스화된 후 이동해서는 안 됩니다.
지원되는 동영상 플레이어 플랫폼
Google IMA SDK는 다음 플랫폼에서 지원됩니다.
| 플랫폼 | 버전 | 광고 유형 |
|---|---|---|
| HTML5 | 데스크톱: Chrome, Firefox, Safari, Edge, Opera 모바일: Chrome/Android 브라우저 (휴대전화 및 태블릿용 Android), Safari 및 Chrome (iOS) |
선형 동영상, 선형 디스플레이, 비선형 및 컴패니언 광고, Ad Manager 동영상 솔루션, Ad Exchange 동영상, AFV 광고 |
| iOS | iOS 10.0 이상 | 선형 및 컴패니언 광고, Ad Manager 동영상, Ad Exchange 동영상, AFV 광고 |
| Android | Android 4.4 이상 | 선형 및 컴패니언 광고, Ad Manager 동영상, Ad Exchange 동영상, AFV 광고 |
| tvOS | tvOS 15 이상 | 선형 광고, Ad Manager 동영상, Ad Exchange 동영상 |
동영상 기능 및 SDK 버전
다음 기능에 대해 자세히 알아보려면 동영상 광고 개요를 참고하세요.
| HTML5 v3 | iOS v3 | Android v3 | tvOS | |
|---|---|---|---|---|
| IAB 동영상 도구 모음 | ||||
| VAST 4 |  9 |
9 |
9 |
9 |
| VAST 3 |  |
1 |
1 |
1 |
| VAST 2 | |
|
|
|
| SIMID 1.0 | |
|
|
 |
| VPAID 2 (HTML5) | |
|
|
|
| VMAP 1.0.1 | 2 3 |
2 |
2 |
2 |
| OM SDK 1.3 | |
|
|
|
| Ad Manager 동영상 기능 | ||||
| 선형 광고 | |
|
|
|
| 선형 디스플레이 광고 |
|
|
|
|
| YouTube 호스팅 저작물 | 4 |
|
|
|
| 비선형 광고 (오버레이) | 5 |
|
|
|
| 컴패니언 | |
|
|
|
| VAST 3 대체 컴패니언 광고 리소스 | |
|
|
|
| Active View 조회가능성 | |
|
|
|
| 오디오 광고 | |
|
|
|
| VAST 리디렉션 | |
|
|
|
| 디스플레이 요청을 통한 컴패니언 광고 예비 광고 | |
|
|
|
| Google 게시자 태그 (GPT) 호환성 | |
|
|
|
| 콘텐츠 인식 | |
|
|
|
| 광고 규칙 | 3 |
|
|
|
| 광고 규칙의 수동 광고 시점 |
|
|
|
|
| 최대 게재빈도 6 | |
|
|
|
| 경쟁 제외 (스트림) | |
|
|
|
| 경쟁 제외 (광고 모음) | |
|
|
|
| 경쟁 제외 (전체 페이지) | |
|
|
|
| 광고 모으기 | 3 |
|
|
|
| 범퍼 | |
|
|
|
| 다중 이벤트 추적 (MET) 보고 | |
|
|
|
| 동적 할당 (동영상용 애드센스, Ad Manager Ad Exchange) | |
|
|
|
| 건너뛸 수 있는 광고 (TrueView 아님) 8 | 5 |
|
|
|
| 인스트림 선택 | |
|
|
|
| 애셋 미리 로드 | 7 |
|
|
|
| 동영상용 애드센스 기능 | ||||
| TrueView 인스트림 | 5 |
|
|
|
| 인스트림 선택 | |
|
|
|
| 스탠더드 인스트림 | |
|
|
|
| 전체 슬롯 | |
|
|
|
| 컴패니언 | |
|
|
|
| 컴패니언 백업 광고 | |
|
|
|
| 오버레이 | 5 |
|
|
|
| 애셋 미리 로드 | 7 |
|
|
|
| Ad Manager Ad Exchange 기능 | ||||
| TrueView 인스트림 | 5 |
|
|
|
| 인스트림 선택 | |
|
|
|
| 스탠더드 인스트림 | |
|
|
|
| 전체 슬롯 | |
|
|
|
| 컴패니언 | |
|
|
|
| 컴패니언 백업 광고 | |
|
|
|
| 오버레이 | 5 |
|
|
|
| Active View 조회가능성 | |
|
|
|
| 애셋 미리 로드 | 7 |
|
|
|
| 이 광고가 표시된 이유 | |
|
|
|
1 다음 VAST 3.0 기능은 아직 HTML5가 아닌 SDK에서 지원되지 않습니다.
- 컴패니언
adSlotId - 컴패니언 게재 옵션
- 아이콘
2 다음 VMAP 기능은 아직 지원되지 않습니다.
- VMAP 관련 추적 이벤트
- VMAP 관련 오류 코드
- 오버레이 광고
- hh:mm:ss 또는 '시작' 및 '종료' 이외의 타임스탬프
- 디스플레이
breakType속성 - 속성
repeatAfter개
3 iPhone에서 VMAP 및 광고 규칙을 지원하려면 맞춤 광고 재생이 필요합니다.
4 YouTube 호스팅 광고 소재는 데스크톱에서 지원되지만 모바일 웹에서는 지원되지 않습니다.
5
playsinline를 사용하는 경우
iOS 10 이상의 HTML5 모바일 웹에서 비선형 광고 (오버레이), 건너뛸 수 있는 광고 (TrueView 아님), TrueView 인스트림 광고가 지원됩니다.
6 광고 규칙 최대 게재빈도 및 경쟁 제외에는 쿠키 또는 PPID가 필요합니다.
7 네이티브 확장 소재 미리 로드는 다음에서 작동하지 않습니다.
- iOS 기기의 모바일 웹
- Android 4.0 이전 버전의 모바일 웹
- TrueView 형식을 포함한 YouTube 호스팅 광고
-
IMA 수동 광고 시점 재생 기능(
AD_BREAK_READY이벤트에 의존하는 모든 구현)
8 SDK는 길이가 8초 미만인 건너뛸 수 있는 광고를 지원하지 않습니다. 최소 길이보다 짧은 광고가 재생되면 건너뛰기 버튼이 표시되지 않습니다.
9 Google Ad Manager에서 지원하는 VAST 4 기능 중 IMA는 다음 기능을 지원합니다.
- VAST 4.2
- SIMID (Secure Interactive Media Interface Definition) 지원
- 여러
UniversalAdID노드 허용
- VAST 4.0
- AdID
- 메자닌 파일
- 새로운 VAST 오류 코드
AdVerifications지원
지원 중단된 SDK
| Flash v2 | HTML5 v1 | iOS v1 | Android v1 | Google Cast v2 | |
|---|---|---|---|---|---|
| Ad Manager 동영상 기능 | |||||
| 선형 광고 | |
|
|
|
|
| 비선형 광고 | |
|
|
|
|
| 양방향 (VPAID 1.0) 광고 | |
|
|
|
|
| 리디렉션 (VAST 2.0) | |
|
|
|
|
| 컴패니언 예비 광고 (동영상용 애드센스, Ad Manager Ad Exchange) | |
|
|
|
|
| 오디오 광고 | |
|
|
|
|
| Google 게시자 태그 (GPT) 호환성 | |
|
|
|
|
| 최대 게재빈도 | |
|
|
|
|
| 경쟁 제외 (스트림) | |
|
|
|
|
| 경쟁 제외 (광고 모음) | |
|
|
|
|
| 경쟁 제외 (전체 페이지) | |
|
|
|
|
| 콘텐츠 인식 | |
|
|
|
|
| 광고 규칙 및 광고 규칙의 수동 광고 시점 | |
|
|
|
|
| 광고 모으기 | |
|
|
|
|
| 범퍼 | |
|
|
|
|
| 보고를 위한 다중 이벤트 추적 (MET) | |
|
|
|
|
| 동적 할당 | |
|
|
|
|
| 건너뛸 수 있음 | |
|
|
|
|
| 인스트림 선택 | |
|
|
|
|
| 동영상용 애드센스 기능 | |||||
| 텍스트 광고 | |
|
|
|
|
| 애드센스 VAST 인스트림 | |
|
|
|
|
| 애드센스 오버레이 | |
|
|
|
|
| 건너뛸 수 있음 | |
|
|
|
|
| 인스트림 선택 | |
|
|
|
|
| 사용자 선택 (YouTube) | |
|
|
|
|
| Ad Manager의 F2F 광고 | |
|
|
|
|
| Ad Manager Ad Exchange 기능 | |||||
| 선형 광고 | |
|
|
|
|