Để thảo luận và đưa ra ý kiến phản hồi về các sản phẩm của chúng tôi, hãy tham gia kênh Discord chính thức của Ad Manager trong máy chủ Cộng đồng quảng cáo và đo lường của Google.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này cung cấp thông tin chung về khả năng hỗ trợ và tính tương thích của IMA DAI đối với trình duyệt, định dạng video và nền tảng.
Các định dạng video và trình duyệt được hỗ trợ
HTML5 vẫn là một tiêu chuẩn mới và đang phát triển. Do đó, khả năng hỗ trợ các tính năng khác nhau giữa các trình duyệt cũng khác nhau và không có một định dạng video mặc định duy nhất được tất cả các trình duyệt chính hỗ trợ. Ba định dạng video chính được dùng trong phần lớn các trình duyệt là H.264, HLS và Dash.
Khả năng tương thích với sự kiện VAST
Phần này liệt kê các sự kiện VAST được tự động báo cáo cho máy chủ dựa trên thông tin được trả về trong phản hồi VAST.
Hỗ trợ đầy đủ
complete, creativeView,
firstQuartile, impression, midpoint,
pause, resume, rewind (được kích hoạt khi có bất kỳ thao tác tua lại đáng kể nào), start, thirdQuartile.
Được hỗ trợ một phần
click
Sự kiện Click chỉ được gửi cho quảng cáo dạng video.
Bạn không thể ghi lại lượt nhấp trên trình phát toàn màn hình gốc trên Android, iOS hoặc máy tính, nhưng bạn vẫn có thể ghi lại lượt nhấp bằng một phần tử theo dõi lượt nhấp trong trang khi video bị đóng. Tuy nhiên, nếu phần tử video sử dụng các chế độ điều khiển gốc trên iPad, thì bạn không thể ghi lại các lượt nhấp.
fullscreen
IMA hỗ trợ chế độ toàn màn hình mô phỏng, trong đó video chiếm toàn bộ cửa sổ trình duyệt.
IMA coi một video ở chế độ toàn màn hình khi offsetWidth và offsetHeight có kích thước ít nhất bằng kích thước của nội dung tài liệu.
Chế độ này được hỗ trợ trên mọi trình duyệt.
Trên iPhone và các nền tảng Android trước phiên bản 3.0, video luôn phát ở chế độ toàn màn hình.
mute, unmute
iOS và Android chỉ có chế độ kiểm soát âm lượng gốc. Do đó, IMA không thể xác định âm lượng hoặc trạng thái tắt tiếng, cũng như SDK không được thông báo về các thay đổi. Sau đây là danh sách các phiên bản trình duyệt có và không hỗ trợ mute, unmute:
Được hỗ trợ: Firefox 3.5+, Chrome 8+, Safari 4+
Không được hỗ trợ: iOS, Android
Hãy tham khảo nguyên tắc của IAB để biết thêm thông tin chi tiết về việc phân phát quảng cáo VAST.
Sự kiện quảng cáo khi xem lại các điểm chèn quảng cáo
IMA không kích hoạt các sự kiện quảng cáo khi xem lại quảng cáo vì những lý do sau:
URL sự kiện chỉ nên được kích hoạt một lần, nếu không, hệ thống có thể đọc URL đó là hành vi spam.
Điều này cho phép người dùng tìm kiếm trong và xung quanh các điểm chèn quảng cáo mà họ đã xem, mang lại trải nghiệm tìm kiếm tốt hơn.
Đây là những sự kiện duy nhất được kích hoạt khi xem lại các điểm chèn quảng cáo:
AD_PERIOD_STARTED
AD_PERIOD_ENDED
Nền tảng trình phát video được hỗ trợ
SDK IMA của Google được hỗ trợ trên các nền tảng sau:
Nền tảng
Phiên bản
HTML5
Máy tính: Chrome, Firefox, Safari, Edge, Opera Thiết bị di động: Chrome/Trình duyệt Android (Android cho điện thoại và máy tính bảng), Safari và Chrome (iOS)
iOS
iOS 10.0 trở lên
Android
Android 4.4 trở lên
Google Cast
Tất cả thiết bị truyền
tvOS
tvOS 14 trở lên
Roku
Tất cả thiết bị vẫn nhận được bản cập nhật phần mềm từ Roku
Hỗ trợ định dạng luồng video
IMA hỗ trợ cả HLS và DASH trên các SDK của mình. Hãy xem bảng này để biết thông tin hỗ trợ về các nền tảng SDK cụ thể. Để phát trực tuyến đúng cách, trình phát video của bạn cần hỗ trợ loại luồng phát đang được sử dụng.
2 Các tính năng sau đây của VAST 3.0 hiện chưa được hỗ trợ:
Companion adSlotId
Lựa chọn phân phối đồng hành
Biểu tượng
3 Các tính năng sau của VMAP hiện chưa được hỗ trợ:
Sự kiện theo dõi dành riêng cho VMAP
Mã lỗi dành riêng cho VMAP
Quảng cáo lớp phủ
Mức chênh lệch thời gian khác với hh:mm:ss hoặc "start" và "end"
Thuộc tính breakType hiển thị
repeatAfter thuộc tính
4 Chỉ hỗ trợ quảng cáo đi kèm dạng hình ảnh. Quảng cáo đi kèm dạng hình ảnh cần có chế độ triển khai tuỳ chỉnh để điền sẵn quảng cáo. Quảng cáo đồng hành không được hỗ trợ trên tvOS.
5 Quảng cáo truyền thống có thể bỏ qua chỉ được hỗ trợ trong SDK IMA DAI cho HTML5, iOS, tvOS, Roku và Android (bao gồm cả Android TV).
Với Cast SDK, bạn phải khai báo khả năng bỏ qua bằng StreamRequest.senderCanSkip để hỗ trợ quảng cáo có thể bỏ qua truyền thống.
6 Quảng cáo TrueView có thể bỏ qua chỉ được hỗ trợ trong SDK DAI IMA cho HTML5, iOS và Android (bao gồm cả Android TV).
7 SDK Cast không hỗ trợ các tính năng của AdSense.
8Tại sao có quảng cáo này? yêu cầu bạn phải truyền tham số adUiElement khi tạo StreamManager.
Tính năng Tại sao có quảng cáo này? không được hỗ trợ trong Cast SDK.
Lưu ý đối với các khung JavaScript
Bạn cần cân nhắc một số yếu tố khi sử dụng một khung JavaScript (chẳng hạn như React hoặc AngularJS) với SDK IMA HTML5. Các khung này thường di chuyển các phần tử của DOM, điều này có thể làm gián đoạn SDK IMA vì SDK này mong muốn DOM ở trạng thái tĩnh khi được khởi chạy. SDK IMA hỗ trợ các khung JavaScript miễn là SDK được khởi chạy sau khi khung hoàn tất việc di chuyển các phần tử DOM.
Cụ thể, phần tử HTML5 được truyền dưới dạng đối số adUiElement khi tạo StreamManager không được di chuyển sau khi được khởi tạo.
Hỗ trợ Apple AirPlay
SDK IMA không hỗ trợ Apple AirPlay. Tắt AirPlay hoặc tắt các yêu cầu quảng cáo khi phát hiện thấy AirPlay.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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