Bật mẫu quảng cáo JavaScript VPAID 2

SDK IMA HTML5 hỗ trợ mẫu quảng cáo VPAID 2 JavaScript. Khi bật tính năng hỗ trợ, bạn cần lưu ý 2 điểm khác biệt chính giữa thông số kỹ thuật VPAID 2 và cách SDK IMA hỗ trợ VPAID 2. Những điểm khác biệt này không ảnh hưởng đến mã triển khai trình phát hoặc SDK, nhưng chúng rất quan trọng đối với tác giả của mẫu quảng cáo JavaScript VPAID 2, vì mẫu quảng cáo có thể gặp lỗi hoặc không hoạt động như mong đợi khi được SDK IMA HTML5 kết xuất.

Điều kiện tiên quyết

Để làm theo hướng dẫn này, hãy bắt đầu bằng một ứng dụng có các đặc điểm sau:

  • Trình phát video HTML5 có tích hợp SDK IMA HTML5. Nếu bạn chưa có, hãy xem phần Thiết lập SDK IMA.
  • URL thẻ quảng cáo VAST trỏ đến mẫu quảng cáo JavaScript VPAID 2.

Thông tin cơ bản hữu ích

Bật chế độ hỗ trợ VPAID 2

Để bật tính năng hỗ trợ JavaScript VPAID 2, hãy gọi phương thức sau trước khi khởi chạy AdDisplayContainer:

google.ima.settings.setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.ENABLED);
...
var adDisplayContainer = new google.ima.AdDisplayContainer(adContainerElement);
var adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...

Các chế độ VPAID hiện có như sau:

  • ENABLED – Cho phép quảng cáo VPAID bằng chế độ cài đặt mặc định.
  • INSECURE – Cho phép quảng cáo VPAID ở chế độ không an toàn. Để biết thêm thông tin, hãy xem phần Bảo mật IFrame và Phần tử proxy trình phát video.
  • DISABLED – Quảng cáo VPAID không phát. Nếu một quảng cáo được yêu cầu trả về mẫu quảng cáo VPAID, thì sẽ xảy ra lỗi.

Để biết thêm thông tin về các chế độ VPAID, hãy xem tài liệu về API cho ImaSdkSettings.VpaidMode.

Lưu ý về việc hỗ trợ VPAID 2

Bảo mật IFrame

Theo mặc định, IMA SDK sử dụng một iframe bảo mật thay vì một iframe thân thiện (cùng miền) hoặc một tập lệnh trong trang để kết xuất mẫu quảng cáo JavaScript VPAID 2. Điều này có nghĩa là nếu một mẫu quảng cáo dự kiến truy cập vào DOM của trang mẹ, thì mẫu quảng cáo đó có thể gây ra lỗi. Để hiển thị quảng cáo trong một iframe tương thích, bạn có thể sử dụng ImaSdkSettings.setVpaidMode(...) như sau:

adsLoader.getSettings().setVpaidMode(google.ima.ImaSdkSettings.VpaidMode.INSECURE);

Phần tử proxy của trình phát video

Để đảm bảo tính bảo mật và chức năng phù hợp trên thiết bị di động, ở chế độ ENABLED, SDK IMA HTML5 không cung cấp phần tử video thực cho quảng cáo; thay vào đó, SDK này cung cấp một phần tử proxy mô phỏng phần lớn chức năng của phần tử video thông thường. Đối với những mẫu quảng cáo chỉ gọi các phương thức API được hỗ trợ, sẽ không có thay đổi nào về hành vi trong quá trình hiển thị mẫu quảng cáo. Ở chế độ VpaidMode.INSECURE, SDK sẽ cung cấp phần tử trình phát video thay vì proxy.

Sau đây là các phương thức, trình nghe và thuộc tính có sẵn trên phần tử proxy video:

Phương thức

  • addEventListener
  • canPlayType
  • load
  • play
  • pause
  • setattribute

Các loại sự kiện cho addEventListener

  • abort
  • canplay
  • canplaythrough
  • click
  • durationchange
  • emptied
  • ended
  • error
  • loadeddata
  • loadedmetadata
  • loadstart
  • pause
  • play
  • playing
  • progress
  • ratechange
  • suspend
  • seeked
  • seeking
  • timeupdate
  • waiting

Thuộc tính

  • currentTime
  • duration
  • ended
  • paused
  • playbackRate
  • src
  • type

Câu hỏi thường gặp

Các mẫu quảng cáo JavaScript VPAID 2 có được hỗ trợ trong SDK iOS hoặc Android không?
SDK IMA HTML5 là nền tảng SDK IMA duy nhất hỗ trợ mẫu quảng cáo JavaScript VPAID 2.
Việc này có cho phép mẫu quảng cáo VPAID trong SDK IMA HTML5 không?
Có, SDK IMA HTML5 hỗ trợ mẫu quảng cáo VPAID 2 JavaScript.