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

SDK IMA HTML5 hỗ trợ các mẫu quảng cáo VPAID 2 JavaScript. Khi bật chế độ 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 VPAID 2 JavaScript, vì các 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 hiển thị.

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

Để làm theo hướng dẫn này, hãy bắt đầu với một ứng dụng có các điều kiện 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 bài viết Thiết lập SDK IMA.
  • URL thẻ quảng cáo VAST trỏ đến một mẫu quảng cáo VPAID 2 JavaScript.

Tài liệu cơ bản hữu ích

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

Để bật chế độ hỗ trợ VPAID 2 JavaScript, 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 có các 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 bài viết Bảo mật iFrame và Phần tử proxy của 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ột mẫu quảng cáo VPAID, thì sẽ có 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ề chế độ hỗ trợ VPAID 2

Bảo mật iFrame

Theo mặc định, SDK IMA sử dụng một iframe an toàn thay vì một iframe thân thiện (cùng miền) hoặc một tập lệnh trong trang để hiển thị các mẫu quảng cáo VPAID 2 JavaScript. Đ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 thân thiện, 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 nhiều chức năng của phần tử video thông thường. Đối với các 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ị các mẫu quảng cáo. Ở chế độ VpaidMode.INSECURE, SDK 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ó trên phần tử proxy video:

Phương thức

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

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 VPAID 2 JavaScript 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ợ các mẫu quảng cáo VPAID 2 JavaScript.
Điều này có cho phép các mẫu quảng cáo VPAID trong SDK IMA HTML5 không?
Có, SDK IMA HTML5 hỗ trợ các mẫu quảng cáo VPAID 2 JavaScript.