이 페이지에서는 브라우저, 동영상 형식, 플랫폼에 대한 IMA DAI 지원 및 호환성에 관한 일반 정보를 제공합니다.
지원되는 동영상 형식 및 브라우저
HTML5는 아직 새롭게 등장한 표준으로, 계속 발전하고 있습니다. 따라서 브라우저마다 다양한 기능 지원이 다르며 모든 주요 브라우저에서 지원하는 단일 기본 동영상 형식은 없습니다. 대부분의 브라우저에서 사용되는 세 가지 주요 동영상 형식은 H.264, HLS, Dash입니다.
VAST 이벤트 호환성
이 섹션에는 VAST 응답에서 반환된 정보를 기반으로 서버에 자동으로 보고되는 VAST 이벤트가 나열되어 있습니다.
완전히 지원
complete, creativeView,
firstQuartile, impression, midpoint,
pause, resume, rewind (뒤로 탐색이 있을 때 트리거됨), start,
thirdQuartile
일부 지원됨
click
Click 이벤트는 동영상 광고에 대해서만 전송됩니다.
Android, iOS 또는 데스크톱의 기본 전체 화면 플레이어에서는 클릭을 캡처할 수 없지만 동영상이 닫히면 인페이지 클릭 추적 요소에서 클릭을 캡처할 수 있습니다. 하지만 동영상 요소가 iPad에서 기본 컨트롤을 사용하는 경우 클릭을 캡처할 수 없습니다.
fullscreen
IMA는 동영상이 전체 브라우저 창을 차지하는 시뮬레이션된 전체 화면 모드를 지원합니다.
IMA는 동영상의 offsetWidth 및 offsetHeight이 문서 본문 크기 이상인 경우 동영상이 전체 화면 모드에 있다고 간주합니다.
이 모드는 모든 브라우저에서 지원됩니다.
iPhone 및 3.0 이전 Android 플랫폼에서는 동영상이 항상 전체 화면 모드로 재생됩니다.
mute, unmute
iOS와 Android에는 볼륨의 기본 제어 기능만 있습니다. 따라서 IMA는 볼륨이나 음소거 상태를 확인할 수 없으며 SDK에 변경사항이 알림으로 전송되지도 않습니다. 다음은 mute, unmute를 지원하는 브라우저 버전과 지원하지 않는 브라우저 버전의 목록입니다.
4 이미지 부가 정보만 지원됩니다. 이미지 컴패니언은 광고를 채우기 위해 맞춤 구현이 필요합니다. tvOS에서는 컴패니언 광고가 지원되지 않습니다.
5 기존 건너뛸 수 있는 광고는 HTML5, iOS, tvOS, Roku, Android (Android TV 포함)용 IMA DAI SDK에서만 지원됩니다.
Cast SDK를 사용하면 StreamRequest.senderCanSkip로 건너뛰기 기능을 선언하여 기존 건너뛸 수 있는 광고를 지원해야 합니다.
6 TrueView 건너뛸 수 있는 광고는 HTML5, iOS, Android (Android TV 포함)용 IMA DAI SDK에서만 지원됩니다.
7 Cast SDK에서는 애드센스 기능이 지원되지 않습니다.
8이 광고가 표시된 이유를 사용하려면 StreamManager를 만들 때 adUiElement 매개변수를 전달해야 합니다.
이 광고가 표시된 이유는 Cast SDK에서 지원되지 않습니다.
JavaScript 프레임워크 관련 주의사항
IMA HTML5 SDK와 함께 JavaScript 프레임워크(예: React 또는 AngularJS)를 사용할 때는 몇 가지 고려사항이 있습니다. 이러한 프레임워크는 DOM 요소를 이동하는 경우가 많으며, SDK가 시작될 때 DOM이 정적일 것으로 예상하므로 IMA SDK가 중단될 수 있습니다. 프레임워크가 DOM 요소 이동을 완료한 후 SDK가 시작되는 한 IMA SDK는 JavaScript 프레임워크를 지원합니다.
특히 StreamManager를 생성할 때 adUiElement 인수로 전달된 HTML5 요소는 인스턴스화된 후 이동하면 안 됩니다.
Apple AirPlay 지원
IMA SDK는 Apple AirPlay를 지원하지 않습니다. AirPlay가 감지되면 AirPlay를 사용 중지하거나 광고 요청을 사용 중지합니다.
[null,null,["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["This page provides general information on IMA DAI support and compatibility\nfor browsers, video formats, and platforms.\n\nSupported video formats and browsers\n\nHTML5 is still a new and evolving standard. As a result, support for various\nfeatures differs among browsers, and there is no single default video format\nsupported by all major browsers. The three main video formats used in the\nmajority of browsers are H.264, HLS, and Dash.\n\nVAST event compatibility\n\nThis section lists the VAST events that are automatically reported to the\nserver based on the information returned in the VAST response.\n\nFully supported\n\n`complete`, `creativeView`,\n`firstQuartile`, `impression`, `midpoint`,\n`pause`, `resume`, `rewind` (fired when there\nis any significant seeking in the backward direction), `start`,\n`thirdQuartile`.\n\nPartially supported\n\n- **`click`**\n\n\n The `Click` event is only sent for video ads.\n Clicks cannot be captured on the native fullscreen players on Android, iOS,\n or desktop, but clicks can still be captured by an in-page click tracking\n element when the video is closed. However, if the video element uses native\n controls on the iPad, clicks cannot be captured.\n- **`fullscreen`** \n\n\n IMA supports a **simulated full screen** mode,\n in which the video takes up the whole browser window.\n IMA considers a video to be in full screen mode\n when its `offsetWidth` and `offsetHeight`\n are at least the size of the document body.\n This mode is supported on all browsers.\n\n\n On the iPhone and pre-3.0 Android platforms,\n video always plays in full screen mode.\n- **`mute`** , **`unmute`**\n\n\n iOS and Android only have native control of the volume. As such, IMA cannot\n determine the volume or mute state, nor is the SDK notified of changes. Below is\n a list of the browser versions which do and do not support\n `mute`, `unmute`:\n - **Supported:** Firefox 3.5+, Chrome 8+, Safari 4+\n - **Not supported:** iOS, Android\n\n \u003cbr /\u003e\n\nRefer to the\n[IAB guidelines](//www.iab.com/wp-content/uploads/2015/06/VASTv3_0.pdf) for\nfurther details on VAST ad serving.\n\nAd events when rewatching ad breaks\n\nIMA does not fire ad events when rewatching ads for the following reasons:\n\n- Event URLs should only be triggered once, otherwise it could be read as spammy behavior.\n- This lets users seek in and around the ad breaks that they've already viewed, creating a better seeking experience.\n\nThese are the only events fired when rewatching ad breaks:\n\n- `AD_PERIOD_STARTED`\n- `AD_PERIOD_ENDED`\n\nSupported video player platforms\n\nThe Google IMA SDKs are supported on the following platforms:\n\n| Platform | Version |\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| **HTML5** | **Desktop** : Chrome, Firefox, Safari, Edge, Opera **Mobile**: Chrome/Android Browser (Android for phones and tablets), Safari and Chrome (iOS) |\n| **iOS** | iOS 10.0+ |\n| **Android** | Android 4.4+ |\n| **Google Cast** | All Cast devices |\n| **tvOS** | tvOS 14+ |\n| **Roku** | All devices that are still receiving software updates from Roku |\n\nVideo stream format support\n\nIMA supports both HLS and DASH across its SDKs. See this table for support\non specific SDK platforms. For proper stream playback, your video player\nneeds to support the stream type being used.\n\n| IMA SDK platform | HLS | DASH |\n|------------------|-----|------|\n| **HTML5** | | |\n| **iOS** | | |\n| **Android** | | |\n| **Google Cast** | | |\n| **tvOS** | | |\n| **Roku** | | |\n\nVideo features and SDK versions\n\nTo learn more about the following features, read\n[video advertising overview](//support.google.com/admanager/answer/1711021).\n\n| IAB Video Suite | Support |\n|------------------------------------------|---------------------------|\n| VAST 4 | [1](#vast4-footnote) |\n| VAST 3 | [2](#vast3-footnote) |\n| VAST 2 | |\n| VPAID 2 | |\n| VMAP 1.0.1 | [3](#vmap-footnote) |\n| Linear ads | |\n| Non-linear ads (Overlays) | |\n| Companions | [4](#companions-footnote) |\n| VAST 3 alternate companion ad resources | |\n| Active View viewability | |\n| VAST Redirects | |\n| Companion backfill with display request | |\n| Google Publisher Tag (GPT) compatibility | |\n| Content awareness | |\n| Ad rules | |\n| Podding | |\n| Bumpers | |\n| Reporting on multi-event tracking (MET) | |\n| Skippable (reservation / non-TrueView) | [5](#skippable-footnote) |\n| TrueView InStream | [6](#trueview-footnote) |\n| InStream Select | |\n| Standard InStream | |\n| Full-slot | |\n| Companions | [4](#companions-footnote) |\n| Companion backfill | |\n| Overlays | |\n| TrueView InStream | [6](#trueview-footnote) |\n| InStream Select | |\n| Standard InStream | |\n| Full-slot | |\n| Companions | [4](#companions-footnote) |\n| Companion backfill | |\n| Overlays | |\n| Active View viewability | |\n| Why This Ad? | [8](#wta-footnote) |\n\n^1^ Of the\n[VAST 4 features supported by Google Ad\nManager](//support.google.com/admanager/answer/7358411), IMA support the following features:\n\n- VAST 4.2\n - Support for [Secure\n Interactive Media Interface Definition (SIMID)](//support.google.com/admanager/answer/1711021#simid)\n - Allowance of multiple `UniversalAdID` nodes\n- VAST 4.0\n - AdID\n - Mezzanine file\n - New VAST error codes\n - New VAST macros\n - `AdVerifications` support\n\n\u003cbr /\u003e\n\n^2^ The following VAST 3.0 features are not\nyet supported:\n\n- Companion `adSlotId`\n- Companion delivery options\n- Icons\n\n^3^ The following VMAP features are not yet supported:\n\n- VMAP-specific tracking events\n- VMAP-specific error codes\n- Overlay ads\n- Time offsets other than hh:mm:ss or \"start\" and \"end\"\n- Display `breakType` attribute\n- `repeatAfter` attribute\n\n^4^ Only image companions are supported. Image companions\nrequire custom implementation for populating ads. Companion ads are not supported on tvOS.\n\n^5^ Traditional skippable ads are only supported in\nthe IMA DAI SDKs for HTML5, iOS, tvOS, Roku, and Android (including Android TV).\nWith the Cast SDK, you must declare skipping capability with\n[`StreamRequest.senderCanSkip`](https://developers.google.com/ad-manager/dynamic-ad-insertion/sdk/cast/reference/js/StreamRequest#senderCanSkip),\nto supports tradditional skippable ads.\n\n^6^ TrueView skippable ads are only supported in\nthe IMA DAI SDKs for HTML5, iOS, and Android (including Android TV).\n\n^7^ AdSense features are not supported in the Cast SDK.\n\n^8^ *Why This Ad?* requires that the\n`adUiElement` parameter be passed when creating the `StreamManager`.\n*Why This Ad?* is not supported in the Cast SDK.\n| **Important:** Using the HTML5 IMA DAI SDK with skippable ads or *Why This Ad?* requires that the `adUiElement` parameter be passed when creating the `StreamManager`.\n\nCaveats for JavaScript frameworks\n\nThere are certain considerations when using a JavaScript framework, such as\nReact or AngularJS, with the IMA HTML5 SDK. These frameworks often move elements\nof the DOM, which can break the IMA SDK since the SDK expects the DOM to be\nstatic when it's initiated. The IMA SDK supports JavaScript frameworks as long\nas the SDK is initiated after the framework has finished moving DOM elements.\nSpecifically, the HTML5 element passed as the `adUiElement` argument when\nconstructing the\n[`StreamManager`](/ad-manager/dynamic-ad-insertion/sdk/html5/reference/js/StreamManager#StreamManager)\nshouldn't be moved once it's instantiated.\n\nApple AirPlay support\n\nThe IMA SDK doesn't support Apple AirPlay. Either disable AirPlay or disable ad\nrequests when AirPlay is detected."]]
1