SDK 지원 및 호환성 검토

플랫폼 선택: HTML5 Android iOS tvOS

이 페이지에서는 브라우저, 동영상 형식, 플랫폼에 대한 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 및 3.0 이전 Android 플랫폼에서는 동영상이 항상 전체 화면 모드로 재생됩니다.

  • mute, unmute

    iOS와 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가 시작될 때 DOM이 정적일 것으로 예상하는 IMA 기능이 중단될 수 있습니다. 프레임워크가 DOM 요소 이동을 완료한 후 IMA가 시작되는 한 IMA는 JavaScript 프레임워크를 지원합니다. 특히 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 체크표시 체크표시 체크표시 Red-X
VPAID 2 (HTML5) 체크표시 Red-X Red-X Red-X
VMAP 1.0.1 경고 2 3 경고 2 경고 2 경고 2
OM SDK 1.3 체크표시 체크표시 체크표시 Red-X
Ad Manager 동영상 기능
선형 광고 체크표시 체크표시 체크표시 체크표시
YouTube 호스팅 애셋 경고 4 Red-X Red-X Red-X
비선형 광고 (오버레이) 경고 5 Red-X Red-X Red-X
컴패니언 체크표시 체크표시 체크표시 Red-X
VAST 3 대체 컴패니언 광고 리소스 체크표시 체크표시 Red-X Red-X
Active View 조회가능성 체크표시 체크표시 체크표시 Red-X
오디오 광고 체크표시 체크표시 체크표시 체크표시
VAST 리디렉션 체크표시 체크표시 체크표시 체크표시
디스플레이 요청이 있는 호환 예비 광고 체크표시 체크표시 체크표시 Red-X
Google 게시자 태그 (GPT) 호환성 체크표시 Red-X Red-X Red-X
콘텐츠 인식 체크표시 체크표시 체크표시 체크표시
광고 규칙 경고 3 체크표시 체크표시 체크표시
광고 규칙의 수동 광고 시점 체크표시 Red-X Red-X Red-X
최대 게재빈도 6 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (스트림) 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (팟) 체크표시 체크표시 체크표시 체크표시
경쟁 제외 (전체 페이지) 체크표시 Red-X Red-X Red-X
광고 모음 경고 3 체크표시 체크표시 체크표시
범퍼 체크표시 체크표시 체크표시 체크표시
다중 이벤트 추적 (MET) 보고 체크표시 체크표시 체크표시 체크표시
동적 할당 (동영상용 애드센스, Ad Manager Ad Exchange) 체크표시 체크표시 체크표시 체크표시
건너뛸 수 있음 (TrueView 아님) 8 경고 5 체크표시 체크표시 체크표시
인스트림 선택 체크표시 Red-X Red-X Red-X
애셋 미리 로드 경고 7 Red-X 체크표시 Red-X
동영상용 애드센스 기능
TrueView 인스트림 경고 5 체크표시 체크표시 Red-X
인스트림 선택 체크표시 체크표시 체크표시 Red-X
표준 인스트림 광고 체크표시 체크표시 체크표시 체크표시
전체 슬롯 체크표시 Red-X Red-X Red-X
컴패니언 체크표시 체크표시 체크표시 Red-X
컴패니언 뒤채움 Red-X 체크표시 체크표시 Red-X
오버레이 경고 5 Red-X Red-X Red-X
애셋 미리 로드 경고 7 Red-X 체크표시 Red-X
Ad Manager Ad Exchange 기능
TrueView 인스트림 경고 5 체크표시 체크표시 Red-X
인스트림 선택 체크표시 체크표시 체크표시 Red-X
표준 인스트림 광고 체크표시 체크표시 체크표시 체크표시
전체 슬롯 체크표시 Red-X Red-X Red-X
컴패니언 체크표시 체크표시 체크표시 Red-X
컴패니언 뒤채움 Red-X 체크표시 체크표시 Red-X
오버레이 경고 5 Red-X Red-X Red-X
Active View 조회가능성 체크표시 체크표시 체크표시 Red-X
애셋 미리 로드 경고 7 Red-X 체크표시 Red-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 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는 다음 기능을 지원합니다.