Mẫu quảng cáo JavaScript VPAID 2

SDK IMA HTML5 hỗ trợ mẫu quảng cáo JavaScript VPAID 2. Việc bật tính năng hỗ trợ rất dễ dàng, nhưng có hai điểm khác biệt cần biết 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 SDK hoặc trình phát, nhưng rất quan trọng đối với tác giả 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 hiển thị.

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

  • Trình phát video HTML5 có tích hợp SDK IMA HTML5. Nếu bạn chưa có tài khoản, hãy xem Hướng dẫn bắt đầu sử dụng của chúng tôi.
  • URL thẻ quảng cáo VAST trỏ đến mẫu quảng cáo JavaScript VPAID 2.

Các đoạn mồi hữu ích

Bật tính năng 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 của bạn:

      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ó 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 Khung nội dung và Phần tử proxy của trình phát video.
  • DISABLED – Quảng cáo VPAID không phát. Nếu quảng cáo được yêu cầu trả về mẫu quảng cáo VPAID, thì sẽ có lỗi xảy ra.
Để biết thêm thông tin về các chế độ VPAID, hãy xem tài liệu về API cho ImaSdkSettings.VpaidMode.

Cảnh báo về hỗ trợ VPAID 2

Bảo mật IFrame

Theo mặc định, SDK IMA sử dụng iframe bảo mật thay vì iframe thân thiện (cùng miền) hoặc tập lệnh trong trang để hiển thị mẫu quảng cáo JavaScript VPAID 2. Điều này có nghĩa là nếu mẫu quảng cáo muốn truy cập vào DOM của trang gốc, thì mẫu quảng cáo đó có thể gây ra lỗi. Để hiển thị quảng cáo của bạn 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

Để bảo mật và sử dụng đúng chức năng của thiết bị di động, ở chế độ ENABLED, SDK IMA HTML5 không cung cấp phần tử video thực tế cho quảng cáo; thay vào đó, SDK này cung cấp một phần tử proxy bắt chước nhiều chức năng của phần tử video thông thường. Đối với 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 về hành vi khi hiển thị mẫu quảng cáo. Với 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ó sẵn 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

Mẫu quảng cáo JavaScript VPAID 2 có được hỗ trợ trong SDK của iOS hoặc Android không?
SDK IMA HTML5 là nền tảng SDK IMA duy nhất hiện 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 JavaScript VPAID 2.