Xem lại khả năng tương thích và hỗ trợ SDK

Chọn nền tảng: HTML5 Android iOS tvOS

Trang này cung cấp thông tin chung về khả năng hỗ trợ và khả năng tương thích phía máy khách của IMA HTML5 cho trình duyệt, định dạng video và nền tảng.

Định dạng video và trình duyệt được hỗ trợ

Mức độ hỗ trợ cho các tính năng khác nhau tuỳ theo trình duyệt và không có định dạng video mặc định nào đượ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 hầu hết các trình duyệt là H.264, WebM và Ogg Theora.

Trình phát video được hỗ trợ

Phần lớn các tính năng của IMA đều được các trình phát video HTML5 thông thường hỗ trợ, bao gồm cả thẻ HTML <video>. Xem Chương trình đối tác công nghệ video để biết danh sách các trình phát video đã biết có hỗ trợ IMA SDK.

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. 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 vẫn có thể ghi lại lượt nhấp bằng 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 lượt nhấp.

  • fullscreen

    SDK 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. Chúng tôi coi video ở chế độ toàn màn hình khi offsetWidth và offsetHeight của video ít nhất bằng kích thước của phần nội dung tài liệu. Chế độ này được hỗ trợ trên mọi trình duyệt. Để xem ví dụ về chế độ toàn màn hình mô phỏng, hãy tải mẫu xuống.

    Trên iPhone và các nền tảng Android trước phiên bản 3.0, video sẽ luôn phát ở chế độ toàn màn hình.

  • mute, unmute

    iOS và Android chỉ có quyền kiểm soát gốc đối với âm lượng. Do đó, IMA SDK không thể xác định âm lượng hoặc trạng thái tắt tiếng, cũng như không được thông báo về các thay đổi. Dưới đâ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 trở lên, Chrome 8 trở lên, Safari 4 trở lên
    • Không hỗ trợ: iOS, Android

Để biết thêm thông tin về cách phân phát quảng cáo VAST, hãy tham khảo nguyên tắc của IAB.

Lưu ý đối với khung JavaScript

Có một số điểm cần lưu ý khi sử dụng 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 hỏng chức năng IMA vì IMA yêu cầu DOM phải ở trạng thái tĩnh khi SDK được khởi tạo. IMA hỗ trợ các khung JavaScript miễn là IMA được khởi tạo sau khi khung hoàn tất việc di chuyển các phần tử DOM. Cụ thể, bạn không nên di chuyển phần tử HTML5 được truyền dưới dạng đối số containerElement khi tạo AdDisplayContainer sau khi phần tử này được tạo thực thể.

Nền tảng trình phát video được hỗ trợ

IMA SDK của Google được hỗ trợ trên các nền tảng sau:

Nền tảng Phiên bản Loại quảng cáo
HTML5 Máy tính: Chrome, Firefox, Safari, Edge, Opera
Thiết bị di động: Trình duyệt Chrome/Android (Android cho điện thoại và máy tính bảng), Safari và Chrome (iOS)
Quảng cáo dạng video tuyến tính, quảng cáo hiển thị tuyến tính, quảng cáo phi tuyến tính và quảng cáo đồng hành, Giải pháp video của Ad Manager, quảng cáo dạng video trên Ad Exchange và quảng cáo AFV
iOS iOS 10.0 trở lên Quảng cáo tuyến tính và quảng cáo đồng hành, video Ad Manager, video Ad Exchange và quảng cáo AFV
Android Android 4.4 trở lên Quảng cáo tuyến tính và quảng cáo đồng hành, video Ad Manager, video Ad Exchange và quảng cáo AFV
tvOS tvOS 15 trở lên Quảng cáo tuyến tính, video Ad Manager và video Ad Exchange

Tính năng video và phiên bản SDK

Để tìm hiểu thêm về các tính năng sau, hãy đọc bài viết tổng quan về quảng cáo dạng video.

HTML5 phiên bản 3 iOS phiên bản 3 Android phiên bản 3 tvOS
Bộ video của IAB
VAST 4 Cảnh báo 9 Cảnh báo 9 Cảnh báo 9 Cảnh báo 9
VAST 3 Dấu kiểm Cảnh báo 1 Cảnh báo 1 Cảnh báo 1
VAST 2 Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
SIMID 1.0 Dấu kiểm Dấu kiểm Dấu kiểm Red-X
VPAID 2 (HTML5) Dấu kiểm Red-X Red-X Red-X
VMAP 1.0.1 Cảnh báo 2 3 Cảnh báo 2 Cảnh báo 2 Cảnh báo 2
OM SDK 1.3 Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Các tính năng video của Ad Manager
Quảng cáo tuyến tính Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Quảng cáo hiển thị tuyến tính Dấu kiểm Red-X Red-X Red-X
Thành phần lưu trữ trên YouTube Cảnh báo 4 Red-X Red-X Red-X
Quảng cáo phi tuyến tính (Lớp phủ) Cảnh báo 5 Red-X Red-X Red-X
Quảng cáo đồng hành Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Tài nguyên quảng cáo đồng hành thay thế VAST 3 Dấu kiểm Dấu kiểm Red-X Red-X
Khả năng xem theo Active View Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Quảng cáo dạng âm thanh Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Lệnh chuyển hướng VAST Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Thay thế quảng cáo đồng hành bằng yêu cầu hiển thị Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Khả năng tương thích của Thẻ nhà xuất bản của Google (GPT) Dấu kiểm Red-X Red-X Red-X
Nhận biết nội dung Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Quy tắc quảng cáo Cảnh báo 3 Dấu kiểm Dấu kiểm Dấu kiểm
Điểm chèn quảng cáo thủ công trong quy tắc quảng cáo Dấu kiểm Red-X Red-X Red-X
Giới hạn tần suất 6 Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Loại trừ cạnh tranh (luồng phát trực tiếp) Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Loại trừ cạnh tranh (nhóm) Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Loại trừ cạnh tranh (toàn bộ trang) Dấu kiểm Red-X Red-X Red-X
Nhóm quảng cáo Cảnh báo 3 Dấu kiểm Dấu kiểm Dấu kiểm
Đoạn quảng cáo đệm Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Báo cáo về tính năng theo dõi nhiều sự kiện (MET) Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Phân bổ động (AdSense cho video, Ad Exchange của Ad Manager) Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Có thể bỏ qua (không phải TrueView) 8 Cảnh báo 5 Dấu kiểm Dấu kiểm Dấu kiểm
InStream Select Dấu kiểm Red-X Red-X Red-X
Tải trước thành phần Cảnh báo 7 Red-X Dấu kiểm Red-X
Các tính năng của AdSense cho video
TrueView InStream Cảnh báo 5 Dấu kiểm Dấu kiểm Red-X
InStream Select Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Trong luồng chuẩn Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Toàn khung giờ Dấu kiểm Red-X Red-X Red-X
Quảng cáo đồng hành Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Lấp đầy quảng cáo đồng hành Red-X Dấu kiểm Dấu kiểm Red-X
Lớp phủ Cảnh báo 5 Red-X Red-X Red-X
Tải trước thành phần Cảnh báo 7 Red-X Dấu kiểm Red-X
Các tính năng của Ad Exchange trong Ad Manager
TrueView InStream Cảnh báo 5 Dấu kiểm Dấu kiểm Red-X
InStream Select Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Trong luồng chuẩn Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm
Toàn khung giờ Dấu kiểm Red-X Red-X Red-X
Quảng cáo đồng hành Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Lấp đầy quảng cáo đồng hành Red-X Dấu kiểm Dấu kiểm Red-X
Lớp phủ Cảnh báo 5 Red-X Red-X Red-X
Khả năng xem theo Active View Dấu kiểm Dấu kiểm Dấu kiểm Red-X
Tải trước thành phần Cảnh báo 7 Red-X Dấu kiểm Red-X
Tại sao có quảng cáo này? Dấu kiểm Dấu kiểm Dấu kiểm Dấu kiểm

1 Các tính năng VAST 3.0 sau đây chưa được hỗ trợ trong SDK không phải HTML5:

  • Companion adSlotId
  • Tuỳ chọn phân phối quảng cáo đồng hành
  • Biểu tượng

2 Các tính năng sau của VMAP 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ủ
  • Độ lệch thời gian không phải là hh:mm:ss hoặc "start" và "end"
  • Thuộc tính breakType hiển thị
  • repeatAfter thuộc tính

3 Để hỗ trợ VMAP và quy tắc quảng cáo trên iPhone, bạn cần phải phát quảng cáo tuỳ chỉnh.

4 Mẫu quảng cáo được lưu trữ trên YouTube được hỗ trợ trên máy tính nhưng không được hỗ trợ trên web dành cho thiết bị di động.

5 Quảng cáo phi tuyến tính (Lớp phủ), Quảng cáo có thể bỏ qua (không phải TrueView) và Quảng cáo TrueView trong luồng phát được hỗ trợ trên web dành cho thiết bị di động HTML5 trên iOS 10 trở lên khi sử dụng playsinline .

6 Giới hạn tần suất và loại trừ cạnh tranh của quy tắc quảng cáo yêu cầu cookie hoặc PPID.

7 Tính năng tải trước thành phần gốc không hoạt động với những thành phần sau:

  • Web dành cho thiết bị di động trên thiết bị iOS
  • Web dành cho thiết bị di động trên Android phiên bản trước 4.0
  • Quảng cáo được lưu trữ trên YouTube, bao gồm cả định dạng TrueView
  • Tính năng phát điểm chèn quảng cáo thủ công của IMA (mọi cách triển khai dựa vào sự kiện AD_BREAK_READY)

8 SDK không hỗ trợ quảng cáo có thể bỏ qua có thời lượng dưới 8 giây. Khi quảng cáo ngắn hơn thời lượng tối thiểu được phát, nút Bỏ qua sẽ không xuất hiện.

9 Trong số các tính năng của VAST 4 được Google Ad Manager hỗ trợ, IMA hỗ trợ các tính năng sau: