เปิดใช้ครีเอทีฟโฆษณา JavaScript ของ VPAID 2

IMA HTML5 SDK รองรับครีเอทีฟโฆษณา JavaScript VPAID 2 เมื่อเปิดใช้การรองรับ คุณควรทราบถึงความแตกต่างหลัก 2 ประการระหว่าง ข้อกำหนด VPAID 2 กับวิธีที่ IMA SDK รองรับ VPAID 2 ความแตกต่างเหล่านี้ไม่มีผลต่อโค้ดการติดตั้งใช้งานเพลเยอร์ หรือ SDK แต่มีความสำคัญสำหรับผู้เขียนครีเอทีฟโฆษณา JavaScript VPAID 2 เนื่องจากครีเอทีฟโฆษณาอาจแสดงข้อผิดพลาดหรือไม่ทํางานตามที่คาดไว้เมื่อ IMA HTML5 SDK แสดงผล

ข้อกำหนดเบื้องต้น

หากต้องการทำตามคู่มือนี้ ให้เริ่มต้นด้วยแอปที่มีสิ่งต่อไปนี้

  • วิดีโอเพลเยอร์ HTML5 ที่ผสานรวม IMA HTML5 SDK หากยังไม่มี ให้ดูตั้งค่า IMA SDK
  • URL แท็กโฆษณา VAST ที่ชี้ไปยังครีเอทีฟโฆษณา JavaScript ของ VPAID 2

ข้อมูลเบื้องต้นที่เป็นประโยชน์

  • หากไม่คุ้นเคยกับ VPAID 2 โปรดอ่านข้อมูลเพิ่มเติมที่ หน้า VPAID ของ IAB

เปิดใช้การรองรับ VPAID 2

หากต้องการเปิดใช้การรองรับ JavaScript ของ VPAID 2 ให้เรียกใช้เมธอดต่อไปนี้ก่อน เริ่มต้น AdDisplayContainer

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

โหมด VPAID ที่ใช้ได้มีดังนี้

ดูข้อมูลเพิ่มเติมเกี่ยวกับโหมด VPAID ได้ในเอกสารประกอบเกี่ยวกับ API สำหรับ ImaSdkSettings.VpaidMode

ข้อควรระวังในการรองรับ VPAID 2

ความปลอดภัยของ iframe

โดยค่าเริ่มต้น IMA SDK จะใช้ iframe ที่ปลอดภัยแทน iframe ที่ใช้งานง่าย (โดเมนเดียวกัน) หรือสคริปต์ในหน้าเว็บเพื่อแสดงผลครีเอทีฟโฆษณา JavaScript ของ VPAID 2 ซึ่งหมายความว่าหากครีเอทีฟโฆษณาคาดว่าจะเข้าถึง DOM ของหน้าหลัก ก็อาจทำให้เกิดข้อผิดพลาดได้ หากต้องการแสดงโฆษณาใน iframe ที่ใช้งานง่ายแทน คุณสามารถใช้ ImaSdkSettings.setVpaidMode(...) ดังนี้

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

องค์ประกอบพร็อกซีของวิดีโอเพลเยอร์

เพื่อความปลอดภัยและฟังก์ชันการทำงานที่เหมาะสมบนอุปกรณ์เคลื่อนที่ ในโหมด ENABLED IMA HTML5 SDK จะไม่แสดงองค์ประกอบวิดีโอจริงต่อโฆษณา แต่จะแสดงองค์ประกอบ พร็อกซีที่เลียนแบบฟังก์ชันการทำงานส่วนใหญ่ขององค์ประกอบวิดีโอปกติแทน สำหรับครีเอทีฟโฆษณาที่เรียกเฉพาะเมธอด API ที่รองรับเท่านั้น ครีเอทีฟโฆษณาควรไม่มีการเปลี่ยนแปลงลักษณะการทำงานในการแสดงผล เมื่อใช้โหมด VpaidMode.INSECURE SDK จะระบุองค์ประกอบวิดีโอเพลเยอร์แทน พร็อกซี

ต่อไปนี้คือเมธอด Listener และแอตทริบิวต์ที่พร้อมใช้งานในองค์ประกอบพร็อกซีวิดีโอ

เมธอด

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

ประเภทเหตุการณ์สำหรับ addEventListener

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

Attributes

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

คำถามที่พบบ่อย

SDK ของ iOS หรือ Android รองรับครีเอทีฟโฆษณา JavaScript ของ VPAID 2 ไหม
IMA HTML5 SDK เป็นแพลตฟอร์ม IMA SDK เพียงแพลตฟอร์มเดียวที่รองรับครีเอทีฟโฆษณา JavaScript ของ VPAID 2
การตั้งค่านี้จะเปิดใช้ครีเอทีฟโฆษณา VPAID ใน IMA HTML5 SDK ไหม
ได้ IMA HTML5 SDK รองรับครีเอทีฟโฆษณา JavaScript VPAID 2