ตรวจสอบการรองรับ SIMID

Google Interactive Media Ads (IMA) SDK สำหรับ HTML5 รองรับ Secure Interactive Media Interface Definition (SIMID) เวอร์ชัน 1.1 คู่มือนี้ครอบคลุมฟีเจอร์และข้อความ SIMID ที่เฉพาะเจาะจงซึ่ง IMA SDK รองรับ

ทำความเข้าใจข้อความจากครีเอทีฟโฆษณาถึงโปรแกรมเล่นวิดีโอ

ตารางต่อไปนี้แสดงข้อความที่ครีเอทีฟโฆษณา SIMID ส่งไปยัง IMA SDK ได้

ข้อความ คำอธิบาย
clickThru จัดการการคลิกโฆษณาตาม URI ที่ครีเอทีฟโฆษณาให้ไว้
fatalError ยุติเซสชันโฆษณาและรายงานข้อผิดพลาดร้ายแรงจากครีเอทีฟโฆษณา
getMediaState แสดงสถานะปัจจุบันของมีเดียเพลเยอร์ รวมถึง URI, currentTime, duration, volume และสถานะปิดเสียง
log ส่งต่อข้อความบันทึกของครีเอทีฟโฆษณาไปยัง IMA SDK เพื่อการแก้ไขข้อบกพร่อง
reportTracking ขอให้ IMA SDK ส่งคำขอ Ping ไปยัง URL การติดตามในนามของครีเอทีฟโฆษณา
requestChangeAdDuration ขอแก้ไขระยะเวลาทั้งหมดของเซสชันโฆษณา
requestNavigation ขอให้ไปยัง URI ภายนอก
requestPause ขอให้ IMA SDK หยุดเครื่องเล่นสื่อชั่วคราว
requestPlay ขอให้ IMA SDK เล่นต่อหรือเล่นเครื่องเล่นสื่อ
requestResize ขอปรับขนาดเครื่องเล่นวิดีโอ หากเครื่องเล่นอนุญาตให้ปรับขนาดได้ IMA SDK จะปรับขนาดเครื่องเล่น
requestSkip ขอให้ SDK ข้ามโฆษณาปัจจุบัน
requestStop ขอให้ SDK หยุดเซสชันโฆษณา
handleSkipShown แจ้งให้ IMA SDK ทราบว่าครีเอทีฟโฆษณาได้แสดง UI การข้ามโฆษณาแล้ว
requestFocus ขอโฟกัสสำหรับ iframe ของครีเอทีฟโฆษณา

ตรวจสอบข้อความจากครีเอทีฟโฆษณาถึงโปรแกรมเล่นวิดีโอที่ไม่รองรับ

IMA SDK ไม่จัดการ CreativeMessage ประเภทต่อไปนี้

  • requestChangeVolume
  • requestFullscreen
  • requestExitFullscreen

ทำความเข้าใจข้อความจากโปรแกรมเล่นวิดีโอถึงครีเอทีฟโฆษณา

ตารางต่อไปนี้แสดงข้อความที่ IMA SDK รองรับการส่งไปยังครีเอทีฟโฆษณา SIMID

ข้อความ คำอธิบาย
init ส่งระหว่างการตั้งค่าเซสชันพร้อมข้อมูลสภาพแวดล้อมและพารามิเตอร์โฆษณา
startCreative แจ้งให้ครีเอทีฟโฆษณาเริ่มต้นและแสดง iframe ของครีเอทีฟโฆษณา
adStopped แจ้งว่าเซสชันโฆษณาสิ้นสุดลงแล้ว รวมถึงรหัสเหตุผล
adSkipped แจ้งให้ครีเอทีฟโฆษณาทราบว่าผู้ใช้หรือ IMA SDK ข้ามโฆษณา
resize แจ้งให้ครีเอทีฟโฆษณาทราบถึงการเปลี่ยนแปลงขนาดของโปรแกรมเล่นวิดีโอหรือวิดีโอ
appBackgrounded แจ้งให้ครีเอทีฟโฆษณาทราบว่าแอปพลิเคชันเข้าสู่เบื้องหลังแล้ว
appForegrounded แจ้งให้ครีเอทีฟโฆษณาทราบว่าแอปพลิเคชันกลับมาอยู่เบื้องหน้าแล้ว
fatalError แจ้งให้ครีเอทีฟโฆษณาทราบถึงข้อผิดพลาดฝั่งโปรแกรมเล่นวิดีโอ
log ส่งข้อความบันทึกจากโปรแกรมเล่นวิดีโอไปยังครีเอทีฟโฆษณา
focusIn แจ้งว่าครีเอทีฟโฆษณาได้รับโฟกัสแล้ว

ตรวจสอบการอัปเดตสถานะสื่อ

IMA SDK จะส่งข้อความ mediaStateUpdate ไปยังครีเอทีฟโฆษณาสำหรับเหตุการณ์ต่อไปนี้

  • play
  • pause
  • stalled (บัฟเฟอร์)
  • seeking
  • seeked
  • ended
  • durationchange
  • timeupdate เป็นระยะๆ
  • volumechange รวมถึงสถานะปิดเสียง