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

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

Đ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 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);
      ...

Sau đây là các chế độ VPAID có sẵn:

  • ENABLED – Cho phép quảng cáo VPAID với 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 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, hệ thống sẽ báo lỗi.
Để biết thêm thông tin về chế độ VPAID, hãy xem tài liệu về API cho ImaSdkSettings.VpaidMode.

Cảnh báo 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ột quảng cáo mong muốn truy cập vào DOM của trang mẹ, nó có khả năng 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à thích hợp cho chức năng 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 đó, nó 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 những mẫu quảng cáo chỉ gọi các phương thức API được hỗ trợ, quá trình hiển thị mẫu quảng cáo sẽ không thay đổi. Với chế độ VpaidMode.INSECURE, SDK sẽ cung cấp phần tử trình phát video thay vì proxy.

Dưới đâ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

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 hiện hỗ trợ mẫu quảng cáo JavaScript VPAID 2.
Điều này có bật 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.