SDK 지원 및 호환성 검토

이 페이지에서는 브라우저, 동영상 형식, 플랫폼의 HTML5 IMA 클라이언트 측 지원 및 호환성에 관한 일반적인 정보를 제공합니다.

지원되는 동영상 형식 및 브라우저

다양한 기능의 지원 여부는 브라우저에 따라 다르며, 모든 주요 브라우저에서 지원되는 단일 기본 동영상 형식은 없습니다. 대부분의 브라우저에서 사용되는 세 가지 기본 동영상 형식은 H.264, WebM, Ogg Theora입니다.

지원되는 동영상 플레이어

HTML <video> 태그를 포함하여 대부분의 IMA 기능은 일반적인 HTML5 동영상 플레이어에서 지원됩니다. IMA SDK를 지원하는 알려진 동영상 플레이어 목록은 동영상 기술 파트너 프로그램을 참조하세요.

VAST 이벤트 호환성

이 섹션에는 VAST 응답에 반환된 정보를 기반으로 서버에 자동으로 보고되는 VAST 이벤트가 나열되어 있습니다.

완전히 지원

complete, creativeView, firstQuartile, impression, midpoint, pause, resume, rewind (역 방향으로 중요한 탐색이 있을 때 실행됨), start, thirdQuartile.

일부 지원됨

  • click

    Click 이벤트는 동영상 광고에 대해서만 전송됩니다. Android, iOS 또는 데스크톱의 기본 전체 화면 플레이어에서는 클릭수를 캡처할 수 없지만 동영상이 닫힌 상태에서는 인페이지 클릭 추적 요소로 클릭수를 캡처할 수 있습니다. 하지만 동영상 요소가 iPad의 기본 컨트롤을 사용하는 경우 클릭수를 캡처할 수 없습니다.

  • fullscreen

    IMA SDK는 동영상이 전체 브라우저 창을 차지하는 시뮬레이션된 전체 화면 모드를 지원합니다. 동영상의 offsetWidth 및 offsetHeight가 최소한 문서 본문의 크기인 경우 동영상은 전체 화면 모드인 것으로 간주됩니다. 이 모드는 모든 브라우저에서 지원됩니다. 시뮬레이션된 전체 화면의 예를 보려면 샘플을 다운로드하세요.

    iPhone 및 Android 3.0 이전 플랫폼에서는 동영상이 항상 전체 화면 모드로 재생됩니다.

  • mute 및 unmute

    iOS 및 Android에서는 기본 볼륨만 제어할 수 있습니다. 따라서 IMA SDK는 볼륨 또는 음소거 상태를 확인할 수 없으며 변경사항에 대한 알림도 받지 못합니다. 다음은 mute, unmute를 지원하는 브라우저 버전과 지원하지 않는 브라우저 버전 목록입니다.

    • 지원됨: Firefox 3.5 이상, Chrome 8 이상, Safari 4 이상
    • 지원되지 않음: iOS, Android

VAST 광고 게재에 대한 자세한 내용은 IAB 가이드라인을 참고하세요.

JavaScript 프레임워크에 대한 주의사항

React 또는 AngularJS와 같은 자바스크립트 프레임워크를 IMA HTML5 SDK와 함께 사용할 때는 몇 가지 사항을 고려해야 합니다. 이러한 프레임워크는 종종 DOM 요소를 이동하므로 IMA 기능이 중단될 수 있습니다. IMA는 SDK가 시작될 때 DOM이 정적인 것으로 예상하기 때문입니다. IMA는 프레임워크에서 DOM 요소의 이동을 완료한 후에 IMA가 시작된 경우 자바스크립트 프레임워크를 지원합니다. 특히 AdDisplayContainer를 구성할 때 containerElement 인수로 전달된 HTML5 요소는 인스턴스화한 후에는 이동해서는 안 됩니다.

Apple AirPlay 지원

IMA SDK는 현재 Apple AirPlay를 지원하지 않습니다. AirPlay가 감지되면 AirPlay를 사용 중지하거나 광고 요청을 사용 중지합니다.

지원되는 동영상 플레이어 플랫폼

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 14 이상 선형 광고, 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 체크표시 체크표시 체크표시 빨간색-X
VPAID 2 (HTML5) 체크표시 빨간색-X 빨간색-X 빨간색-X
VMAP 1.0.1 주의 2 3 주의 2 주의 2 주의 2
OM SDK 1.3 체크표시 체크표시 체크표시 빨간색-X
Ad Manager 동영상 기능
선형 광고 체크표시 체크표시 체크표시 체크표시
YouTube 호스팅 애셋 주의 4 빨간색-X 빨간색-X 빨간색-X
비선형 광고 (오버레이) 주의 5 빨간색-X 빨간색-X 빨간색-X
컴패니언 광고 체크표시 체크표시 체크표시 빨간색-X
VAST 3 대체 컴패니언 광고 리소스 체크표시 체크표시 빨간색-X 빨간색-X
Active View 조회가능성 체크표시 체크표시 체크표시 빨간색-X
오디오 광고 체크표시 체크표시 체크표시 체크표시
VAST 리디렉션 체크표시 체크표시 체크표시 체크표시
디스플레이 요청이 있는 컴패니언 백업 광고 체크표시 체크표시 체크표시 빨간색-X
Google 게시자 태그 (GPT) 호환성 체크표시 빨간색-X 빨간색-X 빨간색-X
콘텐츠 인식 체크표시 체크표시 체크표시 체크표시
광고 규칙 주의 3 체크표시 체크표시 체크표시
광고 규칙에서 수동 광고 시점 사용 체크표시 빨간색-X 빨간색-X 빨간색-X
최대 게재빈도 6 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (스트림) 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (광고 모음) 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (전체 페이지) 체크표시 빨간색-X 빨간색-X 빨간색-X
광고 모으기 주의 3 체크표시 체크표시 체크표시
범퍼 광고 체크표시 체크표시 체크표시 체크표시
다중 이벤트 추적 (MET) 보고 체크표시 체크표시 체크표시 체크표시
동적 할당 (동영상용 애드센스, Ad Manager Ad Exchange) 체크표시 체크표시 체크표시 체크표시
건너뛸 수 있는 광고 (TrueView 아님) 8 주의 5 체크표시 체크표시 체크표시
인스트림 선택 체크표시 빨간색-X 빨간색-X 빨간색-X
애셋 미리 로드 주의 7 빨간색-X 체크표시 빨간색-X
동영상용 애드센스 기능
TrueView 인스트림 주의 5 체크표시 체크표시 빨간색-X
인스트림 선택 체크표시 체크표시 체크표시 빨간색-X
표준 인스트림 광고 체크표시 체크표시 체크표시 체크표시
풀슬롯 체크표시 빨간색-X 빨간색-X 빨간색-X
컴패니언 광고 체크표시 체크표시 체크표시 빨간색-X
컴패니언 백업 광고 빨간색-X 체크표시 체크표시 빨간색-X
오버레이 주의 5 빨간색-X 빨간색-X 빨간색-X
애셋 미리 로드 주의 7 빨간색-X 체크표시 빨간색-X
Ad Manager Ad Exchange 기능
TrueView 인스트림 주의 5 체크표시 체크표시 빨간색-X
인스트림 선택 체크표시 체크표시 체크표시 빨간색-X
표준 인스트림 광고 체크표시 체크표시 체크표시 체크표시
풀슬롯 체크표시 빨간색-X 빨간색-X 빨간색-X
컴패니언 광고 체크표시 체크표시 체크표시 빨간색-X
컴패니언 백업 광고 빨간색-X 체크표시 체크표시 빨간색-X
오버레이 주의 5 빨간색-X 빨간색-X 빨간색-X
Active View 조회가능성 체크표시 체크표시 체크표시 빨간색-X
애셋 미리 로드 주의 7 빨간색-X 체크표시 빨간색-X
이 광고가 표시된 이유 체크표시 체크표시 체크표시 체크표시

1 다음 VAST 3.0 기능은 HTML5가 아닌 SDK에서 아직 지원되지 않습니다.

  • 컴패니언 adSlotId
  • 컴패니언 게재 옵션
  • 아이콘

2 다음 VMAP 기능은 아직 지원되지 않습니다.

  • VMAP 관련 추적 이벤트
  • VMAP 관련 오류 코드
  • 오버레이 광고
  • hh:mm:ss 또는 "start"와 "end"가 아닌 시차
  • breakType 속성 표시
  • 속성 repeatAfter개

3 iPhone에서 VMAP 및 광고 규칙을 지원하려면 맞춤 광고 재생이 필요합니다.

4 YouTube 호스팅 광고 소재는 데스크톱에서 지원되지만 모바일 웹에서는 지원되지 않습니다.

5 비선형 광고(오버레이), 건너뛸 수 있는 광고(TrueView 아님) 및 TrueView 인스트림 광고는 iOS 10 이상의 HTML5 모바일 웹에서 지원됩니다( playsinline 사용 ).

6 광고 규칙 최대 게재빈도 및 경쟁 제외에는 쿠키 또는 PPID가 필요합니다.

7 네이티브 애셋 미리 로드는 다음과 함께 작동하지 않습니다.

  • iOS 기기의 모바일 웹
  • Android 4.0 이전 버전의 모바일 웹
  • TrueView 형식을 비롯한 YouTube 호스팅 광고
  • IMA 수동 중단 재생 기능 (AD_BREAK_READY 이벤트에 의존하는 모든 구현)

8 SDK는 8초 미만의 건너뛸 수 있는 광고를 지원하지 않습니다. 최소 길이보다 짧은 광고가 재생되면 건너뛰기 버튼이 표시되지 않습니다.

9 Google Ad Manager에서 지원하는 VAST 4 기능 중에서 IMA는 다음 기능을 지원합니다.