SDK โฆษณาสื่ออินเทอร์แอกทีฟ (IMA) ของ Google สำหรับ 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 ตรวจสอบ URL ติดตามในนามของครีเอทีฟโฆษณา |
requestChangeAdDuration |
คำขอแก้ไขระยะเวลารวมของเซสชันโฆษณา |
requestNavigation |
ขอการนำทางไปยัง URI ภายนอก |
requestPause |
ขอให้ IMA SDK หยุด Media Player ชั่วคราว |
requestPlay |
คำขอที่ IMA SDK เล่นต่อหรือเล่นโปรแกรมเล่นสื่อ |
requestResize |
คำขอปรับขนาดวิดีโอเพลเยอร์ หากโปรแกรมเล่นอนุญาตให้ปรับขนาด IMA SDK จะปรับขนาดโปรแกรมเล่น |
requestSkip |
คำขอที่ SDK ข้ามโฆษณาปัจจุบัน |
requestStop |
คำขอให้ SDK หยุดเซสชันโฆษณา |
handleSkipShown |
แจ้ง IMA SDK ว่าครีเอทีฟโฆษณาได้แสดง UI การข้ามโฆษณาแล้ว |
requestFocus |
คำขอจะโฟกัส iframe ของครีเอทีฟโฆษณา |
ตรวจสอบข้อความครีเอทีฟโฆษณาที่ไม่รองรับไปยังเพลเยอร์
IMA SDK ไม่รองรับCreativeMessage ประเภทต่อไปนี้
requestChangeVolumerequestFullscreenrequestExitFullscreen
ทำความเข้าใจข้อความจากผู้เล่นถึงครีเอทีฟโฆษณา
ตารางต่อไปนี้แสดงข้อความที่ IMA SDK รองรับการส่งไปยังครีเอทีฟโฆษณา SIMID
| ข้อความ | คำอธิบาย |
|---|---|
init |
ส่งในระหว่างการตั้งค่าเซสชันพร้อมข้อมูลสภาพแวดล้อมและพารามิเตอร์โฆษณา |
startCreative |
แจ้งให้ครีเอทีฟโฆษณาทราบเพื่อเริ่มและแสดง iframe ของครีเอทีฟโฆษณา |
adStopped |
แจ้งว่าเซสชันโฆษณาสิ้นสุดแล้ว รวมถึงรหัสเหตุผล |
adSkipped |
แจ้งให้ครีเอทีฟโฆษณาทราบว่าผู้ใช้หรือ IMA SDK ข้ามโฆษณา |
resize |
แจ้งให้ครีเอทีฟโฆษณาทราบถึงการเปลี่ยนแปลงขนาดเพลเยอร์หรือวิดีโอ |
appBackgrounded |
แจ้งให้ครีเอทีฟโฆษณาทราบว่าแอปพลิเคชันเข้าสู่เบื้องหลังแล้ว |
appForegrounded |
แจ้งให้ครีเอทีฟโฆษณาทราบว่าแอปพลิเคชันกลับมาทำงานที่เบื้องหน้าแล้ว |
fatalError |
แจ้งให้ครีเอทีฟโฆษณาทราบถึงข้อผิดพลาดฝั่งเพลเยอร์ |
log |
ส่งข้อความบันทึกจากเพลเยอร์ไปยังครีเอทีฟโฆษณา |
focusIn |
แจ้งว่าครีเอทีฟโฆษณาได้รับโฟกัส |
ตรวจสอบการอัปเดตสถานะสื่อ
IMA SDK จะส่งข้อความ mediaStateUpdate ไปยังครีเอทีฟโฆษณาสำหรับเหตุการณ์ต่อไปนี้
playpausestalled(กำลังบัฟเฟอร์)seekingseekedendeddurationchangetimeupdateเป็นระยะๆvolumechangeรวมถึงสถานะการปิดเสียง